Mem0 Config

openclaw-mem0

Long-term memory plugin for OpenClaw agents, powered by Mem0. Extracts and injects memories automatically around each agent turn.

Installation

1. Install the plugin

openclaw plugins install @mem0/openclaw-mem0

This installs the plugin into ~/.openclaw/extensions/openclaw-mem0/ and adds it to openclaw.json.

2. Choose a mode and install dependencies

Platform mode — no local dependencies. Get an API key from app.mem0.ai and skip to Configuration.

Open-source mode — requires two local services:

# Ollama (embedder + LLM)
brew install ollama
ollama serve                        # or: brew services start ollama
ollama pull bge-m3:latest           # embedder (1024-dim)
ollama pull llama3.2                # LLM for memory extraction
Qdrant (vector store)
docker run -d -p 6333:6333 qdrant/qdrant
or: brew install qdrant && qdrant

Verify both are running:

curl -s http://localhost:11434/          # → "Ollama is running"
curl -s http://localhost:6333/health     # → {"status":"ok"}

3. Add to openclaw.json

Add under plugins.entries (see Configuration below).

4. Restart the gateway

openclaw gateway stop && openclaw gateway

Confirm the plugin loaded:

grep "openclaw-mem0: initialized" ~/.openclaw/logs/gateway.log | tail -1

Expected output: openclaw-mem0: initialized (mode: open-source, user: ..., autoRecall: true, autoCapture: true)

Modes

| Mode | Config | Requires | |---|---|---| | platform | apiKey from app.mem0.ai | Internet, Mem0 API key | | open-source | oss block (self-hosted) | Ollama + Qdrant (or other providers) |

Configuration

Minimal Config

Platform:

"openclaw-mem0": {
  "enabled": true,
  "config": { "mode": "platform", "apiKey": "${MEM0_API_KEY}", "userId": "your-id" }
}

Open-source:

"openclaw-mem0": {
  "enabled": true,
  "config": {
    "mode": "open-source",
    "userId": "your-id",
    "oss": {
      "embedder":    { "provider": "ollama", "config": { "model": "bge-m3:latest", "baseURL": "http://localhost:11434" } },
      "vectorStore": { "provider": "qdrant", "config": { "host": "localhost", "port": 6333, "collection": "memories", "dimension": 1024 } },
      "llm":         { "provider": "ollama", "config": { "model": "llama3.2", "baseURL": "http://localhost:11434" } },
      "historyDbPath": "/absolute/path/to/.openclaw/memory/history.db"
    }
  }
}

> Always set historyDbPath to an absolute path. When openclaw runs as a LaunchAgent, process.cwd() is /, so the default relative "memory.db" resolves to /memory.db (unwritable on macOS), causing a SQLITE_CANTOPEN crash loop. See troubleshooting.md.

Key Config Options

| Key | Default | Notes | |---|---|---| | autoRecall | true | Inject memories before each agent turn | | autoCapture | true | Store memories after each agent turn | | topK | 5 | Max memories injected per turn | | searchThreshold | 0.5 | Min similarity score (0–1) | | userId | "default" | Scope memories per user |

CLI

openclaw mem0 stats                          # Total memories, mode, user
openclaw mem0 search "user's name"           # Semantic search
openclaw mem0 search "topic" --scope long-term   # long-term | session | all

Agent Tools

The plugin registers 5 tools for agents to call:

| Tool | Description | |---|---| | memory_search | Semantic search (scope: session/long-term/all) | | memory_list | List all memories for a user | | memory_store | Explicitly save a fact (longTerm: true by default) | | memory_get | Fetch memory by ID | | memory_forget | Delete by ID or query |

Verifying It Works

# Check gateway log for injection events
grep "openclaw-mem0: inject" ~/.openclaw/logs/gateway.log | tail -5
Confirm history DB created at configured path
ls -la /path/to/history.db
No SQLITE errors since last gateway start
grep "SQLITE_CANTOPEN" ~/.openclaw/logs/gateway.err.log | tail -3

Troubleshooting

See references/troubleshooting.md for:

Minimal Config

Platform:

"openclaw-mem0": {
  "enabled": true,
  "config": { "mode": "platform", "apiKey": "${MEM0_API_KEY}", "userId": "your-id" }
}

Open-source:

"openclaw-mem0": {
  "enabled": true,
  "config": {
    "mode": "open-source",
    "userId": "your-id",
    "oss": {
      "embedder":    { "provider": "ollama", "config": { "model": "bge-m3:latest", "baseURL": "http://localhost:11434" } },
      "vectorStore": { "provider": "qdrant", "config": { "host": "localhost", "port": 6333, "collection": "memories", "dimension": 1024 } },
      "llm":         { "provider": "ollama", "config": { "model": "llama3.2", "baseURL": "http://localhost:11434" } },
      "historyDbPath": "/absolute/path/to/.openclaw/memory/history.db"
    }
  }
}

> Always set historyDbPath to an absolute path. When openclaw runs as a LaunchAgent, process.cwd() is /, so the default relative "memory.db" resolves to /memory.db (unwritable on macOS), causing a SQLITE_CANTOPEN crash loop. See troubleshooting.md.

See references/troubleshooting.md for: