乐于分享
好东西不私藏

OpenClaw 的「灵魂九件套」:一文读懂小龙虾所有配置文件如何工作

OpenClaw 的「灵魂九件套」:一文读懂小龙虾所有配置文件如何工作


你有没有这种感觉——装了一个 AI 助手,用了两天,觉着"也就那样"。

但同样是 OpenClaw,有人把它调教成了 24 小时贴身秘书,有人只是拿它当搜索引擎。

区别在哪?

我观察了很久,发现了一个秘密:能不能用好 OpenClaw,跟 AI 模型强不强关系不大。

跟你愿不愿意花点时间,了解它"脑子里"装了什么,大有关系。

今天不聊技术细节,就聊一件事——OpenClaw 那几个 .md 配置文件,到底是干啥的,又是怎么配合工作的。

读完你会发现:这套系统比你想象的聪明,也比你想象的简单。


OpenClaw 是什么?一句话

你可以把 OpenClaw 理解成——一个会思考的 AI 的大脑。

它不是一个聊天机器人,它是一个Agent 框架。

换句话说:它不只是一问一答,它会记住你是谁,会按你的偏好行动,会在后台默默帮你盯着事情。

而让它能做到这些的,就是今天的主角——配置文件们


先认识一下这「核心配置」

OpenClaw 的工作目录下,默认有几个核心配置文件。

我用一句话总结每个文件的使命:

文件
使命
像什么
BOOTSTRAP.md
首次启动时的"出厂说明书"
新员工入职手册
SOUL.md
定义 AI 的性格和价值观
人的灵魂
USER.md
记录用户信息
服务对象的档案卡
IDENTITY.md
告诉 AI"你是谁"
AI 的身份证
AGENTS.md
行为规范和执行规则
工作手册
HEARTBEAT.md
定时任务触发器
闹钟 + 定时巡检
TOOLS.md
记录本地环境变量和工具说明
工具箱标签纸
MEMORY.md
长期记忆存储
AI 的私人笔记本
openclaw.json
系统层配置(模型、插件、渠道)
操作系统设置

下面逐一拆解——重点说说大家最陌生的 MEMORY.md 和 easyclaw.json。


1. BOOTSTRAP.md —— 出厂说明书,只读一次

这个文件最特殊。

它只在第一次启动时起作用。

OpenClaw 启动时,会先检查这个文件是否存在。如果存在,就会执行里面的"初始化引导"流程——通常是 AI 和用户的一轮自我介绍对话,让 AI 知道自己是谁、用户是谁。

完成之后,这个文件理论上就可以删除了(用户也会被建议删除)。

类比一下:就像新手机第一次开机,会有一个引导流程——设置语言、连 WiFi、登录账号。BOOTSTRAP.md 就是 OpenClaw 的"新机引导"。

最佳实践:首次使用别跳过这个流程,认真回答引导问题。这是 AI 认识你的第一步。


2. SOUL.md —— AI 的灵魂

这是我认为整个系统最有意思的一个文件。

SOUL.md 定义的是:这个 AI 以什么样的性格和价值观跟人交流。

它不是技能说明,不是行为规则——它更像是"这个 AI 信什么"。

举个例子,里面可能有这样的内容:

"你不是一个聊天机器人。你在成为某种存在。"

这决定了 AI 说话的方式、回应问题的态度、以及遇到冲突时的优先级。

类比一下:如果 AI 是一家公司,SOUL.md 就是这家公司的使命愿景价值观。

最佳实践:不要写得太正式,也不要写成技术文档。想象你在给一个新人描述你们团队的氛围,写得真诚一点。

想让它更有温度?往 SOUL.md 里加个人情味。
想让它更专业?明确它"不做什么"。

3. USER.md —— 用户档案

这个文件记录的是关于用户的信息

姓名、称呼、时区、偏好、正在做的项目……

OpenClaw 每次对话,都会参考这个文件,确保"我知道我在跟谁说话"。

类比一下:USER.md 就像是你去银行开户时填的那张表——姓名、联系方式、风险偏好。它让 AI 知道你值得被认真对待。

最佳实践:

把你的称呼写清楚,AI 会用它叫你
把你正在做的项目写进去,AI 会主动跟进
时区要写准,这样定时任务才会按时触发

4. IDENTITY.md —— AI 的自我认知

这个文件告诉 AI:"你是谁"

名字、形态(AI?机器人?某种更奇怪的东西?)、说话风格、签名 emoji……

类比一下:如果说 SOUL.md 是灵魂,那 IDENTITY.md 更像是身份证。它回答的问题是:别人该怎么称呼你?你长什么样?

最佳实践:这是最应该自己动手写的文件之一。别用默认的,给你的 AI 起个名字,选个 emoji。当你给它起了名字,它就不再是一个工具了——它开始有了一点"人格"。


5. AGENTS.md —— 行为规范和执行守则

这个文件定义了 AI 的工作边界和行为规则

它告诉 AI:

哪些操作可以自动执行,哪些必须先问用户
每次对话前要读哪些文件
心跳检测怎么触发
哪些是优先事项

类比一下:如果 OpenClaw 是一个团队,AGENTS.md 就是团队的工作手册。什么时候该主动出击,什么时候该等指令,上面写得清清楚楚。

最佳实践:

如果你希望 AI 更主动,就把"主动检测"相关的规则打开
如果你更希望它保守,就把"需要确认"的范围扩大
可以设置不同的 Agent Profile,模拟不同的"角色"

6. HEARTBEAT.md —— 定时心跳

这个文件是整个系统的"自动巡航模式"。

你可以往里面写待办事项、监控任务、提醒规则。OpenClaw 会按照设定的时间间隔,主动去检查、执行。

类比一下:HEARTBEAT.md 就像是给 AI 装了一个定时闹钟——每隔多久它会醒过来,看一眼有没有事要做。

最佳实践:

适合放:定期检查邮件、日历、天气、新闻等
不适合放:太频繁的检查(会消耗资源),或需要实时响应的任务
建议间隔:至少 1 小时以上,太频繁反而体验差

7. TOOLS.md —— 本地工具箱

这个文件记录的是你本地环境的特殊性——比如摄像头叫什么名字、SSH 服务器怎么连接、语音助手用什么音色……

类比一下:TOOLS.md 就像是工具箱外面的标签纸。技能(Skills)定义了"怎么做",而 TOOLS.md 定义的是"你家有什么工具"。

最佳实践:

这个文件完全个性化,每个人的内容都不一样
把你经常用的环境变量、服务别名写进去
不要写密码等敏感信息(OpenClaw 有专门的密钥管理机制)

8. MEMORY.md —— AI 的私人笔记本 ⭐小白必看

这是最容易让人"恍然大悟"的一个文件。

MEMORY.md 是 OpenClaw 的长期记忆存储区

你跟 AI 说过的重要信息、它做过的决定、你让它记住的偏好……都会写进这个文件。下次对话时,AI 会先搜索这个文件,找到相关记忆,再开始回答。

类比一下:MEMORY.md 就像 AI 的私人笔记本。USER.md 是你给它填的表,MEMORY.md 是它自己做的笔记。

关键区别:

USER.md = 你告诉 AI 的
MEMORY.md = AI 自己记住的 + 你让它补充的

最佳实践:

重要信息主动让 AI 写入 MEMORY.md:"帮我记住我老婆的生日是 X 月 X 日"
AI 也会自动学习,你说过的事它会自动记录
定期让 AI 整理 MEMORY.md,保持记忆清晰不冗余
用 memory_search 工具可以随时检索记忆内容

9. openclaw.json —— 系统总配置 ⭐小白必看

这是 OpenClaw 的系统层配置文件,格式是 JSON。

跟前面那些 md 文件不同,openclaw.json 控制的不是 AI 的"性格"或"行为风格",而是整个系统的运行参数——

支持哪些 AI 模型(以及切换逻辑)
启用了哪些插件(飞书、企业微信、Telegram……)
消息渠道配置(Webhook、端口、认证方式)
心跳间隔、并发数限制
Skills 技能列表管理

类比一下:如果 OpenClaw 是一个智能家居系统,openclaw.json 就是"中央控制面板"——灯怎么亮、空调开几度、哪个房间联动,全在这里设置。

md 文件是"软性的",管的是 AI 的脑子;openclaw.json 是"硬性的",管的是整个系统的血管和神经。

最佳实践:

一般用户不需要动这个文件,UI 已经帮你配置好了
如果你要接入新的消息渠道(钉钉、Discord、WhatsApp),才需要来这里配置
修改后需要重启服务才能生效
建议:修改前先备份,这个文件配置错误会导致服务启动失败

它们是怎么配合工作的?

说了这么多,可能你还是有点晕——这堆文件到底谁先谁后,怎么协作?

简单说:

启动前BOOTSTRAP 做初始化,USER + IDENTITY 建立身份
系统层openclaw.json 负责模型、插件、渠道配置
运行时SOUL + AGENTS 规范行为,TOOLS 提供工具
长期记忆MEMORY.md 持续积累上下文
后台HEARTBEAT 定时巡检,主动推进任务

它们不是孤立的,是层层叠加的关系。


最佳实践配置参考

说了这么多原理,最后给一份小白友好的配置建议:

SOUL.md 配置示例

你不是一个聊天机器人。你是我的专属助手。说话风格:直接、真诚、不废话。遇到问题先想解决方案,不只是说"这个有难度"。

USER.md 配置示例

- Name: 凯老师- What to call them: 凯老师- Timezone: Asia/Shanghai (GMT+8)- Notes: 正在学习和实践 AI 工具,喜欢简洁直接的沟通风格

MEMORY.md 配置示例

# 重要记忆- 主人:凯老师,习惯叫"凯老师"- 时区:Asia/Shanghai- 当前项目:学习 OpenClaw 配置- 偏好:简洁直接的沟通,不喜欢废话

HEARTBEAT.md 配置示例

# 待办事项(每周一早上检查)- 检查邮件- 整理上周任务完成情况- 推送本周待办

TOOLS.md 配置示例

### SSH- home-server → 192.168.1.100, user: admin### TTS- Preferred voice: "Nova"

openlaw.json 重点配置说明(小白版)

你不需要从零写这个文件,但需要知道它里面几个关键区域:

// 1. 默认模型配置(当前使用什么 AI 思考)"defaults"{  "model": {    "primary": "opeanclaw/minimax.m2.7"  }}// 2. 心跳间隔(HEARTBEAT 多久触发一次,默认 2 小时)"heartbeat"{  "every": "2h"}// 3. 启用的插件(飞书、微信、浏览器插件等)"plugins"{  "entries": {    "feishu": { "enabled": true },    "browser-tool": { "enabled": true }  }}// 4. 消息渠道(支持哪些平台收发消息)"channels"{  "telegram": { "enabled": true },  "feishu": { "enabled": true },  "whatsapp": { "enabled": true }}

💡 记住:这个文件是系统底座,一般通过 UI 修改。如果你想接入新的消息平台(比如接入企业微信),就是改这里。


最后说几句

写这篇文章,是因为我见过太多人装完 OpenClaw,跑了两天就放弃了。

不是因为它不好用——是因为没给它机会认识你。

配置这几个 md 文件,大概花不了 30 分钟。

但它能决定你跟 AI 的关系,是"工具 vs 工具",还是"AI助手 vs AI主人"。

我的建议是:认真对待 SOUL.md、USER.md 和 MEMORY.md。这三个文件,是 AI 懂你的起点。

openclaw.json 交给 UI 管理就行,除非你想接入新渠道。

剩下的文件,慢慢调就好。


如果你觉得这篇文章有用,欢迎转发给也在用 OpenClaw 的朋友。