feat: add one-click Docker setup for OpenClaw + Mem0

2026-04-01 10:55:50 +05:30
parent 215d8b5a71
commit e0fb194c76
9 changed files with 792 additions and 0 deletions
@@ -0,0 +1,102 @@
+# OpenClaw + Mem0 One-Click Docker Setup
+
+Get a working OpenClaw agent with Mem0 persistent memory in under 2 minutes.
+
+## Prerequisites
+
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/) or Docker Engine with Compose v2
+- One of:
+  - **Platform mode**: A Mem0 API key from [app.mem0.ai](https://app.mem0.ai)
+  - **OSS mode**: An OpenAI API key
+
+## Quick Start
+
+```bash
+git clone https://github.com/mem0ai/mem0 && cd mem0/openclaw/docker
+./setup.sh
+```
+
+The setup script will:
+1. Ask you to choose Platform or Open-Source mode
+2. Prompt for your API key(s)
+3. 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**
+```bash
+lsof -i :18789
+# Kill the process or change OPENCLAW_PORT in .env
+```
+
+**API key errors**
+- Platform: Verify your key at [app.mem0.ai](https://app.mem0.ai)
+- OSS: Ensure `OPENAI_API_KEY` is valid and has credits
+
+**Containers won't start**
+```bash
+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](https://www.docker.com/products/docker-desktop/) or follow the [engine install guide](https://docs.docker.com/engine/install/).
+
+**Plugin not loading**
+```bash
+# Reinstall the plugin manually
+docker compose run --rm openclaw openclaw plugins install @mem0/openclaw-mem0
+```
+
+## Links
+
+- [Mem0 Documentation](https://docs.mem0.ai)
+- [Mem0 OpenClaw Plugin](https://github.com/mem0ai/mem0/tree/main/openclaw)
+- [OpenClaw Documentation](https://openclaw.com/docs)