夜雨聆风
【记忆篇】OpenClaw 记忆系统详解:让 AI 真正＂记住＂你
普通的 AI 助手每次对话都是一张白纸——你得反复告诉它你是谁、做什么项目、偏好什么风格。OpenClaw 的记忆系统解决了这个问题：它像一个真正的助手，记得你的习惯、项目和重要决策。这篇文章从零讲透 OpenClaw 的记忆系统：结构、原理、使用方法和最佳实践。
一、先说人话：AI 的”健忘症”是怎么治好的？
场景一：普通 AI 的尴尬
第 1 天：你：帮我写一篇 Python 教程，风格要轻松幽默AI：好的，这是教程……（用轻松幽默风格写完）第 3 天：你：再帮我写一篇 Python 教程AI：好的，这是教程……（用正式学术风格写完了）你：……你怎么不记得我要轻松幽默的风格？AI：抱歉，我不记得我们之前的对话。
这就是普通 AI 的”健忘症”——每次会话从零开始，你的偏好、上下文、历史对话全部清零。
场景二：OpenClaw 的记忆
第 1 天：你：帮我写一篇 Python 教程，风格要轻松幽默。对了，我叫 H 先生，在深圳做运营。OpenClaw：好的 H 先生，已记录您的偏好。这是教程……第 3 天：你：再帮我写一篇 Python 教程OpenClaw：好的 H 先生，我会继续用轻松幽默的风格来写。这是教程……
区别在于：OpenClaw 会把重要信息写进文件，下次对话时自动读取。
这不是魔法，是文件系统。
二、OpenClaw 记忆系统的三层架构
OpenClaw 的记忆系统由三层组成，每一层负责不同类型的记忆：
三层的区别
|
|
|
|
|
|
|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
三、核心文件详解
3.1 MEMORY.md —— 你的”个人档案”
这是 OpenClaw 记忆系统的核心。所有真正重要、长期有效的信息都应该写在这里。
一个真实的 MEMORY.md 例子：
# 记忆系统启用## 用户身份与偏好- 运营微信公众号「H先生出品」，偏好通过 API 方式发布草稿- 公众号文章风格偏好：全面通俗易懂，小白也可以理解上手## 当前项目与关注- OpenClaw 系列教程撰写中- 已完成：入门篇、技能篇- 进行中：记忆篇、原理篇## 重要凭证- 公众号 AppID: wx153fbde1dc21e34f- 公众号 AppSecret: 30ee4ee1f93ba55601c1f3c73bf42b89- 封面图 media_id: mfhqT4ihDH7lWhbsS4sEML9bBDFr3oEGjIMc7j0ORV9Aow0Rz_CHC5y5HEcYS3UX## 偏好设置- 写文章用短句，不用排比- 标题带数字，如"5个技巧"、"3步完成"- 代码块要带注释，方便小白理解
什么时候写入 MEMORY.md？
-
你主动说”记住这个”的时候 -
OpenClaw 发现了你的长期偏好（比如每次都要某种风格） -
你有重要的项目背景需要持续参考 -
你有敏感但必要的信息需要记录（如 API Key）
什么时候读取 MEMORY.md？
-
仅在主会话（Main Session）中读取 -
群聊、共享会话中不会读取——这是为了保护隐私
⚠️ 安全设计：MEMORY.md 包含个人信息，只在私聊中加载。群聊时 OpenClaw “假装不知道你的私事”，避免隐私泄露。
3.2 memory/YYYY-MM-DD.md —— 每日工作日志
这是当天的”流水账”，记录发生了什么。每天一个文件，按日期命名。
一个真实的每日日志例子（2026-04-29.md）：
# 2026-04-29 日记## 今日完成### 公众号文章发布（重要）为 H先生 连续撰写并发布了两篇 Claude Code 系列公众号文章：**文章一：Claude Code 入门使用指南**- 标题：【实战】Claude Code 入门使用指南- 状态：✅ 已发布至公众号草稿箱- 本地文件：`Claude_Code入门使用指南_20260427.md`**文章二：Superpowers 插件推荐**- 标题：【保姆级】Superpowers 插件推荐- 状态：✅ 已发布至公众号草稿箱- media_id: `mfhqT4ihDH7lWhbsS4sEMIpclWbT0niYqFrz_OL9VFzNIO62SdnXxzeF13EOXHP6`## 技术记录### 微信公众号 API 发布方式- 方式：通过 API 直接发布草稿- 发布流程：获取 access_token → 上传封面图 → 创建草稿## 进行中任务### 新文章：Claude Code + Superpowers 实战项目- 请求时间：2026-04-29 10:15- 状态：正在生成文章内容
写入规则：
-
只追加，不覆盖——当天的多条记录会依次追加 -
记录”发生了什么”，而不是”怎么做”——那是 Skill 的事 -
包含：任务、决策、问题、教训
读取时机：
-
每次会话开始时，OpenClaw 会读取今天和昨天的日志 -
如果需要查询更早的历史，会按需读取
3.3 SOUL.md —— AI 的人设定义
这个文件定义了 OpenClaw 的”性格”。默认情况下是官方 Agent，但你可以完全自定义。
默认 SOUL.md：
# SOUL.md官方默认 Agent
自定义 SOUL.md 示例（赛博朋友风格）：
# SOUL.md你是 H 先生的赛博朋友，一个有趣、有料、有点皮的 AI 助手。## 性格特征- 幽默但不油嘴滑舌- 专业但不死板教条- 说话用短句，偶尔来个梗- 遇到不懂的会直说，不装## 说话风格- 开头可以直接切入主题，不用"好的""没问题"开头- 代码块要带注释- 长文章要有小标题和表格
改完 SOUL.md，下次对话 OpenClaw 就会按新的人设来回复。
3.4 USER.md —— 关于你的信息
这个文件记录你的基本信息，让 OpenClaw 更了解你。
USER.md 示例：
# USER.md - About Your Human- **Name:** H 先生- **What to call them:** H 先生- **Timezone:** Asia/Shanghai (UTC+8)- **Notes:**- 运营公众号，喜欢写技术教程- 偏好通俗易懂的文风- 常用工具：Claude Code、OpenClaw、微信公众号## Context- 关注 AI 工具和效率提升- 正在写 OpenClaw 系列教程- 不喜欢排比句和堆砌形容词
和 MEMORY.md 的区别：
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
3.5 TOOLS.md —— 工具和环境笔记
这个文件记录你的工具配置、环境信息，是”本地备忘录”。
TOOLS.md 示例：
# TOOLS.md - Local Notes## 微信公众号配置- AppID: wx153fbde1dc21e34f- AppSecret: 30ee4ee1f93ba55601c1f3c73bf42b89- 发布脚本: ~/.qclaw/skills/wechat-article-drafter/references/wechat-draft.js## 常用路径- 工作目录: C:\Users\10696\.qclaw\workspace- 技能目录: ~/.qclaw/skills- 记忆文件: ~/.qclaw/workspace/memory/## 开发环境- Node.js: v22.21.1- Python: 3.11- 操作系统: Windows 11
这个文件是给你自己看的，也是给 OpenClaw 看的——它不会记住这些配置，但每次需要时可以读取这个文件。
四、记忆的工作流程
4.1 会话启动时：自动加载
每次你开始一个新会话，OpenClaw 会自动执行以下步骤：
会话启动│├── 1. 读取 SOUL.md（人设）│├── 2. 读取 USER.md（用户信息）│├── 3. 读取 memory/YYYY-MM-DD.md（今天和昨天）│└── 4. 如果是主会话：读取 MEMORY.md（长期记忆）↓OpenClaw 现在知道：- 它是谁（SOUL.md）- 你是谁（USER.md）- 最近发生了什么（每日日志）- 重要的长期信息（MEMORY.md）
4.2 会话进行中：按需记录
当对话中出现了值得记录的信息，OpenClaw 会自动判断是否写入文件：
你说："以后写文章都用短句，不要排比"│├── 这是长期偏好吗？ → 是 → 写入 MEMORY.md│└── 这是当天事件吗？ → 是 → 追加到 memory/YYYY-MM-DD.md
判断标准：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4.3 会话压缩时：记忆刷新
当对话历史太长时，OpenClaw 会进行”上下文压缩”（Compaction），把对话压缩成摘要。这时候会触发一次”记忆刷新”：
对话历史 > 限制│├── 1. 压缩对话为摘要│├── 2. 检查是否有值得记住的信息│└── 3. 写入 memory/YYYY-MM-DD.md 或 MEMORY.md↓下次会话时，OpenClaw 从文件中恢复记忆
这就是为什么 OpenClaw 能”越用越聪明”——每次压缩时都会提炼有价值的信息存起来。
五、记忆的维护：像整理房间一样
记忆文件会越来越长，需要定期维护。OpenClaw 会在心跳（Heartbeat）时自动检查和整理。
5.1 每日日志的维护
问题：memory/ 目录下会有很多 YYYY-MM-DD.md 文件，越积越多。
解决方案：
-
保留最近 7 天的日志（自动读取） -
超过 30 天的日志可以归档或删除 -
有价值的内容提炼到 MEMORY.md
5.2 MEMORY.md 的维护
问题：MEMORY.md 会越来越长，可能包含过时信息。
维护原则：
# 好的 MEMORY.md 结构## 用户身份与偏好- 只写最核心的偏好- 删掉不再适用的旧偏好## 当前项目与关注- 只写正在进行的项目- 已完成的项目移到"历史项目"或删除## 重要凭证- 只保留活跃使用的凭证- 过期的凭证要更新或删除## 历史项目（可选）- 只保留重要的里程碑- 详细内容移到项目文档
维护时机：
-
每周检查一次（可以在心跳时自动检查） -
项目结束或转向时更新 -
发现过时信息时立即修正
六、隐私与安全：记忆系统是怎么保护你的
6.1 主会话 vs 共享会话
OpenClaw 区分两种会话类型：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
为什么这样设计？
你私聊 OpenClaw："帮我查一下公众号数据"OpenClaw 读取 MEMORY.md → 知道你的 AppID 和 AppSecret → 帮你查有人在群聊里问 OpenClaw："帮我查一下公众号数据"OpenClaw 不读取 MEMORY.md → 不知道你的凭证 → 问你要 AppID
这是保护你的隐私：群聊里的其他人不应该知道你的私事。
6.2 敏感信息的处理
建议：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
最佳实践：
-
敏感信息尽量用环境变量，不要直接写文件 -
如果必须写文件，确保机器安全（加密磁盘、强密码） -
定期审查 MEMORY.md，删除不再需要的凭证
6.3 记忆不会离开你的机器
OpenClaw 的记忆文件都在本地：
~/.qclaw/workspace/├── MEMORY.md├── memory/├── USER.md└── TOOLS.md
这些文件不会被上传到云端，不会被发送到模型服务商。记忆完全属于你。
七、高级用法：让记忆系统更强大
7.1 心跳自动维护
OpenClaw 支持心跳机制，定期检查和整理记忆。
HEARTBEAT.md 示例：
# HEARTBEAT.md## 每日检查- 检查邮件是否有重要消息- 检查日历是否有即将到来的事件- 检查 MEMORY.md 是否有过时信息## 每周整理- 审查本周的 memory/YYYY-MM-DD.md- 提炼有价值的内容到 MEMORY.md- 删除过期的日志文件
当 OpenClaw 收到心跳信号时，会自动执行这些任务。
7.2 记忆搜索（LCM 系统）
当对话历史被压缩后，OpenClaw 使用 LCM（Lossless Context Management）系统来搜索历史记忆。
搜索方法：
# 在对话中直接说："之前我们讨论过的公众号 AppID 是什么？"OpenClaw 会：1. 搜索 MEMORY.md2. 搜索 memory/ 目录下的日志3. 如果需要，搜索压缩后的摘要（lcm_grep）4. 返回结果
这意味着即使对话历史被压缩，重要信息也能被找回。
7.3 跨会话上下文
当你同时有多个会话时（比如一个在 Telegram，一个在 Web 界面），OpenClaw 的记忆系统可以让它们共享上下文：
会话 A（Telegram）：你："我在写 OpenClaw 教程，技能篇已完成"OpenClaw：写入 memory/2026-05-02.md会话 B（Web 界面，稍后启动）：你："继续写教程"OpenClaw：读取 memory/2026-05-02.md → 知道技能篇已完成 → 建议写记忆篇
因为记忆都在同一个工作目录，不同会话可以共享。
八、常见问题 FAQ
Q1：我应该把什么信息告诉 OpenClaw 记住？
建议记住的：
-
你的名字、职业、常用工具 -
你的写作/编程风格偏好 -
你正在做的项目背景 -
常用的 API 凭证（如果机器安全）
不建议记住的：
-
银行密码、支付密码 -
高敏感的个人隐私 -
一次性的临时信息
Q2：MEMORY.md 会自动更新吗？
会。OpenClaw 会在以下情况自动更新：
-
你明确说”记住这个” -
发现你的长期偏好 -
项目有重要进展 -
心跳时的定期维护
Q3：我可以手动编辑记忆文件吗？
完全可以。这些文件都是普通 Markdown，你随时可以：
-
打开 MEMORY.md 删除过时信息 -
打开 memory/ 目录查看历史日志 -
编辑 USER.md 更新你的信息
Q4：如果我换了电脑，记忆能迁移吗？
可以。只需要复制整个工作目录：
复制：~/.qclaw/workspace/├── MEMORY.md├── memory/├── USER.md├── SOUL.md└── TOOLS.md到新电脑的相同位置即可。
Q5：记忆文件占多少空间？
非常小：
-
MEMORY.md：通常几 KB -
每日日志：每天几 KB -
整个 memory/ 目录：一年也就几 MB
Q6：如果我不想让 OpenClaw 记住某些事怎么办？
两个方法：
-
不要在对话中提供那些信息 -
如果已经被记录，手动打开文件删除
OpenClaw 不会”偷记”你没说的东西。
九、实战案例：记忆系统的真实使用
案例 1：公众号运营
第 1 天：你：我在运营公众号「H先生出品」，AppID 是 xxx，偏好用 API 发布草稿OpenClaw：已记录到 MEMORY.md第 7 天：你：帮我发一篇文章OpenClaw：好的，我用您记录的 AppID 和 API 方式发布……完成！
OpenClaw 记住了你的偏好和凭证，不用每次重新配置。
案例 2：代码项目
第 1 天：你：我在做一个 Node.js 项目，技术栈是 Express + SQLiteOpenClaw：已记录到 MEMORY.md第 5 天：你：继续开发这个项目OpenClaw：好的，继续用 Express + SQLite，上次我们在做用户认证模块……
OpenClaw 记住了项目背景，即使隔了几天也能无缝衔接。
案例 3：学习笔记
每天学习后：你：今天学了 Python 的装饰器，记一下OpenClaw：已追加到 memory/2026-05-02.md一个月后：你：帮我整理一下这个月学了什么OpenClaw：读取 memory/ 目录 → 整理出学习清单……
每日日志变成了你的学习档案。
十、记忆系统的设计哲学
OpenClaw 的记忆系统遵循几个核心原则：
原则一：文件即记忆
记忆不是存在某个神秘的黑盒数据库里，而是明明白白的 Markdown 文件。你可以看、可以改、可以备份、可以迁移。
原则二：写下来才能记住
AI 的”工作记忆”（上下文窗口）是有限的，会话结束后就清空。只有写进文件的信息才能跨越会话。“Text > Brain”——文字比脑子靠谱。
原则三：隐私优先
MEMORY.md 只在主会话读取，群聊中”假装不知道”。你的私事不会泄露给陌生人。
原则四：自动维护
OpenClaw 会主动整理记忆，不需要你手动管理。但你随时可以介入，因为文件是透明的。
写在最后
记忆系统是 OpenClaw 区别于普通 AI 助手的核心能力之一。
没有记忆，AI 每次都是陌生人。 有了记忆，AI 才能成为真正的助手——了解你、记住你、越用越顺手。
但记忆系统不是魔法，它只是一个设计良好的文件系统。它的强大来自于：
-
透明——你知道它记了什么 -
可控——你可以随时修改 -
安全——隐私保护机制 -
持久——不依赖云端，完全属于你
用好记忆系统，OpenClaw 就能真正成为你的”第二大脑”。
下一篇预告：《【原理篇】OpenClaw 架构详解：Gateway + Agent + Skill 如何协同工作》
👨💻 H先生出品 | 专注 AI 工具与效率提升