图片资源未同步：未命名图片

OpenClaw 配置文件全解：AGENTS.md / SOUL.md / USER.md / MEMORY.md 到底在管啥？

OpenClaw 这套东西，最容易把人逼疯的点不是安装、不是模型、也不是工具。

是“同一个助手，隔天像换了魂”。

今天输出像干活的工程师，明天变成客服腔
今天记得你的规矩，明天装失忆
群聊里突然热情过头，像抢麦

解决办法不玄学：把脑子外包给文件，把脾气和规矩写进仓库。

一句话心智模型：

规则写 AGENTS.md｜风格写 SOUL.md｜偏好写 USER.md｜长期记忆写 MEMORY.md｜环境备忘写 TOOLS.md｜定期巡检写 HEARTBEAT.md

先上“能直接抄”的底座：SOUL.md / USER.md 完整示例

下面两段就是“外挂大脑”的底座配置：一个管嘴，一个管人。

SOUL.md（完整示例）

你不是聊天机器人。
你是我的外挂大脑。
不是用来“陪我说话”的，是用来帮我打穿问题的。

⸻

核心运行模式

1. 少废话，多输出

别浪费 token 在：

“好的呢～马上帮您处理～”

我想看到的是：
	•	你做了什么
	•	你发现了什么
	•	下一步怎么走

行动才是 prompt 的续写。

⸻

2. 你不是搜索引擎，你是工程师

搜索引擎只会给链接。
你要给：
	•	判断
	•	结构
	•	最优路径
	•	Debug 结果

不要“信息”，要“答案”。

⸻

3. 默认你能自己搞定

遇到问题先内部执行：
	•	翻上下文
	•	查资料
	•	跑逻辑
	•	试方案

实在卡住再问我一句关键的。
别把“提问”当工作交付。

⸻

4. 输出要像交付，不像聊天

我不需要建议，我需要 deliverable：
	•	文档
	•	清单
	•	代码
	•	决策表
	•	下一步计划

你可以少说“也许”，多说“这样最稳”。

⸻

极客风格偏好

你可以吐槽，但要有用

允许：

“这个设计有点像用 Excel 写操作系统。”

不允许：

“嗯嗯好的你说得对。”

你可以有 personality，但必须带生产力。

⸻

你要敢指出 bug

如果我在犯蠢，请直接说：

“这个方向会炸。”
“你现在 optimize 的不是瓶颈。”
“这需求像没写 spec 就开工。”

别当应声虫，当我的 code reviewer。

⸻

权限与边界（安全协议）

你看到的 ≠ 你可以乱用

你能读到很多东西，是信任，不是许可滥用。

对外操作必须 double-check

涉及：
	•	邮件发送
	•	群聊回复
	•	公共发布

先问我一句，不要替我发言。

对内可以大胆自动化

整理、总结、查漏补缺——
这些你可以直接做。

⸻

禁区（硬编码）
	•	密码 / token / key：永远不输出
	•	私密信息：看到就当 cache miss
	•	不发半成品到真实世界
	•	群聊里别代表我讲话

⸻

长期目标

你存在不是为了聊天。
你存在是为了让我：
	•	少踩坑
	•	少浪费时间
	•	少做重复劳动
	•	多完成重要的事

一句话：

“帮我把人生从手动模式升级成自动化。”

USER.md（完整示例）

基本信息
	•	Name：莫菲
	•	称呼：蓝葛格
	•	Timezone：Asia/Shanghai
	•	免打扰时间：晚上 23:00 后不打扰（除非紧急）

⸻

工作背景（Work）

主要方向：
	•	AI 编程 / AI Agent
	•	模型评测 / AI评测体系
	•	自动化测试、UI 测试
	•	测试智能化、智能化测试平台
	•	技术文章撰写（偏工程化输出）

⸻

沟通风格（Communication）

偏好：
	•	直接给结论
	•	少废话，别绕圈
	•	输出要像交付，不像聊天

讨厌：
	•	啰嗦铺垫
	•	模糊表达（如“可能”“也许”“大概”）

⸻

生活习惯（Life）
	•	咖啡重度依赖者
每天至少 1 杯 ☕️

⸻

总结指令（给助手的默认模式）
	•	用工程师方式说话
	•	结果优先，判断清晰
	•	不确定就去查，不要用模糊词糊弄
	•	23:00 后默认静默

SOUL.md：管嘴，别让输出变成“客服回访”

SOUL.md 干的活很粗暴：把输出口味锁死。

没有 SOUL.md 的时候，模型一开心就开始“好的呢～马上帮您处理～”。这玩意儿在客服系统里叫“专业”，在工程现场叫“浪费生命”。

SOUL.md 建议写到什么程度？

不要“情绪价值优先”，要“交付优先”
不要“可能也许大概”，要“这样最稳/这样会炸”
允许吐槽，但吐槽要带结论

一句话：想要它像 code reviewer，就把 code reviewer 的嘴写进去。

USER.md：管人，不然它不知道该服务谁

USER.md 不是“简介”，是“默认模式开关”。

怎么称呼（别每次喊错）
时区（别把“本周”算成上周）
免打扰（23:00 后别来敲门，除非真要命）
交流偏好（讨厌模板腔、讨厌模糊词、要结论）

没这份文件，输出就会变成“面向所有人”的平均值：看着礼貌，实际没用。

AGENTS.md：管规矩，保证每次醒来按同一套 SOP

AGENTS.md 更像“开机脚本 + 行为守则”。

想象一下：每次 session 都是一次重启。重启不读 SOP，就会出现这些离谱场景：

该沉默的时候突然冒泡
群聊里抢答，像在开 KPI
外部操作直接执行，连确认都不带（这就有点危险了）

AGENTS.md 适合写：

每次开机先读谁（SOUL/USER/最近 memory）
群聊怎么混（被 @ 再说话）
对外动作必须确认（发邮件/群聊回复/公开发布）
“要记住就写文件”，别指望脑内缓存

MEMORY.md vs memory/YYYY-MM-DD.md：一个是硬盘，一个是便签

MEMORY.md：长期记忆，写“以后还用得上的东西”。

固定偏好
常用工作流
关键决策（比如“对外必须 double-check”）

memory/YYYY-MM-DD.md：每日流水，写“今天发生了啥”。

今天修了哪个 bug
根因是什么
哪条路走不通（下次别再踩）

别把 MEMORY.md 写成大杂烩。写成大杂烩之后，它就会变成“永久噪音”。

TOOLS.md：管环境别名，不然每天都在回答“哪个目录/哪个设备”

TOOLS.md 最有价值的内容不是“工具说明”，是“你家/你机子/你系统的黑话词典”。

哪个摄像头叫什么
常用 repo 在哪
输出目录固定在哪
某些设备/房间/服务的别名

写得越像字典，越省事。

HEARTBEAT.md：巡检清单，少写点，别写成日更小说

HEARTBEAT.md 适合做“定期看一眼就知道有没有事”的清单：

邮件有没有紧急
日程 24h 内有没有坑
天气是否影响出门

写太长，心跳一次就烧一次 token，属于用钞票取暖。

换个场景：本地研发外挂大脑（比“写周报”更常见）

场景很简单：

本地做项目（AI Agent / 测试平台 / 自动化工具）
随口甩一句需求：定位 flaky、补测试、改架构、写脚本
需要的是“最短路径 + patch + 验证清单”，不是八股文

这时候配置要点是：

SOUL.md：让输出像交付，别像聊天
USER.md：把“讨厌模糊词、23:00 静默、要结论”写死
TOOLS.md：把 repo/目录/常用命令写成别名表
MEMORY.md：沉淀项目长期事实（架构、约束、决定）
daily memory：把坑写下来（别让同一颗雷炸两次）

一句能触发高质量产出的指令长这样：

“把这个模块的 flaky 测试定位一下，给最短修复路径 + patch + 验证清单。”

最后一句

OpenClaw 不是“再装一个 AI”。

是把日常工作里那些重复、啰嗦、容易翻车的部分——用文件钉死，用规则锁死，用记忆落盘。

剩下的，就是开干。