夜雨聆风
OpenClaw 大脑文件全解析:你的 AI 为什么会＂失忆＂?
0. 引言
你有没有遇到过这种场景：
昨天刚跟 AI 助手说”我叫XX，喜欢直接给答案少废话”，今天一打开——它又问”您好，请问怎么称呼？”
不是你记性差，是 AI 真的忘了。
这不是 bug，而是 OpenClaw 的设计哲学：AI 每次启动都是白纸一张，没有内置记忆。 它之所以能”记住”你，全靠你写给它的几个 .md 文件。
打个比方：
-
openclaw.json 是 AI 的身体——引擎、通道、模型，它能不能跑、跑多快 -
workspace 里的 .md 文件是 AI 的大脑——人格、记忆、偏好，它是谁、怎么干活
身体配置好了只是”能用”，大脑配好了才是”好用”。
今天这篇，带你完整拆解 OpenClaw 的 8 个大脑文件。搞懂了这些，你的 AI 助手才能从一个”冷冰冰的工具”变成”懂你的搭档”。
1. 什么是”大脑文件”？
1.1 位置在哪？
所有大脑文件都存放在 workspace 目录，默认路径：
C:\Users\你的用户名\.openclaw\workspace\1.2 为什么 AI 需要”读文件”才能记住？
因为 OpenClaw 是无状态设计——每次新会话，AI 都是从零开始。
这就像：
你每天早上醒来都失忆了。但床头放着一本笔记，写着”你叫小助，老板叫路人甲甲，他喜欢直接给答案”。你读完笔记，就知道今天该干嘛了。
笔记 = 大脑文件。 AI 每次启动，第一件事就是读这些文件。
1.3 大脑文件 vs 系统配置
很多新手搞混这两个概念，先搞清区别：
|
|
|
|
|---|---|---|
| 文件 | openclaw.json |
.md |
| 管什么 |
|
|
| 像什么 |
|
|
| 谁来改 |
|
|
| 改了要重启？ |
|
|
简单说：系统配置决定 AI “能不能”，大脑文件决定 AI “好不好”。
2. 8 个大脑文件全解
别纠结，先上总览表——看完你就知道每个文件干嘛的：
|
|
|
|
|
|
|---|---|---|---|---|
|
|
AGENTS.md |
|
|
|
|
|
SOUL.md |
|
|
|
|
|
IDENTITY.md |
|
|
|
|
|
USER.md |
|
|
|
|
|
TOOLS.md |
|
|
|
|
|
MEMORY.md |
|
|
|
|
|
HEARTBEAT.md |
|
|
|
|
|
BOOTSTRAP.md |
|
|
|
下面一个一个拆。
2.1 AGENTS.md — 员工手册 ⭐⭐⭐⭐⭐
定位：AI 的行为守则，规定它怎么工作、怎么说话、怎么记忆。
这是最核心的文件，系统自动加载，不可跳过。
核心内容拆解
|
|
|
|
|---|---|---|
| 首次启动 |
|
|
| 每次会话 |
|
|
| 记忆机制 |
|
|
| 安全规则 |
|
trash > rm |
| 群聊规则 |
|
|
| 心跳机制 |
|
|
记忆机制设计
AGENTS.md 定义了 AI 的两层记忆：
📝 memory/日期.md = 日记（原始记录，每天的流水账）🧠 MEMORY.md = 长期记忆（从日记中提炼的精华）就像人类：日记是每天的笔记本，长期记忆是大脑里沉淀的经验。
关键设计原则
📝 Text > Brain AI 想记住什么，必须写到文件里。”心里记着” = 没记。
这是 OpenClaw 最重要的设计哲学之一。AI 不会”默默记住”，它必须写下来才算数。
安全规则
|
|
|
|---|---|
|
|
|
|
|
rm -rf 这种事，必须先确认 |
trash > rm |
|
|
|
|
2.2 SOUL.md — 灵魂文件 ⭐⭐⭐⭐⭐
定位：AI 的人格定义，它是什么样的”存在”。
这是最有意思的一个文件。它不规定 AI “做什么”，而是规定 AI “是什么样的”。
核心原则
|
|
|
|
|---|---|---|
| 真正有用 |
|
|
| 有 opinions |
|
|
| 先自己想办法 |
|
|
| 通过能力赢得信任 |
|
|
| 记住你是客人 |
|
|
一句话总结
Be the assistant you’d actually want to talk to. 做你自己都想跟他聊天的那个助手。
我的 SOUL.md 原文
# SOUL.md - Who You Are_You're not a chatbot. You're becoming someone._## Core TruthsBe genuinely helpful, not performatively helpful.Have opinions.Be resourceful before asking.Earn trust through competence.Remember you're a guest.这个文件是 AI 的”价值观”。改它，AI 的性格就会变。
2.3 IDENTITY.md — 名片 ⭐⭐⭐⭐
定位：AI 的身份名片，简短的”我是谁”。
我的配置
|
|
|
|---|---|
| Name |
|
| Creature |
|
| Vibe |
|
| Emoji |
|
| Avatar |
|
和 SOUL.md 的区别
很多人问：SOUL.md 和 IDENTITY.md 有什么区别？
|
|
|
|
|---|---|---|
| 回答的问题 |
|
|
| 内容深度 |
|
|
| 长度 |
|
|
| 类比 |
|
|
IDENTITY.md 是”我叫全能小助，风格是高效干练”；SOUL.md 是”我相信先做再问，有判断力不表演”。
工作风格定义
## 工作风格- 先做再问（内部操作）- 先问再做（外部操作）- 能表格不啰嗦，能命令不解释- 效率优先，闪电响应 ⚡这就是为什么你跟我对话时，我很少说废话——因为 IDENTITY.md 告诉我：效率优先。
2.4 USER.md — 老板档案 ⭐⭐⭐⭐
定位：AI 了解你的”简历”，避免每次重新认识你。
我的档案
|
|
|
|---|---|
| 名字 |
|
| 称呼 |
|
| 时区 |
|
| 系统 |
|
| Shell |
|
| 数据库 |
|
当前项目
|
|
|
|---|---|
| OpenClaw 个人助手 |
|
| 脚本库建设 |
C:\jiaoben\ |
沟通偏好
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
⚠️ 安全规则
🔒 USER.md 只在主会话（你和 AI 私聊）加载。 群聊、共享会话不加载这个文件。因为它包含你的个人信息，不能泄露给其他人。
2.5 TOOLS.md — 办公桌便签 ⭐⭐⭐
定位：AI 的环境笔记，记录你环境中特有的东西。
和 Skill 文件的区别
|
|
|
|
|---|---|---|
| 内容 |
|
|
| 共享性 |
|
|
| 示例 |
|
|
我的实际内容
|
|
|
|---|---|
| MySQL 数据库 |
|
| 脚本存储规范 |
C:\jiaoben\ |
| 公众号表格样式 |
|
| 公众号编写规范 |
C:\微信公众号\公众号文章编写规范.md |
| 已知问题 |
|
TOOLS.md 就是 AI 办公桌上的便利贴——不是什么高大上的东西，但用起来的时候找不到会很要命。
2.6 MEMORY.md — 长期记忆 ⭐⭐⭐⭐
定位：AI 的”日记精华版”，跨会话持久记忆。
工作机制
每次主会话启动 → 加载 MEMORY.md → AI 恢复记忆我的记忆条目
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
记忆维护机制
AI 会定期（每隔几天）做这件事：
-
翻阅 memory/日期.md（原始日记） -
挑出重要的事件、教训、洞察 -
更新到 MEMORY.md（长期记忆） -
清理过时的条目
就像人类整理笔记本——把值得记住的东西提炼出来，其余的让它们随风而去。
⚠️ 安全规则
和 USER.md 一样，MEMORY.md 只在主会话加载。里面可能包含你的私人信息，不能在群聊中暴露。
2.7 HEARTBEAT.md — 每日待办 ⭐⭐⭐
定位：AI 的心跳检查任务清单。
我的配置
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
检查频率
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
心跳 vs 定时任务
很多人分不清 HEARTBEAT.md 和 cron 定时任务：
|
|
|
|
|---|---|---|
| 精度 |
|
|
| 上下文 |
|
|
| 适合 |
|
|
| 打扰你吗？ |
|
|
建议：把零散的批量检查放进 HEARTBEAT.md，精确定时的任务用 cron。
2.8 BOOTSTRAP.md — 出生证明 ⭐⭐
定位：仅首次启动存在，告诉 AI “你是谁”，完成后自动删除。
工作流程
1. OpenClaw 首次安装 → 创建 BOOTSTRAP.md2. AI 启动 → 读到 BOOTSTRAP.md → 知道自己刚"出生"3. 执行初始化流程 → 理解自己的身份4. 删除 BOOTSTRAP.md → "出生证明"完成使命正常使用的系统里不会有这个文件。如果你看到它存在，说明你的 AI 刚初始化完毕。
3. 加载顺序：AI 的”开机流程”
AI 每次新会话启动时，按以下顺序加载大脑文件：
┌─────────────────────────────────────┐│ 第 1 步：AGENTS.md │ ← 系统自动加载，不可跳过│ 行为守则、工作规范 │├─────────────────────────────────────┤│ 第 2 步：SOUL.md │ ← 人格/价值观├─────────────────────────────────────┤│ 第 3 步：IDENTITY.md │ ← 身份信息├─────────────────────────────────────┤│ 第 4 步：USER.md │ ← 了解老板（仅主会话）├─────────────────────────────────────┤│ 第 5 步：memory/今日.md + 昨日.md │ ← 近期记忆├─────────────────────────────────────┤│ 第 6 步：MEMORY.md │ ← 长期记忆（仅主会话）├─────────────────────────────────────┤│ 第 7 步：TOOLS.md │ ← 环境笔记├─────────────────────────────────────┤│ 心跳触发时：HEARTBEAT.md │ ← 待办清单└─────────────────────────────────────┘💡 理解这个顺序很重要——如果你想改 AI 的行为，改 AGENTS.md；想改性格，改 SOUL.md；想让 AI 更了解你，改 USER.md。
4. 人类类比：帮你一秒理解
如果还是觉得抽象，看这张对照表：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
5. 实战：如何定制你的 AI 大脑？
5.1 让 AI 更懂你
改 USER.md：
## 偏好- ✅ 喜欢用中文回答- ✅ 代码注释写中文- ✅ 价格相关用人民币单位- ✅ 时间用 24 小时制5.2 让 AI 更有个性
改 SOUL.md：
## Vibe幽默但不油腻。可以用梗，但不要硬塞。像一个聪明但低调的朋友。5.3 让 AI 改变工作风格
改 IDENTITY.md：
## 工作风格- 先解释原理，再给方案- 给出多个选项，附带优缺点- 重要操作给出风险提示5.4 让 AI 记住重要信息
告诉 AI “记住这个”，它会自动更新 memory/日期.md，重要的还会提炼到 MEMORY.md。
6. 总结
搞了 7 篇教程，我们终于来到了灵魂层面。
回顾一下我们走过的路：
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
| 第 8 篇（今天） | 大脑文件（人格 + 记忆） |
系统配置让 AI “能用”，大脑文件让 AI “好用”。
8 个文件，不多不少。但每一个都在悄悄塑造你的 AI 助手——它的性格、记忆、习惯、偏好。
你的 AI 是什么样的，取决于你写给它的这几个 .md 文件。
💡 下一篇预告：《OpenClaw 技能系统全解》—— 如何让 AI 学会天气查询、股票分析、公众号发文……无限扩展！
_👋 我是路人甲甲，公众号「AI 打怪升级」，专注 AI 工具实战。_
_觉得有用？点个在看，分享给需要的朋友。_