kartik-mem0OpenClaw + Mem0 One-Click Docker Setup
Get a working OpenClaw agent with Mem0 persistent memory in under 2 minutes.
Prerequisites
- Docker Desktop or Docker Engine with Compose v2
- One of:
- Platform mode: A Mem0 API key from app.mem0.ai
- OSS mode: An OpenAI API key
Quick Start
git clone https://github.com/mem0ai/mem0 && cd mem0/openclaw/docker
./setup.sh
The setup script will:
- Ask you to choose Platform or Open-Source mode
- Prompt for your API key(s)
- Start the containers automatically
Then open http://localhost:18789 to start chatting.
What Gets Deployed
Platform Mode
┌─────────────────────────┐
│ OpenClaw (port 18789) │
│ + Mem0 Plugin │──→ Mem0 Cloud (app.mem0.ai)
└─────────────────────────┘
OSS Mode
┌─────────────────────────┐ ┌─────────────────┐
│ OpenClaw (port 18789) │ │ Qdrant │
│ + Mem0 Plugin │────→│ (port 6333) │
└─────────────────────────┘ │ Vector Storage │
└─────────────────┘
Modes Explained
| Feature | Platform (Mem0 Cloud) | Open-Source (Self-Hosted) |
|---|---|---|
| Setup | API key only | API key + Qdrant container |
| Vector storage | Managed by Mem0 | Local Qdrant |
| LLM for extraction | Managed by Mem0 | Your OpenAI key |
| Graph memory | Supported | Not yet |
| Dashboard | app.mem0.ai | CLI commands |
Configuration
After setup, your config lives at ~/.openclaw/openclaw.json. You can edit it directly.
Key settings in the openclaw-mem0 plugin section:
| Setting | Default | Description |
|---|---|---|
autoCapture |
true |
Auto-store conversation facts |
autoRecall |
true |
Auto-retrieve relevant memories |
searchThreshold |
0.5 |
Minimum similarity score (0-1) |
topK |
5 |
Max memories to retrieve |
To change the port or other Docker settings, edit .env in this directory.
Troubleshooting
Port 18789 already in use
lsof -i :18789
# Kill the process or change OPENCLAW_PORT in .env
API key errors
- Platform: Verify your key at app.mem0.ai
- OSS: Ensure
OPENAI_API_KEYis valid and has credits
Containers won't start
docker compose logs
# or for OSS mode:
docker compose -f docker-compose.yml -f docker-compose.oss.yml logs
Docker not found Install Docker Desktop or follow the engine install guide.
Plugin not loading
# Reinstall the plugin manually
docker compose run --rm openclaw openclaw plugins install @mem0/openclaw-mem0