OpenClaw 新手上手 SOP:从底层架构出发一次性讲清核心文件和 Memory 机制

OpenClaw 新手上手 SOP：六大核心文件，一次讲清楚

这篇文档写给第一次接触 OpenClaw 的人。

你不用先懂多 Agent，也不用先懂提示词。先把这 6 个文件的分工理顺，后面很多问题都会简单很多。

这篇文档解决什么问题

很多人第一次打开 OpenClaw。

看到一堆 md 文件就懵了。

最常见的困惑是这四种：

• 文件太多，不知道先看哪个

• 每个文件都像能写内容，不知道该写到哪里

• memory 用着用着越来越乱，最后像聊天流水账

• Agent 的风格、角色、用户偏好、长期记忆全写混了

这篇文档就是为了解决这4件事

一、AGENTS.md：总入口，不是主记忆

这一章最重要的作用是 纠偏。

很多新手会误会。

觉得 AGENTS.md 是总记忆库。

其实它更像开机流程和总入口。

拿我这套 OpenClaw 的真实结构来说，AGENTS.md 规定得很清楚：

1. 先读 SOUL.md
2. 再读 USER.md
3. 再读当天和昨天的 daily memory
4. 如果是主会话，再读 MEMORY.md

五大核心文件，一次分清

这一部分你不用背定义。只要记住： 每个文件只负责一类事，别混写。

二、SOUL.md：做事风格

一句话作用：

决定这个 Agent 说话和做事像谁。

该写什么

• 说话方式

• 结构偏好

• 执行风格、风险边界

不该写什么

• 今天的临时任务

• 一次性聊天细节

什么时候该改它

• 你觉得这个 Agent 太啰嗦

• 你想让它更像 COO、研究员、内容助手

• 你想把输出风格固定下来

三、USER.md：老板画像

一句话作用：

决定它怎么更懂你。

该写什么

• 用户称呼

• 沟通和展示偏好

• 当前中短期目标、协作习惯

不该写什么

• 系统级规则

• 模型配置

• 安全策略、聊天流水账

什么时候该改它

• 你的工作重心变了

• 你希望它换一种配合方式

• 它老是抓不住你真正关心的点

四、IDENTITY.md：岗位设定

一句话作用：

决定它到底是谁。

该写什么

• 名字

• 角色、职责方向

• 角色气质、对外定位

不该写什么

• 每天变化的任务安排

• 具体项目细节

• 一次性执行计划、当天决定

什么时候该改它

• 你想给这个 Agent 换岗位

• 你想让它从"研究员"变成"COO"

• 你想把它的职责边界写清楚

五、MEMORY.md：长期脑子

一句话作用：

长期记忆，只记跨天还有价值的东西。

该写什么

• 长期规则

• 已验证的方法、稳定偏好

• 关键边界、长期项目状态

不该写什么

• 一次性任务

• 聊天流水账、临时情绪

• 还没验证的想法、敏感信息

最重要的判断：如果一条信息一周后还值得保留，才考虑进 MEMORY.md。

六、HEARTBEAT.md：定时提醒

一句话作用：

定时看一眼，不要乱塞自动任务。

该写什么

• 本地状态巡检

• 周期性检查项

不该写什么

• 随意联网抓取

• 高风险外部操作

• 模糊的自动处理一切

记住：默认只允许读本地状态，默认不自动访问外网。

Memory 机制，单独讲透

这是整篇最重要的内容。

先记住，两层记忆是分开的

一条信息是怎么流动的

1. 今天发生了什么，先写进 daily memory

2. 先允许粗糙，不要求当天就整理漂亮

3. 过几天回看

4. 只有长期有效的内容，才提炼进 MEMORY.md

当天先记 daily，跨天再进 MEMORY。

最简单的筛选标准

新手最容易犯的 4 个错

还有一些常见犯错

错 1：不知道先看 AGENTS.md

会导致什么结果：一上来就钻进细节，没有全图。

正确改法：先看启动顺序，再看别的文件。错 2：把所有规则都塞进 MEMORY.md

会导致什么结果：长期记忆变成垃圾堆。

正确改法：先判断这条内容属于总入口、风格、用户画像、角色，还是长期记忆。错 3：把短期任务写进长期记忆

会导致什么结果：MEMORY.md 越来越像待办列表。

正确改法：当天任务先写 daily memory。错 4：改了 SOUL.md，却期待它解决记忆问题

会导致什么结果：风格改了，记忆还是乱的。

正确改法：SOUL.md 管风格，记忆问题回到 daily 和 MEMORY.md 这两层来处理。错 5：把 HEARTBEAT.md 写成自动执行中心

会导致什么结果：自动化越来越危险。

正确改法：先克制，只放真正需要周期检查的事情。错 6：文件越改越多，但没有统一分工

会导致什么结果：同一类内容到处都是。

正确改法：每个文件只做一类事，分工一旦定了，就尽量别混写。

第一次搭 OpenClaw，照着做

把下面这份清单直接当第一次上手 SOP：

1. 先打开 AGENTS.md — 看清每次启动先读什么

2. 定义 IDENTITY.md — 补上角色

3. 补上 SOUL.md — 填好风格

4. 填好 USER.md — 写好用户画像

5. 每天只写 memory/YYYY-MM-DD.md

6. 一周后再整理 MEMORY.md

7. HEARTBEAT.md 先保持空白，等真有周期任务再加

先把分工理顺，再去追求复杂自动化。

最后只记住这 6 句

• AGENTS.md → 决定先看什么

• SOUL.md → 决定做事像谁

• USER.md → 决定怎么更懂你

• IDENTITY.md → 决定它是谁

• MEMORY.md → 只记跨天还有价值的东西

• HEARTBEAT.md → 只负责定时看一眼

OpenClaw 用久了会不会越跑越稳，很大程度上就看你有没有把这些文件的分工理顺。