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)
- Confirm OpenClaw is already usable
Run in the terminalopenclaw --version, and you have already configured in OpenClawthe model used for everyday conversation(as long as it can reply normally).
-
First check the Python version (must be ≥ 3.10)
Before creating a virtual environment or runningpip installbeforeyou must first confirm the version, otherwise subsequent installation is likely to fail or run abnormally:python3 --versionThe 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.12or another interpreter that meets the requirements, and replacepython3in the steps below with the actual command (for examplepython3.12 -m venv ...)。 -
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 powermemAfter installation, run
pmem --version, and it is fine if it outputs the version. -
Let the gateway find
pmem
If the terminal where you startopenclaw gatewaythe 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
pmemPathas thepmemin the venvfull path(after installation you can usewhich pmemto view it).
- Before starting the gateway each time, first
-
One-click plugin installation (recommended)
On Mac / Linux run (OpenClaw must already be installed). The scriptwill notexecutepip install powermemon your behalf; before installing the plugin you still need to complete the above PowerMem andpmemsteps.curl -fsSL https://raw.githubusercontent.com/ob-labs/memory-powermem/main/install.sh | bash -s -yIf you have already cloned this repository, you can also run this in the repository root directory:
bash install.sh(you can add-y, orbash -s -- --workdir ~/.openclaw-secondto 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-yit may still generate an optional template~/.openclaw/powermem/powermem.env(under the default path, manual changes are usually unnecessary). -
Restart the gateway and check
openclaw gatewayOpen another terminal,firstconfirm that the plugin has been loaded by the gateway:
openclaw plugins listThe 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 healthAfter 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.