23.2 记忆架构
面向经管学生、研究者与从业者的 AI 智能体设计教材
OpenClaw 的记忆没有黑盒。管家记住的每一件事，都以 Markdown 文件的形式存在工作区磁盘上。你随时可以打开、编辑、删除它们。
记忆存在哪
管家的记忆分布在工作区的两个位置：一个文件和一个目录。
~/.openclaw/workspace/
├── MEMORY.md # 长期记忆：持久性事实、偏好、决策
└── memory/ # 每日笔记目录
├── 2026-03-21.md # 前天的对话记录
├── 2026-03-22.md # 昨天的对话记录
└── 2026-03-23.md # 今天的对话记录两者的分工可以这样理解：
| 位置 | 内容性质 | 加载时机 |
|---|---|---|
MEMORY.md |
精炼后的长期事实，如”偏好结构化报告” | 每次主会话启动时自动加载 |
memory/YYYY-MM-DD.md |
当天的原始日志，如某次对话的关键决策 | 今天和昨天的文件自动加载，更早的按需搜索 |
每次开启主会话，管家都会读取 MEMORY.md，确保它”认识你”。群组对话中不会加载这个文件，以保护个人隐私。
memory/ 目录则是每日流水账。管家把当天发生的事写进对应日期的文件。这些文件不会全部加载。系统只自动读取今天和昨天的笔记，更早的内容通过搜索工具按需查找。
记忆怎么产生
管家的记忆通过以下几条路径产生。
你主动要求
最直接的方式：你告诉管家需要记住什么，管家就写入对应文件。
记住：我偏好用 Python 做数据分析，输出格式用 Markdown 表格管家收到这条指令后，会把内容写进 MEMORY.md。下次对话时，管家已经知道你的偏好，不需要你再说一遍。
对话过长时自动整理
当一次对话持续很长、内容积累较多时，系统会在整理对话之前，先让管家把重要内容保存到当天的每日笔记（memory/YYYY-MM-DD.md）中。这个过程默认开启，无需配置。
它的作用是防止信息丢失。管家会判断哪些内容有长期价值（比如一项决策、一个经验教训），写入每日笔记，然后再整理对话。
/new 时自动归档
在安装引导（onboard）中启用了 session-memory Hook 后，每次输入 /new 或 /reset 开启新对话时，系统会自动生成本次对话的摘要并保存到 memory/ 目录，文件名根据对话内容生成，格式为 YYYY-MM-DD-主题描述.md，例如 2026-04-23-财报分析方案讨论.md。
开启新对话不意味着丢失上下文。session-memory Hook 会在清空对话窗口之前，把关键内容归档到记忆文件。下次对话时，管家可以通过搜索工具找回这些内容。
一个典型场景：上午你和管家讨论了一份财报分析方案，下午用 /new 切换到另一个话题。第二天你问”昨天讨论的财报分析方案是什么”，管家通过搜索记忆文件，就能找到相关内容。
记忆怎么搜索
管家内置了两个记忆工具：
| 工具 | 功能 |
|---|---|
memory_search |
搜索记忆文件，支持语义匹配（措辞不同也能找到）和关键词精确匹配 |
memory_get |
读取特定记忆文件的内容 |
你不需要手动调用这些工具。当你问管家”我之前说过关于 XX 的什么”，管家会自动用 memory_search 搜索记忆文件，找到相关内容后回复你。
记忆搜索让管家能够跨越多次对话积累经验。你不需要每次都重新解释背景和偏好。对于长期项目，管家可以回忆起之前的讨论、决策和经验教训，就像一个真正了解你的助手。
记忆架构的设计延续了索引式设计的思路：管家不是把所有历史对话塞进每次对话中，而是通过 MEMORY.md 保存精炼的长期画像，通过 memory/ 保存每日原始记录，再用搜索工具按需调取。记忆文件都是普通的 Markdown，你可以随时查看和编辑。