#10 OpenClaw Memory 记忆系统

每次会话重启，AI 助手都会"失忆"。OpenClaw 的 Memory 记忆系统 解决了这个问题——通过文件持久化，让 Agent 跨会话保留记忆。

Memory 的工作原理

OpenClaw 的记忆系统基于纯文本文件，不依赖任何数据库。核心文件包括：

• MEMORY.md：长期记忆，存储重要的决策、偏好、经验教训
• memory/YYYY-MM-DD.md：每日笔记，记录当天发生的事情
• SOUL.md：Agent 的"灵魂"，定义性格和行为准则
• USER.md：关于用户的信息（姓名、偏好、时区等）

每次会话启动时，Agent 会自动读取这些文件来"恢复记忆"。

MEMORY.md - 长期记忆

MEMORY.md 是 Agent 的长期记忆库。适合存放：

• 重要的项目配置和凭证引用（不放实际密码）
• 决策记录和原因
• 经验教训（踩过的坑）
• 用户偏好和习惯
• 常用的工作流程

注意：MEMORY.md 只在主会话中加载，共享环境（群聊）中不加载，这是为了安全考虑——避免私人信息泄露给陌生人。

每日笔记

每天的笔记存储在 memory/ 目录下，按日期命名。适合记录：

• 当天发生的事情
• 发布的文章
• 配置变更
• 版本更新处理
• 对话要点

笔记是原始记录，MEMORY.md 是经过提炼的精华。定期回顾每日笔记，把有价值的内容提炼到 MEMORY.md 中。

记忆搜索

OpenClaw 内置了语义搜索功能（memory_search），Agent 可以在回答问题前自动搜索相关记忆，确保回答基于准确的上下文信息。

搜索范围包括 MEMORY.md 和 memory/ 目录下的所有文件，返回最相关的代码片段和来源路径。

记忆维护

在 Heartbeat（心跳）期间，Agent 会自动执行记忆维护：

1. 读取最近的每日笔记文件
2. 识别值得长期保留的内容
3. 用提炼的学习内容更新 MEMORY.md
4. 删除 MEMORY.md 中不再相关的信息

这就像人类回顾日记并更新心理模型的过程。

隐私与安全

• MEMORY.md 只在主会话加载，群聊中不加载
• 敏感信息（密码、API Key）不直接写入 MEMORY.md
• 笔记文件可以标记为保密，Agent 不会在公开场合提及
• 建议定期审查记忆文件，删除过时或敏感信息

最佳实践

• 写下来，不要"记在脑子里"——会话重启后脑中的记忆会丢失，文件不会
• 定期清理——每周回顾 MEMORY.md，删除不再相关的内容
• 结构化存储——用标题和分类组织记忆，方便搜索
• 保护隐私——不要在公开环境中加载 MEMORY.md

总结

OpenClaw 的 Memory 系统用最简单的方式解决了 AI 助手的"失忆"问题。记住：文字 > 大脑，写下来才能持久 🧠