PowerMem Memory Guide
This skill folder includes supplementary docs to reference when needed:
- powermem-intro.md — Product intro to PowerMem (what it is, core features, relationship with OpenClaw). Use when the user asks "what is PowerMem" or needs an overview.
- config-reference.md — Configuration options and common commands quick reference.
How It Works
- Auto-Capture: At the end of a conversation, the plugin stores valuable user/assistant content into PowerMem, with optional intelligent extraction (infer).
- Auto-Recall: Before each turn, it searches for relevant memories and injects them into context.
When User Asks to Install
-
Check OpenClaw
Runopenclaw --version. If not installed, tell the user to install OpenClaw first:npm install -g openclawandopenclaw onboard. -
Check PowerMem
- HTTP mode: User must have PowerMem server running (e.g.
pip install powermem, create.env, thenpowermem-server --port 8000). - CLI mode: User needs
pmemon PATH (and optionally a PowerMem.env). No server required.
- HTTP mode: User must have PowerMem server running (e.g.
-
Install the plugin
If the user has the repo path:openclaw plugins install /path/to/openclaw-extension-powermemOr from GitHub one-liner:
curl -fsSL https://raw.githubusercontent.com/ob-labs/openclaw-extension-powermem/main/install.sh | bash -
Configure OpenClaw
Set memory slot and config. Example (HTTP, local server):openclaw config set plugins.enabled true openclaw config set plugins.slots.memory memory-powermem openclaw config set plugins.entries.memory-powermem.config.mode http openclaw config set plugins.entries.memory-powermem.config.baseUrl http://localhost:8000 openclaw config set plugins.entries.memory-powermem.config.autoCapture true --json openclaw config set plugins.entries.memory-powermem.config.autoRecall true --json openclaw config set plugins.entries.memory-powermem.config.inferOnAdd true --jsonFor CLI mode (no server): set
modetocli, and optionallyenvFile,pmemPath. -
Verify
Ask the user to restart the gateway, then run:openclaw ltm health openclaw ltm add "I prefer coffee in the morning" openclaw ltm search "coffee"If health is OK and search returns the memory, installation succeeded.
Available Tools
| Tool | Description |
|---|---|
| memory_recall | Search long-term memories by query. Params: query, optional limit, scoreThreshold. |
| memory_store | Save information (with optional infer). Params: text, optional importance. |
| memory_forget | Delete by memoryId or search with query then delete. |
Configuration
| Field | Default | Description |
|---|---|---|
mode | http | http (PowerMem server) or cli (local pmem, no server). |
baseUrl | — | Required when mode is http, e.g. http://localhost:8000. |
apiKey | — | Optional; for PowerMem server auth. |
envFile | — | CLI mode: path to PowerMem .env. |
pmemPath | pmem | CLI mode: path to pmem executable. |
recallLimit | 5 | Max memories in recall / auto-recall. |
recallScoreThreshold | 0 | Min score (0–1) to include. |
autoCapture | true | Auto-store from conversations. |
autoRecall | true | Auto-inject context before reply. |
inferOnAdd | true | Use PowerMem intelligent extraction when adding. |
Daily Operations
# Start gateway (after PowerMem server is running for HTTP mode)
openclaw gateway
# Check health
openclaw ltm health
# Manual add / search
openclaw ltm add "Some fact to remember"
openclaw ltm search "query"
# Disable memory slot
openclaw config set plugins.slots.memory none
# Re-enable
openclaw config set plugins.slots.memory memory-powermem
Restart the gateway after changing the memory slot.
Troubleshooting
| Symptom | Fix |
|---|---|
openclaw ltm health fails | For HTTP: ensure PowerMem server is running and baseUrl is correct. For CLI: ensure pmem is on PATH and optional .env is valid. |
| Plugin not loaded | Check plugins.slots.memory is memory-powermem and restart gateway. |
| Add/search returns 500 or empty | Check PowerMem server logs; usually LLM/Embedding API key or model in PowerMem .env. |