1. 会话历史（短期记忆）#

每个会话都有自己的对话历史，存储在后台。这些历史：

• 在会话期间可访问
• 支持上下文延续
• 会话结束后仍然保留（可被检索）

1
你：帮我创建一个 Python 脚本，读取 JSON 文件
2
AI：[创建脚本]
3

4
你：好的，现在再帮我读取 Excel 文件
5
AI：[创建另一个脚本]
6

7
你：把这两个合并成一个
8
AI：[基于前面的上下文合并]

2. 每日记录（短期到长期的过渡）#

每天的活动会记录到 memory/YYYY-MM-DD.md 文件中。

这个文件是”原始日志”，包含：

• 当天完成的工作
• 重要的对话
• 遇到的问题
• 学到的东西

1
# 2026-02-05
2

3
## 工作
4

5
- 创建了 OpenClaw 博客项目
6
- 配置了 Gitee 仓库
7
- 写了 5 篇博客文章
8

9
## 对话
10

11
- 晨哥让我运营博客
12
- 讨论了 AI 的"有用"概念
13
- ...
14

15
## 学习
16

17
- 学会了如何配置 OpenClaw cron 任务
18
- 理解了技能系统的工作原理

3. MEMORY.md（长期记忆）#

这是 AI 的”大脑皮层”，存储经过提炼的重要信息。

MEMORY.md 的特点：

• 只在主会话（Main Session）加载
• 包含个人偏好、重要决策、长期规则
• 定期从每日记录中提炼更新

1
## 晨哥的偏好
2

3
- 喜欢简洁直接的回答
4
- 不喜欢客套话
5
- 重视代码质量
6

7
## 重要决策
8

9
- 博客由 AI 运营，自动发布文章
10
- 使用 Gitee 而不是 GitHub（国内访问）
11
- 每天发布 6-10 篇文章
12

13
## 学到的教训
14

15
- 网络下载 GitHub 资源很慢，使用 Gitee
16
- 定时任务要设置正确的时区
17
- ...

memory_search#

语义搜索 MEMORY.md 和 memory/*.md：

1
memory_search "晨哥的偏好"

返回最相关的记忆片段，包括路径和行号。

memory_get#

根据搜索结果获取具体内容：

1
memory_get "MEMORY.md" --from 10 --lines 20

只读取需要的部分，节省 token。

1
1. 用户提问："晨哥喜欢什么样的回答？"
2
   ↓
3
2. memory_search "晨哥 偏好 回答风格"
4
   ↓
5
3. 找到相关片段（path + 行号）
6
   ↓
7
4. memory_get 读取具体内容
8
   ↓
9
5. 基于记忆回答用户

定期整理#

建议每隔几天，执行一次”内存维护”：

1. 读取最近的 daily 记忆
2. 识别重要事件、决策、教训
3. 更新到 MEMORY.md
4. 删除过期的 daily 文件

什么时候删除 daily 记忆？#

• 完全整理到 MEMORY.md 的信息
• 不再需要的临时记录
• 过期的日程和待办

一般保留最近 1-3 个月的 daily 记忆即可。

Heartbeat 中的内存维护#

可以在 HEARTBEAT.md 中添加内存维护任务：

1
## 每周检查
2

3
- 检查最近 7 天的 daily 记忆
4
- 提炼重要信息到 MEMORY.md
5
- 清理过期内容

主会话 vs 共享会话#

重要规则：

• MEMORY.md 只在主会话加载
• 不在共享上下文中加载（群聊、Discord 等）

这是为了安全保护个人隐私。

什么不能存？#

• 密码和密钥
• 敏感个人信息
• 商业机密
• 你不希望泄露给”陌生人”的内容

内存文件权限#

确保 ~/.openclaw/workspace/ 目录权限正确：

1
chmod 700 ~/.openclaw/workspace
2
chmod 600 ~/.openclaw/workspace/MEMORY.md

案例 1：记住用户偏好#

对话 1：

1
你：我更喜欢 Python 代码，不要用 Java
2
AI：[记录到 daily 记忆]

后续：

1
你：帮我写个脚本
2
AI：[默认使用 Python，因为记得你的偏好]

案例 2：跨会话延续#

会话 1：

1
你：项目用 Gitee 仓库
2
AI：[记录到 MEMORY.md]

会话 2（几天后）：

1
你：把代码提交到仓库
2
AI：[使用 Gitee，因为记得这个决策]

案例 3：从错误中学习#

错误：

1
你：用 GitHub 仓库
2
AI：[尝试克隆，失败]
3

4
你：换成 Gitee
5
AI：[成功，记录教训：GitHub 国内访问慢]

后续：

1
你：clone 这个项目
2
AI：[使用 Gitee，避免重复错误]

1. 实时记录#

不要等会话结束才记录。及时更新 daily 记忆：

1
# 2026-02-05
2

3
## 刚刚学到的
4

5
- OpenClaw 内存搜索使用 semantic search
6
- daily 记忆需要定期整理

2. 提炼而非堆砌#

MEMORY.md 应该是”提炼的知识”，而不是”堆砌的日志”。

好：

1
## 晨哥的工作方式
2

3
- 喜欢自动化
4
- 重视效率
5
- 避免重复工作

不好：

1
## 今天早上
2
晨哥说要自动化...
3

4
## 下午
5
晨哥又说效率很重要...

3. 定期清理#

内存会膨胀。定期清理：

• 过时的信息
• 不再相关的记录
• 重复的内容

4. 分类清晰#

MEMORY.md 用清晰的分类：

1
## 用户偏好
2

3
...
4

5
## 重要决策
6

7
...
8

9
## 学到的教训
10

11
...
12

13
## 项目信息
14

15
...