乐于分享
好东西不私藏

OpenClaw 从0到1实战剖析(02):先看懂这8个.md文件,它们分别是做什么的

OpenClaw 从0到1实战剖析(02):先看懂这8个.md文件,它们分别是做什么的

OpenClaw 从0到1实战剖析(02)

1. 先看懂这 8 个 .md 文件,它们分别是做什么的

上一篇我们讲了 OpenClaw 的整体思路。
这一篇先不讲复杂配置,先把最关键的一步做了:把核心 .md 文件看懂

因为你后面所有“定制化”能力,基本都落在这些文件里。


2. 一、先建立一个最小认知

OpenClaw 不是只靠一句 Prompt 跑起来的。
它是“规则 + 记忆 + 执行”组合系统,而这些 .md 文件就是系统的配置层。

你可以把它们分成四类:

人格与身份:让 Agent 表现稳定
用户与环境:让 Agent 知道在帮谁、能用什么
运行与调度:让 Agent 每天按规则工作
记忆与沉淀:让 Agent 跨会话持续进化

3. 二、这 8 个文件分别做什么

3.1 1) SOUL.md:人格底层

定义 Agent 的沟通风格、价值取向、行为边界。
比如:少废话、先查后问、外部动作谨慎。

作用:决定“像不像一个靠谱搭档”。


3.2 2) USER.md:用户画像

记录你是谁、怎么称呼、时区、偏好、协作习惯。
这不是简历,而是“执行偏好配置”。

作用:同一条指令,能更贴合你的习惯。


3.3 3) TOOLS.md:本地工具备忘

记录你环境里的工具约定:命令、路径、账号用途、发布流程。
例如封面图路径、发布脚本、特定 media_id 等。

作用:让 Agent 真正“会在你的机器上干活”。


3.4 4) AGENTS.md:总运行规则

定义每个会话开工前要读什么、什么可以主动做、什么需要先确认。
它是工作区级别的“操作守则”。

作用:防跑偏、防乱操作、提升稳定性。


3.5 5) HEARTBEAT.md:主动任务清单

定义心跳触发时要检查什么、什么时候执行、如何汇报。
例如:每天固定时段发文、巡检、提醒。

作用:从“等你命令”升级为“按节奏主动推进”。


3.6 6) MEMORY.md:长期记忆

沉淀长期有效的信息:关键决策、稳定偏好、长期项目背景。
它不记录所有细节,只保留“值得长期记住的内容”。

作用:跨天、跨会话仍然连续。


3.7 7) memory/YYYY-MM-DD.md:每日工作日志

记录当天发生了什么、做了什么、结果怎样。
这是短期运行日志,不是长期结论库。

作用:给复盘和长期提炼提供素材。


3.8 8) IDENTITY.md:身份信息

定义 Agent 的名字、气质、标识等。
用于多渠道输出时保持角色一致。

作用:避免“今天这个风格,明天另一个风格”。


4. 三、一个简单实例(为什么这套分层有效)

比如你说:“发布今天的实战剖析”。

USER.md 决定你的内容风格偏好
TOOLS.md 告诉 Agent 发布命令与封面规则
AGENTS.md 约束外部动作的确认边界
HEARTBEAT.md 决定是否要定时推进
MEMORY.md + daily memory 提供上下文连续性

所以它不是“临场发挥”,而是“按系统执行”。


5. 四、新手最常见的 4 个误区

所有规则都塞一个文件:后期必乱
只写原则,不写可执行细节:落不了地
只记日志,不做长期沉淀:越用越重复
频繁改人格文本:输出风格不稳定

6. 五、今天结论

今天先把地图看清楚:
每个文件有自己的边界,别混写。

这一步做好,后面才谈得上真正的“定制化”和“长期稳定”。


明天开始进入逐篇实战拆解:
第 1 篇:SOUL.md(怎么写出一个“好协作”的 Agent 人格)