我们在用OpenClaw（也就是大家常说的“小龙虾”）时，都会被一个能力打动：它似乎真的能“记住”你。
你告诉它你的偏好、工作背景、当前项目，过一段时间再聊，它还能延续之前的上下文；甚至在某些场景下，它会主动调用过去的信息，那么它的底层是什么呢？

一、为什么 AI 需要“记忆”？

在理解 OpenClaw 的记忆系统之前，我们先要搞清楚一个核心概念：上下文 ≠ 记忆。

• 上下文：模型在单次请求中能看到的所有信息（系统提示词、历史对话、工具调用结果）。它的本质是临时的、容量受限的、成本高昂的。
• 记忆：持久存储在磁盘上的结构化信息。它可以无限增长、跨会话保留、按需检索。

大多数 AI 应用只是简单地把“上下文窗口”当作记忆的全部。但 Claude 的 200K tokens 和 GPT-4 的 128K tokens 看起来很大，一旦对话超过限制，模型要么遗忘早期信息，要么因为成本暴涨而不得不重置会话窗口。

二、OpenClaw 的三级记忆架构

打开你的 OpenClaw 工作区，会看到这样的结构：

~/.openclaw/workspace/
├── MEMORY.md              # 长期记忆：偏好、决策、持久事实
├── memory/
│   ├── 2026-03-05.md      # 今日日志（短期记忆）
│   ├── 2026-03-04.md      # 昨日日志
│   └── ...                # 历史日志
├── sessions/              # 会话存档（近端记忆）
├── USER.md                # 用户身份
└── SOUL.md                # Agent人格设定

这套结构对应着三个层次：

记忆层级	存储位置	内容特点	加载时机
短期记忆	memory/YYYY-MM-DD.md	当天发生的事、临时决策，append-only	新会话自动加载“今天+昨天”
近端记忆	sessions/*.jsonl	完整会话存档，未经处理的原始对话	被压缩时关键信息冲刷至此
长期记忆	MEMORY.md 及其他 *.md	技术栈偏好、项目决策、常用工具链	每次私聊自动加载

以下是对各个文件和目录内容的详细解析：

1. MEMORY.md (长期记忆 / Long-term Memory)

这是 Agent 的核心知识库。它存储的是经过提炼的、具有持久价值的信息。

• 内容： 你的核心偏好（如：习惯使用 Java、喜欢简洁的代码风格）、重大的决策记录、项目全局背景、以及 Agent 学习到的关于你的固定事实。
• 作用： 确保 Agent 在跨越数月后依然记得你的编程习惯或某个项目的终极目标。

2. memory/ 目录 (短期记忆 / Short-term Memory)

这是按日期排列的流水账日志。

• 2026-03-05.md（今日日志）： 记录今天你和 AI 讨论了什么、解决了哪些 Bug、达成了哪些小目标。
• 2026-03-04.md（历史日志）： 昨天的记录。
• 作用： 提供时间线线索。当你说“记得我们前天谈到的那个方案吗？”，Agent 会回溯这些文件来找回上下文。

3. sessions/ 目录 (会话存档 / Contextual Memory)

这是原始对话的快照。

• 内容： 存储具体的聊天会话记录（可能是 JSON 或 Markdown 格式）。
• 作用： 保存对话的细节。如果 memory/ 里的日志是“摘要”，那么 sessions/ 就是“录音回放”，用于在需要高度精确的上下文时进行检索。

4. USER.md (用户身份 / User Profile)

这是关于**“你”**的画像。

• 内容： 你的姓名、职业（如：技术博主）、技术栈、时区、联系方式、甚至是你的沟通风格倾向（如：直爽、讨厌废话）。
• 作用： 让 Agent 知道它在为谁服务，从而提供高度定制化的建议。

5. SOUL.md (人格设定 / Agent Persona)

这是 Agent 的**“灵魂”或元指令**。

• 内容： 定义 Agent 的身份（如：资深架构师、幽默的编程助手）、说话语气、遵循的原则、价值观以及它的局限性。
• 作用： 保证 Agent 的行为一致性。无论它学习了多少新知识，其回复的风格和态度都由这个文件锚定。

---

总结对照表

维度	文件/路径	模拟人类功能	更新频率
持久性	MEMORY.md	经验与常识	低（去粗取精）
时间线	memory/	每日经历	高（每日生成）
交互	sessions/	瞬间对话记录	极高（实时）
主客体	USER.md & SOUL.md	自我意识与对方认知	极低（相对固定）