想让你的 AI 智能体不再“聊完就忘”?
之前分享过的一个开源项目:Claude-Mem:通过持久内存压缩系统,让 Claude 真正记住并复用长期上下文
今天我就通过将 Claude-Mem 与 OpenClaw 深度结合,让你的智能体可以自动记录每次工具操作、在工作空间中持续同步 MEMORY.md,并把新观察实时推送到消息平台,真正拥有一个可成长的“外部大脑”。
为什么需要这套集成?
很多 AI 智能体在重启会话后就忘记历史上下文,无法记住已学到的方法、使用过的工具以及你的偏好。
这背后的共性问题是:缺少可靠的持久记忆机制。Claude-Mem + OpenClaw 的集成,正是为此而来。
什么是 Claude-Mem + OpenClaw?
Claude-Mem:为智能体提供持久记忆的系统;
OpenClaw:智能体网关。二者联手,带来三项核心能力:
- 自动捕获与记录观察:智能体使用工具时的每一步与返回结果都会被采集与处理。
- MEMORY.md 实时同步:持续把时间线写入智能体工作空间,重要上下文不再丢失。
- 观察消息流实时推送:通过 SSE(Server-Sent Events)将新观察即刻同步到 Telegram、Discord、Slack 等平台。
工作原理:用事件把全链路串起来

整个流程围绕四个关键事件运转:
- 事件 1:gateway_start(网关启动) — 重置会话跟踪,为新会话做准备。
- 事件 2:before_agent_start(智能体启动前) — 同步 MEMORY.md,让智能体拿到历史上下文;初始化新的内容会话。
- 事件 3:tool_result_persist(工具结果持久化) — 捕获工具调用及返回;把观察发送到 Claude-Mem Worker 做 AI 处理;再次同步 MEMORY.md,保证上下文即时更新。
- 事件 4:agent_end(会话结束) — 对整场对话进行总结,并完成归档。
MEMORY.md:智能体的外部记忆体
MEMORY.md 文件被写入到每个智能体的工作空间目录,承载:
- 完整时间线:包含既往会话的观察与总结。
- 实时更新:在
before_agent_start和tool_result_persist事件触发时自动写入。 - Markdown 格式:人类易读,AI 也易理解。
这意味着智能体每次启动都能“看见”自己过往的经历,像一个拥有连续记忆的人类。
MEMORY.md 的更新时机
- 智能体启动前(before_agent_start):载入历史上下文。
- 工具使用后(tool_result_persist):把最新观察写回,保持上下文持续新鲜。
观察消息流:实时看见智能体的学习
除了 MEMORY.md 的同步之外,插件还会在后台连接 Worker 的 SSE 流(GET /stream),把 new_observation 事件转发到你配置的消息平台。你可以:
- 在 Telegram 群组里实时查看智能体学到了什么;
- 在 Discord 频道中监控它的工作进展;
- 在 Slack 接收它的观察摘要。
消息格式示例
🧠 Claude-Mem Observation
**Implemented retry logic for API client**
Added exponential backoff with configurable max retries to handle transient failures
三步开启观察消息流
步骤 1:选择你的平台
支持 Telegram、Discord、Slack、Signal、WhatsApp、Line 等。你需要准备:
- Channel type:平台插件名称(如
telegram、discord)。 - Target ID:聊天 ID、频道 ID 或用户 ID。
步骤 2:配置网关
在 OpenClaw 网关中加入 observationFeed 配置块:
{
"plugins": {
"claude-mem": {
"enabled": true,
"config": {
"project": "my-project",
"observationFeed": {
"enabled": true,
"channel": "telegram",
"to": "123456789"
}
}
}
}
}
步骤 3:验证连接
启动网关后,检查日志:
[claude-mem] Observation feed starting — channel: telegram, target: 123456789
[claude-mem] Connecting to SSE stream at http://localhost:37777/stream
[claude-mem] Connected to SSE stream
也可在 OpenClaw 聊天中运行 /claude_mem_feed 查看当前状态。
故障排查速查表
- Connection: disconnected — 可能原因:Worker 未运行或端口配置错误;解决:检查
workerPort并执行npm run worker:status。 - Connection: reconnecting — 可能原因:Worker 曾运行但连接断开;解决:插件会自动重连(最长约 30 秒)。
- Unknown channel type — 可能原因:网关未加载该频道插件;解决:确认 OpenClaw 已启用对应频道插件。
- 没有消息出现 — 可能原因:Feed 已连接但没有观察产生;解决:检查智能体是否在运行、Worker 是否正确处理观察。
- Observation feed disabled — 可能原因:
enabled为false或缺失;解决:将observationFeed.enabled设为true。 - Observation feed misconfigured — 可能原因:缺少
channel或to;解决:补齐这两个必需参数。
安装:一条命令就位
提供自动化脚本,完成依赖检查与配置:
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
高级选项
- 指定 AI 提供商:
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --provider=gemini --api-key=YOUR_KEY - 无人值守安装(默认使用 Claude Max Plan):
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --non-interactive - 升级现有安装:
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --upgrade

安装脚本自动处理内容
- 依赖检查(Bun、uv);
- 插件安装;
- 记忆槽位配置;
- AI 提供商设置;
- Worker 启动;
- 可选的观察消息流配置。
配置参数详解
- project(string,默认
"openclaw"):项目名称,用于在记忆数据库中限定观察范围。 - syncMemoryFile(boolean,默认
true):是否自动把 MEMORY.md 同步到智能体工作空间。 - workerPort(number,默认
37777):Claude-Mem Worker 服务端口。 - observationFeed.enabled(boolean,默认
false):是否启用观察消息流。 - observationFeed.channel(string,默认
-):消息平台类型,例如telegram、discord、slack。 - observationFeed.to(string,默认
-):目标聊天/用户/频道 ID。
常用命令
/claude_mem_feed— 显示当前观察消息流状态。/claude_mem_feed on— 请求启用观察消息流。/claude_mem_feed off— 请求禁用观察消息流。/claude_mem_status— 查看 Worker 健康、端口、活跃会话数及观察消息流连接状态。
技术架构亮点
Claude-Mem 插件通过 HTTP 调用与已运行的 Worker 服务通信,而非生成子进程,优势包括:
- 无需在网关上安装
bun依赖; - 没有额外的进程生成开销;
- 复用与 Claude Code hooks 相同的 Worker API;
- 所有操作均为非阻塞(“即发即忘”)。
会话跟踪机制
每个 OpenClaw 智能体会话会分配唯一的 contentSessionId(格式:openclaw--),映射到 Worker 中的 Claude-Mem 会话。插件维护两类映射:
- sessionIds:把 OpenClaw 会话键映射到内容会话 ID。
- workspaceDirsBySessionKey:把会话键映射到工作空间目录。
上述映射会在 gateway_start 事件时清空重置。
应用场景
- 代码开发智能体:记录每次代码修改与 bug 修复策略,减少重复犯错。
- 数据分析助手:记住分析洞察与你偏好的图表类型,越用越懂你。
- 客服自动化:掌握客户历史问题与解决方案,服务更个性化。
- 学习陪伴:跟踪学习进度与薄弱点,动态优化学习计划。
结语
智能体的强大不只在于“智力”,更在于“记忆”。通过 Claude-Mem 与 OpenClaw 的集成,它可以:
- 📝 记住每一次操作与观察;
- 🔄 在会话之间保持连续性;
- 📡 实时推送学习进展;
- 🧠 像人类一样不断积累经验。
现在就启用 Claude-Mem + OpenClaw,让你的智能体真正“成长”。
你希望它记住哪些信息?欢迎在评论区分享你的场景与想法!