【记忆篇】OpenClaw 记忆系统详解：让 AI 真正"记住"你

常威正在打来福
0 阅读14分钟

普通的 AI 助手每次对话都是一张白纸——你得反复告诉它你是谁、做什么项目、偏好什么风格。OpenClaw 的记忆系统解决了这个问题：它像一个真正的助手，记得你的习惯、项目和重要决策。这篇文章从零讲透 OpenClaw 的记忆系统：结构、原理、使用方法和最佳实践。

openclaw记忆篇2.jpg

一、先说人话：AI 的"健忘症"是怎么治好的？

场景一：普通 AI 的尴尬

 第 1 天：
 你：帮我写一篇 Python 教程，风格要轻松幽默
 AI：好的，这是教程……（用轻松幽默风格写完）
 ​
 第 3 天：
 你：再帮我写一篇 Python 教程
 AI：好的，这是教程……（用正式学术风格写完了）
 你：……你怎么不记得我要轻松幽默的风格？
 AI：抱歉，我不记得我们之前的对话。

这就是普通 AI 的"健忘症"——每次会话从零开始，你的偏好、上下文、历史对话全部清零。

场景二：OpenClaw 的记忆

 第 1 天：
 你：帮我写一篇 Python 教程，风格要轻松幽默。对了，我叫 H 先生，在深圳做运营。
 OpenClaw：好的 H 先生，已记录您的偏好。这是教程……
 ​
 第 3 天：
 你：再帮我写一篇 Python 教程
 OpenClaw：好的 H 先生，我会继续用轻松幽默的风格来写。这是教程……

区别在于：OpenClaw 会把重要信息写进文件，下次对话时自动读取。

这不是魔法，是文件系统。

二、OpenClaw 记忆系统的三层架构

OpenClaw 的记忆系统由三层组成，每一层负责不同类型的记忆：

openclaw记忆篇3层.jpg

三层的区别

层级文件内容更新频率类比
长期记忆MEMORY.md核心信息、偏好、决策按需更新个人档案
每日日志memory/YYYY-MM-DD.md当日事件、流水账每天追加工作日记
身份文件SOUL.md / USER.md人设、用户信息很少改角色卡

三、核心文件详解

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 的区别：

USER.mdMEMORY.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

判断标准：

信息类型写入位置例子
长期偏好MEMORY.md"我喜欢短句风格"
项目决策MEMORY.md"项目技术栈定为 Node.js + SQLite"
API 凭证MEMORY.md 或 TOOLS.md"公众号 AppID: xxx"
当日事件memory/YYYY-MM-DD.md"今天发布了文章"
遇到的问题memory/YYYY-MM-DD.md"xbrowser 占用 1.8GB，已删除"

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 区分两种会话类型：

会话类型读取 MEMORY.md例子
主会话✅ 读取你在 Telegram/微信私聊 OpenClaw
共享会话❌ 不读取OpenClaw 在群聊中、多用户场景

为什么这样设计？

你私聊 OpenClaw：
  "帮我查一下公众号数据"
  OpenClaw 读取 MEMORY.md → 知道你的 AppID 和 AppSecret → 帮你查

有人在群聊里问 OpenClaw：
  "帮我查一下公众号数据"
  OpenClaw 不读取 MEMORY.md → 不知道你的凭证 → 问你要 AppID

这是保护你的隐私：群聊里的其他人不应该知道你的私事。

6.2 敏感信息的处理

建议：

信息类型存放位置原因
API Key / SecretTOOLS.md 或 MEMORY.md需要用，但要保护好
密码❌ 不建议存储太敏感
个人隐私MEMORY.md（仅在主会话读取）有上下文保护

最佳实践：

  1. 敏感信息尽量用环境变量，不要直接写文件
  2. 如果必须写文件，确保机器安全（加密磁盘、强密码）
  3. 定期审查 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.md
2. 搜索 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 记住某些事怎么办？

两个方法：

  1. 不要在对话中提供那些信息
  2. 如果已经被记录，手动打开文件删除

OpenClaw 不会"偷记"你没说的东西。

九、实战案例：记忆系统的真实使用

案例 1：公众号运营

第 1 天：
你：我在运营公众号「H先生出品」，AppID 是 xxx，偏好用 API 发布草稿
OpenClaw：已记录到 MEMORY.md

第 7 天：
你：帮我发一篇文章
OpenClaw：好的，我用您记录的 AppID 和 API 方式发布……完成！

OpenClaw 记住了你的偏好和凭证，不用每次重新配置。

案例 2：代码项目

第 1 天：
你：我在做一个 Node.js 项目，技术栈是 Express + SQLite
OpenClaw：已记录到 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 才能成为真正的助手——了解你、记住你、越用越顺手。

但记忆系统不是魔法，它只是一个设计良好的文件系统。它的强大来自于：

  1. 透明——你知道它记了什么
  2. 可控——你可以随时修改
  3. 安全——隐私保护机制
  4. 持久——不依赖云端，完全属于你

用好记忆系统，OpenClaw 就能真正成为你的"第二大脑"。

下一篇预告：《【原理篇】OpenClaw 架构详解：Gateway + Agent + Skill 如何协同工作》

👨‍💻 H先生出品 | 专注 AI 工具与效率提升

avatar
文章
阅读
粉丝