openclaw-mem0

为OpenClaw智能体提供长期记忆的插件，基于Mem0构建。在每个智能体回合前后自动提取和注入记忆。

安装

1. 安装插件

bash
openclaw plugins install @mem0/openclaw-mem0

此命令会将插件安装到 ~/.openclaw/extensions/openclaw-mem0/ 目录，并将其添加到 openclaw.json 配置文件中。

2. 选择模式并安装依赖

平台模式 — 无需本地依赖。从 app.mem0.ai 获取API密钥，然后直接跳转到配置部分。

开源模式 — 需要两个本地服务：

bash

Ollama（嵌入器 + 大语言模型）

brew install ollama
ollama serve # 或：brew services start ollama
ollama pull bge-m3:latest # 嵌入器（1024维）
ollama pull llama3.2 # 用于记忆提取的大语言模型

Qdrant（向量存储）

docker run -d -p 6333:6333 qdrant/qdrant

或：brew install qdrant && qdrant

验证两个服务是否正常运行：
bash
curl -s http://localhost:11434/ # → Ollama is running
curl -s http://localhost:6333/health # → {status:ok}

3. 添加到 openclaw.json

在 plugins.entries 下添加（详见下面的配置部分）。

4. 重启网关

bash
openclaw gateway stop && openclaw gateway

确认插件已加载：
bash
grep openclaw-mem0: initialized ~/.openclaw/logs/gateway.log | tail -1

预期输出：openclaw-mem0: initialized (mode: open-source, user: ..., autoRecall: true, autoCapture: true)

---

模式

模式	配置	要求
platform	来自 app.mem0.ai 的 apiKey	互联网连接，Mem0 API密钥
open-source

oss 配置块（自托管） | Ollama + Qdrant（或其他提供商） |

配置

最小配置

平台模式：
json5
openclaw-mem0: {
enabled: true,
config: { mode: platform, apiKey: ${MEM0APIKEY}, userId: your-id }
}

开源模式：
json5
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
}
}
}

始终将 historyDbPath 设置为绝对路径。 当openclaw作为LaunchAgent运行时，process.cwd() 为 /，因此默认的相对路径 memory.db 会解析为 /memory.db（在macOS上不可写），导致SQLITECANTOPEN崩溃循环。详见 troubleshooting.md。

关键配置选项

键	默认值	说明
autoRecall	true	在每个智能体回合前注入记忆
autoCapture

true | 在每个智能体回合后存储记忆 | | topK | 5 | 每回合最大注入记忆数 | | searchThreshold | 0.5 | 最低相似度分数（0–1） | | userId | default | 按用户范围管理记忆 |

命令行界面

bash
openclaw mem0 stats # 总记忆数、模式、用户
openclaw mem0 search 用户名称 # 语义搜索
openclaw mem0 search 主题 --scope long-term # long-term | session | all

智能体工具

该插件注册了5个供智能体调用的工具：

工具	描述
memorysearch	语义搜索（范围：session/long-term/all）
memorylist

列出用户的所有记忆 |
| memory_store | 显式保存事实（默认 longTerm: true） |
| memory_get | 按ID获取记忆 |
| memory_forget | 按ID或查询删除 |

验证是否正常工作

bash

检查网关日志中的注入事件

grep openclaw-mem0: inject ~/.openclaw/logs/gateway.log | tail -5

确认历史数据库已在配置路径创建

ls -la /path/to/history.db

自上次网关启动以来无SQLITE错误

grep SQLITE_CANTOPEN ~/.openclaw/logs/gateway.err.log | tail -3

故障排除

详见 references/troubleshooting.md，了解以下问题的处理方法：

• - SQLITE_CANTOPEN崩溃循环（最常见问题）
• Qdrant / Ollama无法访问
• 记忆未存储或未召回
• Telegram allowFrom 配置警告