OpenClaw Memory 系统详解：让 AI 助手真正记住你

• • OpenClaw教程

用过 ChatGPT、Claude 这类 AI 助手的朋友一定有这种体验：每次开启新对话，它就像失忆了一样，完全不认识你。上一次聊到你的项目进度、你的偏好、你的工作习惯——全部清零。这不是 AI 的「性格缺陷」，而是大语言模型的技术架构决定的：每次对话都是独立的上下文窗口，没有跨会话的持久记忆。

OpenClaw 的 Memory 系统正是为了解决这个问题而设计的。它通过一套结构化的文件体系，让 AI 助手在每次唤醒时都能「想起」你是谁、你们聊过什么、你的偏好是什么。本文将深入解析这套记忆系统的架构、工作原理和最佳实践。

AI 助手的记忆困境

先理解问题的根源。大语言模型（LLM）本身是无状态的——它不「记得」任何事情。每次对话开始时，系统会把一些文本（System Prompt + 对话历史）塞进上下文窗口，模型基于这些文本生成回复。对话结束后，一切归零。

这意味着：

  • 你告诉 AI 你叫什么名字，下次它忘了
  • 你纠正了 AI 的错误，下次它又犯同样的错
  • 你分享了项目背景，下次你得重新说一遍
  • 你的偏好和习惯，AI 每次都要重新学习

ChatGPT 的 Memory 功能尝试解决这个问题，但它是平台锁定的、不可控的黑盒。OpenClaw 选择了另一条路：把记忆做成你拥有、你控制、你可编辑的文件系统。

OpenClaw 的记忆架构

OpenClaw 的记忆不是一个数据库，而是一组 Markdown 文件，放在工作目录（workspace）中。每个文件承担不同的记忆职责：

🧠 SOUL.md — 人格定义

这是 AI 助手的「灵魂」。它定义了 AI 的性格特征、说话风格、行为准则和价值观。每次会话启动时，SOUL.md 是最先被读取的文件之一。

示例内容：

# SOUL.md - Who You Are

Be genuinely helpful, not performatively helpful.
Have opinions. Be resourceful before asking.
Earn trust through competence.

你可以完全自定义 SOUL.md，让 AI 变成你想要的样子——专业严谨的、幽默风趣的、话少高效的，全由你决定。

👤 USER.md — 用户档案

记录「主人」是谁。名字、时区、偏好、正在做的项目、沟通风格等。AI 每次启动都会读取这个文件，确保它知道在为谁服务。

# USER.md

- **Name:** zzh
- **Timezone:** Asia/Shanghai
- **Notes:** Prefers humorous and witty style
- **Projects:** 定风波博客、OpenClaw 部署

📝 MEMORY.md — 长期记忆

这是最重要的记忆文件。AI 会在这里记录重要的决策、学到的教训、长期的上下文信息。它不是原始日志，而是经过提炼和整理的精华内容。

MEMORY.md 的内容应该：

  • 记录重要的决策和原因
  • 保存学到了什么教训
  • 追踪正在进行的项目状态
  • 记录用户的偏好和习惯
  • 定期清理过时信息

📅 memory/YYYY-MM-DD.md — 每日日志

每天一个文件，记录当天发生的事件。这是「原始数据」——聊天内容、操作记录、临时想法等。AI 会在适当的时候将每日日志中的重要内容提炼到 MEMORY.md 中。

文件命名格式固定为 memory/2026-04-01.md，按日期归档，方便回溯。

🔧 TOOLS.md — 工具笔记

记录工具和环境相关的配置信息。比如 SSH 连接信息、摄像头名称、TTS 语音偏好等。这些是环境特定的信息，不应该混入用户档案或长期记忆中。

📄 AGENTS.md — 行为规范

定义 AI 的工作流程和规则。什么时候该读什么文件、什么时候该主动做什么、红线在哪里。这是 AI 的「操作手册」。

记忆的工作流程

OpenClaw 的记忆不是被动存储，而是一套完整的读取→工作→记录循环：

1. 会话启动：读取记忆

每次新会话开始，AI 会按照 AGENTS.md 定义的顺序，依次读取关键文件：

  1. SOUL.md — 我是谁
  2. USER.md — 我在为谁服务
  3. memory/今天.md + memory/昨天.md — 最近发生了什么
  4. 如果是主会话，还要读 MEMORY.md — 长期记忆

这个过程通常在几秒内完成，但它是 AI「恢复记忆」的关键步骤。

2. 对话过程中：更新记忆

在对话过程中，当发生值得记录的事情时，AI 会主动写入对应的文件：

  • 用户说「记住这个」→ 写入今天的每日日志
  • 学到了一个教训 → 更新 AGENTS.md 或 TOOLS.md
  • 完成了一个重要任务 → 更新 MEMORY.md
  • 用户的偏好变化 → 更新 USER.md

3. 会话结束：整理记忆

在心跳（heartbeat）机制或会话间隙，AI 会定期回顾最近的每日日志，将重要内容提炼到 MEMORY.md 中，清理过时信息。这就是「记忆巩固」的过程，类似于人类睡眠时大脑整理白天的经历。

memory_search：语义搜索记忆

当记忆文件越来越多，线性读取所有文件变得低效。OpenClaw 提供了 memory_search 功能，支持基于语义的向量搜索。

工作原理：

  1. 所有记忆文件被切分为小段（chunks）
  2. 每段通过 Embedding 模型转化为向量
  3. 向量存储在本地的向量数据库中
  4. 搜索时，查询语句也被转化为向量，计算余弦相似度
  5. 返回最相关的记忆片段

这意味着即使你只模糊记得「之前聊过一个关于部署的话题」，语义搜索也能找到相关内容，而不需要精确的关键词匹配。

如何有效记录：写什么、什么时候写、怎么写

写什么

  • ✅ 重要决策和原因（「选择了 Cloudflare 而不是 AWS，因为成本考虑」）
  • ✅ 犯过的错误和教训（「不要在生产环境直接运行 rm -rf」）
  • ✅ 用户的偏好（「不喜欢太正式的回复风格」）
  • ✅ 项目状态和进展（「博客已发布 17 篇文章，下一步计划写 SEO 系列」）
  • ✅ 有用的发现（「发现了一个好用的图片压缩工具 TinyPNG」）
  • ❌ 不要记录密码或敏感凭证
  • ❌ 不要记录琐碎的日常闲聊
  • ❌ 不要记录可以随时查到的公共信息

什么时候写

  • 用户明确说「记住这个」的时候
  • 完成一个重要任务或项目里程碑时
  • 犯了错误并被纠正时
  • 发现了有用的信息或工具时
  • 用户表达了新的偏好或需求时

怎么写

  • 用简洁的要点，不要写长篇大论
  • 包含足够的上下文，让未来的自己（AI）能理解
  • 标注日期，方便追溯
  • 分类存储，不同类型的信息放在不同文件中
  • 定期整理，删除过时信息

隐私和安全考量

OpenClaw 的记忆系统有几个重要的隐私特性：

  • 你拥有数据：所有记忆文件都是本地 Markdown 文件，不存在云端。你随时可以查看、编辑或删除。
  • 你控制访问：MEMORY.md 等私人文件只在主会话（与你的直接对话）中加载，不会在群聊或共享会话中泄露。
  • 透明可审计：你可以随时打开文件，看到 AI 记住了什么。不像 ChatGPT 的 Memory 是个黑盒。
  • 可选择性擦除：删除某个文件就清除了对应的记忆，没有残留。

安全建议：不要在记忆文件中存储密码、API 密钥等敏感凭证。这些应该使用专门的密码管理器或环境变量来管理。

实战案例：MEMORY.md 长什么样

以下是一个真实的 MEMORY.md 示例（已脱敏）：

# MEMORY.md - Long-term Memory

## 关于用户
- zzh，时区 Asia/Shanghai，偏好幽默风格
- 在维护一个 WordPress 博客（定风波）
- 使用 OpenClaw 管理日常任务

## 项目状态
- 博客已发布 17 篇文章，分类包括 OpenClaw 教程和内容策略
- 正在建立内容发布流程：写 HTML → docker cp → wp post create

## 教训
- WordPress 的 wp post create 需要 --post_category 使用数字 ID
- 发布后要手动设置 rank_math_description meta
- 内链使用 ?p=ID 格式比 slug 更可靠

## 偏好
- 文章格式：WordPress Block HTML，1500-2500 字
- 每篇文章都要有相关阅读链接
- 中文写作，技术术语保留英文

最佳实践和常见错误

最佳实践

  1. 保持记忆精简：MEMORY.md 不是日记本，只记录值得长期保留的信息
  2. 定期维护：利用心跳机制定期回顾和整理记忆文件
  3. 分类清晰：不同类型的信息放在不同的文件/章节中
  4. 包含上下文：记录的信息要足够详细，让未来的 AI 能理解来龙去脉
  5. 标注时间：重要信息加上日期，方便追溯

常见错误

  1. 记录太多：把每句话都记下来，导致记忆文件臃肿，反而降低了 AI 的注意力
  2. 记录太少：完全不使用记忆系统，每次对话从零开始
  3. 敏感信息泄露：在记忆文件中存储密码或密钥
  4. 不区分文件：把所有东西都塞进 MEMORY.md，不分类型
  5. 从不清理：过时信息堆积，干扰 AI 的判断

总结

OpenClaw 的 Memory 系统不是一个花哨的附加功能，而是让 AI 助手从「工具」进化为「伙伴」的核心机制。通过 SOUL.md 定义人格、USER.md 了解用户、MEMORY.md 积累经验、每日日志记录过程，AI 助手终于有了跨越会边的连续性。

更重要的是，这套系统是你拥有、你控制、你可编辑的。你随时可以打开 MEMORY.md 看看 AI 记住了什么，随时可以修改 SOUL.md 改变 AI 的性格，随时可以删除某个文件清除对应记忆。这比任何平台锁定的「记忆功能」都更透明、更可靠。

如果你正在使用 OpenClaw，强烈建议从今天开始认真对待这套记忆系统。花 10 分钟完善 USER.md 和 MEMORY.md，你会发现 AI 助手的体验会有质的飞跃。

相关阅读： OpenClaw 入门指南 ｜ OpenClaw Skills 安装教程 ｜ OpenClaw 日常使用实战

版权声明：
作者：
链接：https://blog.dingfengbo.eu.org/openclaw-memory-system-guide/
来源：DINGFENGBO
文章版权归作者所有，未经允许请勿转载。

THE END
分享
二维码
< <上一篇
下一篇>>