OpenClaw Persistent Memory
Persistent memory system that automatically captures context across sessions using SQLite + FTS5.
Features
- 🧠 Auto-capture - Important observations saved automatically after each response
- 🔍 Auto-recall - Relevant memories injected before each prompt
- 💾 SQLite + FTS5 - Fast full-text search across all memories
- 🛠️ Tools -
memory_search,memory_get,memory_store,memory_delete - 📊 Progressive disclosure - Token-efficient retrieval
Setup
- Install the npm package:
npm install -g openclaw-persistent-memory - Start the worker service:
openclaw-persistent-memory start - Install the OpenClaw extension:
# Copy extension to OpenClaw extensions directory cp -r node_modules/openclaw-persistent-memory/extension ~/.openclaw/extensions/openclaw-mem cd ~/.openclaw/extensions/openclaw-mem && npm install - Configure OpenClaw (in
~/.openclaw/openclaw.json):{"plugins": {"slots": {"memory": "openclaw-mem"}, "allow": ["openclaw-mem"], "entries": {"openclaw-mem": {"enabled": true, "config": {"workerUrl": "http://127.0.0.1:37778", "autoCapture": true, "autoRecall": true}}}}} - Restart OpenClaw gateway
Tools Provided
| Tool | Description |
|---|---|
memory_search | Search memories with natural language |
memory_get | Get a specific memory by ID |
memory_store | Save important information |
memory_delete | Delete a memory by ID |
API Endpoints
Worker runs on http://127.0.0.1:37778:
| Endpoint | Method | Description |
|---|---|---|
/api/health | GET | Health check |
/api/stats | GET | Database statistics |
/api/search | POST | Full-text search |
/api/observations | GET | List recent observations |
/api/observations/:id | GET | Get observation |
/api/observations/:id | DELETE | Delete observation |
/api/observations/:id | PATCH | Update observation |
Troubleshooting
Worker not running
curl http://127.0.0.1:37778/api/health
# If fails, restart:
openclaw-persistent-memory startAuto-recall not working
- Check OpenClaw logs:
tail ~/.openclaw/logs/*.log | grep openclaw-mem - Verify
plugins.slots.memoryis set to"openclaw-mem" - Restart gateway after config changes