【技术向】Openclaw Agent 配置文件拆解

这几天 Openclaw 真的是太火炎焱了，

甚至很多官媒也下场报道了。。。（本来有一张央视的图，放了不给过审⬇）

前几天腾讯深圳总部的底下，腾讯云官方做活动，

可以免费帮忙部署 Openclaw ，甚至有的没带电脑就来了。。。

到目前为止，

Openclaw 的部署教程全网已经铺天盖地了，付费部署也很多。

所以本文不讲这些，因为拉不开差距。

本文是一篇技术向文章，来带大家理解一下Openclaw中，

最重要的8个Agent配置文件作用原理，架构，以及优先级。

了解原理以后，你能更好地调教你的小龙虾🦞。

如果你的龙虾经常失忆，也请看这篇文章，下文会给出解决方法。

首先咱先进入Openclaw 的网关Dashboard。

这个是正常安装以后都可以进入的，输入指令：

openclaw gateway start

喜欢敲命令的人可以用命令行控制一切：

openclaw gateway 启动网关
openclaw agent 直接调用 Agent
openclaw channels login 配对 WhatsApp/Signal
openclaw message send 编程发消息
openclaw doctor 跑健康检查
openclaw onboard 引导式初始设置

Gateway 网关启动后，打开浏览器控制界面。

本地默认地址：http://127.0.0.1:18789/

然后点击左侧的【代理】

可以看到一个 Agent 里面有 8 个 Markdown 核心配置文件，

如果你是零代码基础的小白，

那么你能看懂的，可能有且只有这 8 个文件以及 Skill 还有需要手动配置的 env.文件了。

在你了解以后，你就可以用口述的方式让它进行修改了。（当然，为了最好的效果，肯定是需要多轮迭代的。）

我按照重要程度来讲，先来说说这几个文件的中文意思：

MEMORY——记忆

AGENTS——代理

IDENTITY——人格

SOUL——灵魂

TOOLS——工具

USER——用户

HEARTBEAT——心跳

BOOTSTRAP——脚本

个人认为，最重要的文件就是 AGENTS，SOUL，IDENTITY 这三个文件了。

好！问题来了！！

如果某天你在 Openclaw 上和你的 Agent 聊了一天，

过了一天你重启了网关，请问该 Agent 的记忆储存在哪！！

聪明的你可能会觉得，储存在MEMORY.md文件中。

但并不是这样。

MEMORY.md 是跨会话（Cross-session）积累知识的目录索引。

只是初始上下文，而不是真正的“记忆”或强制约束。

1.它的本质只是一段会被遗忘的初始上下文

官方（无论是 Claude Code 还是类似的 Agent 框架）将其设计为跨会话积累知识的地方，每次对话开始时会自动加载到 System Prompt 中。

随着对话越来越长、任务越来越复杂，AI 对这份文件的注意力权重会不断下降。

当它在执行一个多步骤工作流的某个具体环节时，注意力集中在当前任务结构上，不会主动回头去翻一个离当前执行点很远的参考文档。

如果想恢复上下文记忆，

应该去找 Session 文件，个人理解有点像记忆碎片。

Sessions.json是主会话的配置文件。它的唯一作用是指针，永远指向当前正在使用的 jsonl 文件。

jsonl文件是存储完整聊天记录的实体数据文件。

系统每次对话都会读取它作为上下文。为了避免文件过大，系统会周期性地压缩并总结旧的 jsonl 文件，然后新建一个 jsonl 文件继续记录。

MEMORY.md这是存储极少数高价值信息的概要文件。

系统极少自动向内写入内容，只有在你明确下达指令，或者系统判断某条信息具有特殊保留价值时才会更新。你也可以随时手动对其进行编辑。

所以恢复记忆的方式：

打开你的用户文件夹。
进入 .openclaw/agents/main/sessions/ 目录。
找到 sessions.json 文件。
将里面 sessionFile 字段的值，修改为该目录下某个特定的 jsonl 文件名。完成这一步即可恢复对应的历史记录。

2.SOUL.md和IDENTITY.md的区别

先来看看具体案例，这是@长歌大佬写的乔布斯 Agent，

SOUL.md和 IDENTITY.md都是中文，你应该可以读懂其中的内容，但是可能还是没太搞清楚的他们的区别。

SOUL.md

权威定义：根据官方架构解析，这是 Agent 的性格基座
作用：定义 AI 说话的语气、态度和口吻。比如你可以把它配置成“极其简练的极客”、“温柔的助理”或“暴躁老哥”。它决定了 AI 回复你的“文风”。

IDENTITY.md

权威定义：企业级应用中极度看重的文件，用于“结构化描述智能体是谁、能做什么、边界何在”。
作用：这是 AI 的“岗位职责说明书”。里面规定了它的权限上限（例如：你只能读取 /Documents 目录，绝对不能执行 rm -rf 甚至删除操作）。

再转述大佬的比喻，来方便你理解：

有一个外交官员，每天在五角大楼为特朗普公开发言。
但内里其实他是个同性恋，还是个抑郁症患者。
五角大楼发言人是他的 IDENTITY，LGPTQ玉玉症人群就是他的SOUL。
SOUL决定他实际上灵魂上是什么，IDENTITY决定他怎么装人，相当于是“你在外面装逼的时候别忘了撒泡尿照照自己是谁”

当我听完解释以后，真的醍醐灌顶，葫芦灌顶，鸡蛋灌饼。

我自己还没搞清楚自己的 Soul 和 Identity，Openclaw 创始人 Peter 居然已经把这玩意用在 AI 上了？？

3.AGENTS.md

这个单独来讲

AGENTS.md是权重最高的文件，定义了 AI 处理任务的底层逻辑和绝对不能违反的规则。可以把它理解为 AI 的《员工手册》。

咱继续拿乔布斯为例，看看它的AGENTS.md文件：

通过截图的内容，咱可以知道：AGENTS.md决定你的智能体如何思考、如何决策、如何与其他文件互动，以及如何采取行动。

大模型本身是无状态的一问一答，但 AGENTS.md 赋予了它一套严格的执行顺序，把它变成了一个自动运行的程序。
AI 该先看什么、后看什么，比如在 Every Session 板块中，
明确规定了 AI 每次醒来必须先读 SOUL.md（确认底层设定），
再读 MEMORY.mdbalabala....

还有在 Heartbeats 板块，它指导 AI 在后台定时唤醒时该执行什么代码，以及在没有新消息时必须保持沉默（HEARTBEAT_OK）。

我们在前面讨论过 MEMORY.md 很容易被 AI 遗忘或乱写。

AGENTS.md 就是用来解决这个问题的它教 AI 如何正确地读写记忆，在 Memory 板块，它明确规定了记忆分三层（会话、持久化、归档），并且给了严格的 Markdown 写入格式（必须包含“我的立场”、“核心分歧”、“攻击记录”等）。

写入红线：在 Safety 板块中，严格约束了 MEMORY.md “只追加，不回溯修改”，防止 AI 弄乱自己的记忆库。

4.HEARTBEAT心跳机制

HEARTBEAT.md（心跳与主动任务）：OpenClaw 支持后台定时唤醒（比如每 30 分钟一次）。
AI 唤醒后会静默读取这个文件，看看有没有需要主动去做的周期性任务。

"心跳本质上只是一个定时任务cron机制，cron是一种工程上面的定时器机制，作用就是按照固定时间出发一次行为。至于这个行为是什么，可以自己定义。只是这个机制对于agent来说是不可抗命令。
Openclaw 创始人Peter只是把一种不可取消的cron定义为了“心跳”，这个心跳如果没做任何动作，就会打一个叫做 HEARTBEAT_OK的消息，这个消息在openclaw内部，一般是不会发送到客户有感知的客户端的，比如不会发到********上，但你在它的TUI上能看到这个消息，也就是上文中gateway自带的那个网页后台。
跟定时任务的区别就是，用户自己定义的cron，比如你跟agent说，每半小时帮我去 X（推特）上看看马斯克有没有发新帖子，这个cron任务，agent自己有权利创建和取消，它能干预。
Peter自己也说了，这个功能一开始，是他希望Openclaw隔一段时间能自己做点什么，给他一点s、Surprise，但是LLM本身自己是不会主动做事的，所以他设计了一个叫“心跳”的机制，逼迫agent隔一段时间能够“主动”做点什么。
这个“主动”从人类的睡觉来看像是主动，但它依然是一种系统机制，并不是说LLM真的就会自主做什么。"

最后是三个我感觉相对不怎么重要的文件，统一解释吧：

USER.md（用户画像）
作用：因为 OpenClaw 是跨平台的（能同时接管你的 WhatsApp、微信、飞书、Discord），这个文件用来统一记录你是谁。包含你的工作偏好、时区、乃至你家人朋友的名字，让 AI 无论在哪个软件里理你，都像同一个老熟人。
BOOTSTRAP.md（初始化脚本）：通常只在 OpenClaw 第一次部署或创建新 Agent 时存在。它包含一次性的引导任务。初始化完成后，这个文件通常会被删除或废弃。
TOOLS.md
作用：AI 使用本地电脑工具的说明书。OpenClaw 拥有极高的本地权限（比如能操作终端、浏览器、读写文件），这里记录了特定 API 或本地脚本的调用规范，防止 AI 乱敲代码。