SuperAPI AI Directory

install-memory-powermem

Agents & models

View repository

Updated 10-16 02:35

About this skill

PowerMem Memory · Quick Install (Individual Users)

This skill's identifier in OpenClaw and the suggested directory name is install-memory-powermem. If you need HTTP/multiple instances, the tool table, and detailed troubleshooting, please use install-memory-powermem-full(in the repository skills/install-memory-powermem-full/, you need to copy all of the .md)。

You only need to remember a few things:OpenClaw can chat normally、First confirm Python is ≥ 3.10、PowerMem is installed on this machine、Install the plugin. No need to hand-write powermem.env, the model and Key used for memory will be the same as what you configured in OpenClaw.


What you need to do (in order)

  1. Confirm OpenClaw is already usable
    Run in the terminal openclaw --version, and you have already configured in OpenClawthe model used for everyday conversation(as long as it can reply normally).
  1. First check the Python version (must be ≥ 3.10)
    Before creating a virtual environment or running pip install beforeyou must first confirm the version, otherwise subsequent installation is likely to fail or run abnormally:

    python3 --version
    

    The output should be Python 3.10.x、3.11.x、3.12.x , etc. (minor version number ≥ 10). You can also use the following command to do a hard check (it will error out and exit if it does not pass):

    python3 -c "import sys; assert sys.version_info >= (3, 10), '需要 Python 3.10 或更高'; print(sys.version.split()[0], 'OK')"
    

    If the version is insufficient: first upgrade the local Python, or install and use python3.11 / python3.12 or another interpreter that meets the requirements, and replace python3 in the steps below with the actual command (for example python3.12 -m venv ...)。

  2. Install PowerMem (Python)
    It is recommended to use a virtual environment, then install:

    python3 -m venv ~/.openclaw/powermem/.venv
    source ~/.openclaw/powermem/.venv/bin/activate
    pip install powermem
    

    After installation, run pmem --version, and it is fine if it outputs the version.

  3. Let the gateway find pmem
    If the terminal where you start openclaw gateway the terminaldoes not havethe above venv activated, there are two simple ways, choose one:

    • Before starting the gateway each time, first source ~/.openclaw/powermem/.venv/bin/activate; or
    • In the plugin configuration, write pmemPath as the pmem in the venvfull path(after installation you can use which pmem to view it).
  4. One-click plugin installation (recommended)
    On Mac / Linux run (OpenClaw must already be installed). The scriptwill notexecute pip install powermemon your behalf; before installing the plugin you still need to complete the above PowerMem and pmem steps.

    curl -fsSL https://raw.githubusercontent.com/ob-labs/memory-powermem/main/install.sh | bash -s -y
    

    If you have already cloned this repository, you can also run this in the repository root directory:bash install.sh(you can add -y, or bash -s -- --workdir ~/.openclaw-second to specify another OpenClaw data directory).
    The script will put the plugin into OpenClaw and turn on default options such as "use OpenClaw's model to drive memory"; with -y it may still generate an optional template ~/.openclaw/powermem/powermem.env(under the default path, manual changes are usually unnecessary).

  5. Restart the gateway and check

    openclaw gateway
    

    Open another terminal,firstconfirm that the plugin has been loaded by the gateway:

    openclaw plugins list
    

    The output must contain memory-powermem, and its status is loaded(loaded). If there is only an installation record and the status is not loaded, first handle it according to "If a step fails" below,do notskip this step and go straight to testing ltm。
    After it passes, check memory health and try a write-read:

    openclaw ltm health
    

    After it shows healthy, try a sentence:

    openclaw ltm add "我喜欢喝美式"
    openclaw ltm search "咖啡"
    

If a step fails

Situation What to do
python3 --version lower than 3.10 First upgrade or switch to python3.11 / python3.12 etc., then redo the "Check Python" and venv steps; do not skip the version check and force pip install。
pip install powermem error Confirm again that Python ≥ 3.10; switch to a clean venv and try again.
pmem not found Activate the venv, or configure pmemPath as an absolute path.
plugins list does not have memory-powermem, or the status is not loaded Confirm that the installation script has been run or openclaw plugins install;plugins.enabled is true,plugins.slots.memory is memory-powermem; after changing it,restart gateway, then run openclaw plugins list to check again.
ltm health unhealthy Confirm that in OpenClaw thedefault modeland the API Key itself can chat; upgrade OpenClaw to a newer version and try again.
Want more options (multiple instances, HTTP,install.sh details, tools and troubleshooting table, etc.) Use the install-memory-powermem-full skill (including config-reference.md), or consult memory-powermem 's README。

Description (one sentence)

Memory data is stored by default in SQLite under the local OpenClaw data directory;no needfor you to separately maintain a PowerMem .env, unless you are familiar with advanced configuration.