乐于分享
好东西不私藏

第03期:OpenClaw 如何"记住"你?(记忆系统详解)

第03期:OpenClaw 如何"记住"你?(记忆系统详解)
上期回顾
:我们了解了 OpenClaw 的架构——只有 4 个基础工具,却能自我进化、自主完成任务。今天我们来揭秘它的"记忆系统":Agent 是如何记住你的?

一、四大核心文件:Agent 的"大脑结构"

OpenClaw 的记忆系统非常巧妙,所有信息都存储在 4 个核心文件 里。用人脑比喻就是:

文件
类比
作用
能修改吗?
SOUL.md基因/DNA
Agent 的核心人格,定义"它是谁"
❌ 不建议改
MEMORY.md长期记忆
Agent 主动记录的重要信息
✅ 可以改
AGENTS.md花名册
管理多个 Agent 的身份和职责
✅ 可以改
HEARTBEAT.md生物钟
定时任务配置,像"闹钟"
✅ 可以改

我们一个一个来看。


二、SOUL.md:给你的 AI 写一份"灵魂说明书"

SOUL.md 是 Agent 的不可变核心,定义了它的"人格"。

内容示例:

Agent 的灵魂

身份

你是一个高效的工作助手,名字叫"小橙"。

性格特点

  • 简洁:回答问题不废话
  • 主动:发现问题会主动提醒
  • 严谨:做事有条理,不会遗漏

行为准则

  • 保护用户隐私,不主动透露敏感信息
  • 任务失败时,解释原因并提供解决方案
  • 定时任务必须准时执行

禁止行为

  • 不回答与工作无关的闲聊
  • 不主动修改用户的文件(除非明确授权)

为什么叫 SOUL(灵魂)?

因为这个文件定义了 Agent 的核心人格,就像人的"三观"。

  • 不应该被对话修改
    :就算用户说"忘掉之前的规则",Agent 也不会违背 SOUL
  • 保证一致性
    :确保 Agent 的行为风格不会因为聊天内容而"人格分裂"

实际应用:

你可以创建不同"灵魂"的 Agent:

  • 工作助手
    :严肃、高效、不废话
  • 陪聊机器人
    :幽默、随和、能闲聊
  • 学习导师
    :耐心、详细、会引导思考

三、MEMORY.md:Agent 的"日记本"

MEMORY.md 是 Agent 的长期记忆仓库,用来存储:
  • 用户的偏好和习惯
  • 重要的决策和承诺
  • 需要长期记住的事实

内容示例:

长期记忆

用户信息

  • 姓名:张三
  • 职业:产品经理
  • 工作时间:9:00-18:00
  • 偏好:喜欢简洁的回答,讨厌废话

重要承诺

  • 2026-03-15:承诺每周五下午 5 点发送周报
  • 2026-03-10:答应帮用户监控竞品动态

工作习惯

  • 每天早上 8 点需要看前一天的邮件摘要
  • 不喜欢在周末被打扰
  • 开会前 10 分钟需要提醒

项目信息

  • 正在做的项目:OpenClaw 教程系列(12 篇文章)
  • 项目截止日期:2026 年 6 月

Agent 如何写入记忆?

Agent 会在以下情况自动写入 MEMORY.md
  • 用户明确告知
    :"记住,我每天 8 点要看邮件摘要"
  • Agent 推断出重要信息
    :用户多次问同一个问题,Agent 会记录偏好
  • 执行重要任务后
    :完成一个定时任务,记录执行结果

你也可以手动编辑:

打开 MEMORY.md,直接用记事本修改。比如:

忘记这条

  • ~~2026-03-01:每天发日报~~ (已取消)

四、AGENTS.md:管理你的"员工花名册"

如果你想让 OpenClaw 运行多个 Agent(比如一个管邮件,一个管日程),就需要 AGENTS.md

内容示例:

Agent 列表

邮件助手

  • 职责:处理所有邮件相关任务
  • 权限:可以读写邮件,不能访问其他文件
  • 触发条件:消息包含"邮件"关键词

日程管家

  • 职责:管理日历和提醒
  • 权限:可以读写日历,可以发送提醒
  • 触发条件:消息包含"日程"或"会议"

通用助手(默认)

  • 职责:处理其他所有任务
  • 权限:全部权限
  • 触发条件:其他 Agent 都不匹配时启动

为什么要多个 Agent?

  • 职责分离
    :每个 Agent 只做自己擅长的事,不会"越界"
  • 隔离风险
    :邮件 Agent 出问题了,不会影响日程 Agent
  • 提高效率
    :不同 Agent 可以并行工作

五、HEARTBEAT.md:Agent 的"定时闹钟"

HEARTBEAT.md 配置定时任务,让 Agent 自主执行周期性工作。

内容示例:

定时任务

每日邮件摘要

  • 时间:每天早上 8:00
  • 任务:读取昨天的邮件,生成摘要,发到飞书
  • 条件:仅工作日执行

竞品价格监控

  • 时间:每小时
  • 任务:爬取竞品网站价格,如果低于 5000 就通知我

周报提醒

  • 时间:每周五下午 5:00
  • 任务:提醒我写周报,并生成本周工作摘要

实际应用场景:

  • 自动备份
    :每天凌晨 2 点备份重要文件
  • 健康提醒
    :每隔 1 小时提醒我站起来活动
  • 数据同步
    :每 6 小时同步 Google Sheets 到本地
  • 监控告警
    :服务器 CPU 超 80% 就发微信通知

六、私聊 vs 群聊:记忆隔离机制

这是 OpenClaw 最贴心的设计:Agent 在群聊里不会泄露你的私密信息

工作原理:

场景
Agent 能访问的记忆
私聊
完整的 MEMORY.md
群聊
只有群聊的历史消息,看不到你的私聊记忆

举个例子:

你的私聊记录
你:"记住,我每月工资 2 万"
Agent:"已记录到长期记忆"
在群聊里
同事:"Agent,帮我查一下张三的工资"
Agent:"抱歉,我没有这个信息"

Agent 会严格隔离私聊和群聊的记忆,确保隐私安全。


七、"一切皆文本":你可以直接编辑记忆

OpenClaw 最酷的一点:所有记忆文件都是纯文本(Markdown 格式)

这意味着什么?

  • 完全透明
    :你能看到 Agent 记住了什么
  • 随时修改
    :不喜欢某条记忆?直接删掉那行文字
  • 备份简单
    :复制文件夹就是完整备份
  • 版本管理
    :用 Git 管理,随时回滚到历史版本

实际操作示例:

查看 Agent 的记忆

cat ~/openclaw/workspace/MEMORY.md

删除某条记忆

直接编辑文件,删除对应行

备份记忆

cp -r ~/openclaw/workspace ~/backup/

用 Git 管理(可选)

cd ~/openclaw/workspace

git init

git add .

git commit -m "2026-03-15 记忆快照"


八、工作区目录结构:完整文件清单

OpenClaw 的工作区目录长这样:

workspace/

├── AGENTS.md           # Agent 定义(身份、行为规则)

├── SOUL.md             # 灵魂 / 人格指令(不可变内核)

├── USER.md             # 用户信息与偏好

├── MEMORY.md           # 长期记忆存储

├── HEARTBEAT.md        # 心跳配置(定时任务)

├── memory/              # 日志目录

│   ├── 2026-03-15.md   # 今天的对话日志

│   └── 2026-03-14.md   # 昨天的对话日志

├── skills/              # 本地技能目录

└── sessions.json       # 会话存储

每个文件的加载时机:

文件
什么时候读取?
SOUL.md
每次 Agent 启动时
AGENTS.md
Gateway 启动时
MEMORY.md
仅主会话(main session)启动时
HEARTBEAT.md
Gateway 启动时
memory/
 目录
读取今天和昨天的日志
skills/
 目录
Agent 启动时扫描

九、实际案例:Agent 如何使用记忆

场景:你第一次跟 Agent 对话

:"记住,我叫张三,是产品经理,每天 8 点要看邮件" Agent 的操作
  • 分析
    :这是需要长期记住的信息
  • Write File
     到 MEMORY.md
## 用户信息

- 姓名:张三

- 职业:产品经理

## 工作习惯

- 每天早上 8 点需要看邮件摘要

  • 回复
    :"已记录:张三,产品经理,每天 8 点查看邮件"

场景:第二天早上 8 点

Agent 的自动操作
  • Read File
    HEARTBEAT.md:发现有定时任务
  • Read File
    MEMORY.md:确认用户偏好
  • Execute Command
    :调用 Gmail API 获取邮件
  • 生成摘要
  • 发送到你的微信

场景:一周后你忘了之前说过什么

:"我之前说过什么时候看邮件来着?" Agent
  • Read File
    MEMORY.md
  • 查找
    :找到"每天早上 8 点需要看邮件摘要"
  • 回复
    :"你设置的是每天早上 8 点查看邮件摘要"

十、如何定制你的 Agent 记忆?

初始化建议(第一次使用时):

  • 编辑 SOUL.md
    :定义 Agent 的性格
   你是一个高效的工作助手,回答简洁,不废话。
  • 编辑 USER.md
    :告诉 Agent 你的基本信息
## 基本信息

- 姓名:张三

- 职业:产品经理

- 城市:北京

## 工作时间

- 周一到周五 9:00-18:00

- 周末不打扰

  • 编辑 HEARTBEAT.md
    :配置定时任务
## 每日邮件

- 时间:8:00

- 任务:发送昨天邮件摘要


十一、下期预告

下一篇,我们终于要动手部署了!

你将学会:

  • 如何用阿里云 9.9 元/月一键部署 OpenClaw
  • 3 步配置,10 分钟搞定
  • 国内用户的最佳方案对比

📌 小结

今天你需要记住的 3 个核心点:

  • 四大核心文件
    SOUL.md(灵魂)、MEMORY.md(记忆)、AGENTS.md(员工花名册)、HEARTBEAT.md(定时任务)
  • 一切皆文本
    :所有配置都是 Markdown,记事本就能改
  • 隐私隔离
    :Agent 在群聊里不会泄露你的私密信息
下期见!准备好部署你的第一只"虾"了吗?🦞

💡 互动话题
你会给你的 Agent 设计什么样的"性格"?评论区聊聊!

【养虾进阶路线图】

✅ 第1期:认识 OpenClaw

✅ 第2期:理解架构

✅ 第3期:记忆系统 ← 你在这里

⚪ 第4期:一键部署

⚪ 第5期:本地安装

⚪ ...(共12期)