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

1. Install the npm package:

```bash

npm install -g openclaw-persistent-memory

```

1. Start the worker service:

```bash

openclaw-persistent-memory start

```

1. Install the OpenClaw extension:

```bash

# 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

```

1. Configure OpenClaw (in ~/.openclaw/openclaw.json):

```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

}

}

}

}

}

```

1. Restart OpenClaw gateway

Tools Provided

API Endpoints

Worker runs on http://127.0.0.1:37778:

Troubleshooting

Worker not running

curl http://127.0.0.1:37778/api/health
# If fails, restart:
openclaw-persistent-memory start

Auto-recall not working

• Check OpenClaw logs: tail ~/.openclaw/logs/*.log | grep openclaw-mem
• Verify plugins.slots.memory is set to "openclaw-mem"
• Restart gateway after config changes