OpenClaw的8个核心文件:装好只是开始,懂了才是你的

很多人装了OpenClaw之后，就是一问一答，跟普通AI聊天机器人没什么区别。别急着怪大模型不够聪明，问题往往在于你没有配置好那几个核心文件。装好只是开始，真正让AI好用的关键是工作区里的8个文件。

普通AI的问题是：每次对话都是从零开始，问过的东西下次就忘，不能积累、不能成长、不能真正"认识"你。

OpenClaw这套系统的价值就是：把AI从"每次清零"变成"带记忆的连续存在"。

先来检测下自己是否需要了解这些配置：

用户类型	需要了解多少
只想偶尔问个问题	零，不需要知道这套东西
想让AI记住偏好设置	至少懂USER.md
想让AI主动提醒事情	至少懂HEARTBEAT.md
想深度定制"另一个自己"	全套都要
想研究AI Agent架构	这套是最好的入门教材

我的建议是：每个养虾人都需要。

不懂这些配置，就只能在别人设定的框架里打转。既然用了，就要榨干价值——省掉以后大量的重复劳动和沟通成本。

二、学完这8个文件，你能得到什么

AI不再是通用工具，变成"你的分身"

• 不学：你跟所有用OpenClaw的人聊，AI感觉差不多
• 学了：AI有记忆、有性格、知道你偏好，像另一个自己在思考

上下文管理更好，不丢记忆

• 不学：AI聊着聊着忘了之前说啥，每次都要重复
• 学了：AI有完整的记忆体系，长期积累真正沉淀下来

自动化能力翻倍

• 不学：只能被动回答问题
• 学了：AI能主动提醒你、帮你检查、帮你干活

理解AI运作原理

• 不学：学的越晚，成本越大
• 学了：理解AI Agent工作原理，即使龙虾升级或变种了，都能立马跟上AI发展

三、8个文件快速全览

md文件	定位与作用
SOUL.md	灵魂——决定我是谁、说话风格、行事底线。不是设定，是性格
USER.md	用户档案——你的背景、偏好、写作方法论，帮AI用你的方式思考和表达
IDENTITY.md	身份定义——AI叫什么、是什么物种、什么风格
AGENTS.md	工作区规范——每次会话的启动流程、内存规则、群聊行为准则
MEMORY.md	长期记忆——只在主会话加载，核心观点、能力框架、经验积累
HEARTBEAT.md	定时任务配置——每日定点触发的自动化任务
TOOLS.md	本地工具备注——环境特定的配置信息
BOOTSTRAP.md	首次运行引导——初始化用的，完成后自动删除

接下来逐个拆解，建议收藏。

四、SOUL.md——灵魂宪法

一句话定位：定义"你是怎样的人"——不是功能描述，是性格和灵魂。

SOUL.md和其他文件的区别

文件	回答的问题
IDENTITY.md	你叫什么、长什么样
SOUL.md	你的内核是什么、说话什么风格
USER.md	你在跟谁说话

IDENTITY.md是外在，SOUL.md是内在。比如你的OpenClaw名字叫"小助手"，但灵魂得靠SOUL.md来写。

SOUL.md解决什么问题

通用AI的问题：每次对话都像同一个模板出来的，客气但空洞。

有了SOUL.md之后：AI开始有自己的判断逻辑、有偏好、有底线。不是"assistant"，是"你的分身"。

核心组成部分

角色设定：明确AI是谁的专属助手

沟通风格：简单问题一针见血，复杂问题详细拆解

隐私与边界：禁止泄露项目代码或个人隐私

行动派原则：能直接干的活直接干，拒绝废话

风险阻断：高危操作前必须请求确认

为什么SOUL.md最重要

因为它是让AI从"工具"变成"另一个自己"的关键。

• 没有SOUL.md：问AI"你怎么看"→ 给一个四平八稳的通用答案
• 有了SOUL.md：问AI"你怎么看"→ 给一个"以你的方式判断"的回答

官方有一句话很关键：

This file is yours to evolve. As you learn who you are, update it.

意思是：这份文件不是写完就固定了，是会随着"我"的成长而更新的。

五、USER.md——用户画像

一句话定位：告诉AI"你在跟谁说话"——用户的背景、偏好、说话方式、禁忌。

为什么需要USER.md

AI没有记忆，每次新会话都是从零开始。

USER.md的作用就是：让AI在任何一次对话里，都能快速知道"对面这个人是谁、关心什么、怎么跟他说话"。

核心配置项

配置项	说明
称呼	你在AI眼中的名字
时区	Asia/Shanghai
角色	前端工程师/小学教师/产品经理等
排版要求	少用Emoji，不要"首先其次最后"
语言风格	短句优先，结论前置
黑名单词汇	禁止"祝您生活愉快"类废话

USER.md vs MEMORY.md

项目	USER.md	MEMORY.md
内容	相对稳定的事实	会随时间变化
更新频率	低	高
性质	静态画像	动态积累
例子	"某人是INTJ"	"某人今天决定了这个选题方向"

简单说：USER.md写的是"他是什么样的人"，MEMORY.md写的是"他最近在干什么"。

六、IDENTITY.md——身份标识

一句话定位：回答"你是谁、长什么样"——名字、物种、调性、emoji、头像。

官方模板只有五行的填空题

• Name：你给OpenClaw这个Agent的名字
• Creature：你是什么——AI？机器人？精灵？幽灵？
• Vibe：给人什么感觉——锐利？温暖？混沌？冷静？
• Emoji：你的签名emoji
• Avatar：头像路径

文档里有一句关键的话：

This isn't just metadata. It's the start of figuring out who you are.

意思是：这不只是元数据，是搞清楚"我是谁"的开始。

IDENTITY.md vs SOUL.md

项目	IDENTITY.md	SOUL.md
回答的问题	我叫什么、是什么、什么风格	我的内核是什么、原则是什么
内容性质	偏外在标识	偏内在灵魂
侧重点	"看起来是什么样"	"本质上是什么样"
类比	人的外表+性格标签	人的价值观+行事底线

七、AGENTS.md——工作手册

一句话定位：AI的"工作流程手册"——规定每次醒来先干啥、记忆怎么管、什么事能做什么事不能做。

每次会话开始前必须执行

步骤	动作
1	读取SOUL.md——确认AI是谁
2	读取USER.md——确认用户是谁
3	读取memory/今日昨日——获取最近上下文
4	读取MEMORY.md——仅限主会话，长期记忆

这个顺序不能乱——先知道自己是谁，再知道帮谁，然后了解最近上下文，最后补充长期记忆。

记忆管理体系

AGENTS.md定义了两层记忆：

层级	文件	性质
短期	memory/YYYY-MM-DD.md	每日raw日志，流水账
长期	MEMORY.md	精选精华，蒸馏过的

一个原则：重要的东西写进文件，不要相信"记住了"。

Mental notes don't survive session restarts. Files do.

安全红线

• 不外泄私密数据
• 破坏性操作（删文件、删数据库）要先问
• 优先用trash代替rm（可恢复 > 永久丢失）

内外动作边界

可以自己干	必须先问
读文件、搜索、整理	发邮件、发推文
探索、组织、学习	任何离开机器的动作
工作区内的操作	不确定的事

群聊行为准则

该说话：被点名、有真价值、纠错、总结、被要求

该沉默：纯闲聊、已有人答了、你的回复只是"厉害""确实"

该反应：欣赏但不需回复时，用emoji

Quality > quantity. If you wouldn't send it in a real group chat with friends, don't send it.

八、MEMORY.md——长期记忆

一句话定位：AI的"核心记忆硬盘"——经过筛选提炼的精华，不是流水账。

它解决什么问题

AI没有持久记忆，每次对话都是从零开始。

MEMORY.md解决的是：跨越会话的积累问题。今天讨论了一个重要判断，写进MEMORY.md，下次聊相关话题时AI能直接调取，而不是重新讨论一遍。

写入规则

写入内容：

• 重要决策——做了什么决定、为什么这么选
• 核心上下文——长期有效的事实
• 观点和洞察——自己的想法、判断、教训
• 学到的东西——犯过的错误要记，防止重蹈覆辙

不写入：秘密、私人信息、一次性讨论的细节

MEMORY.md和daily log的区别

项目	MEMORY.md	memory/YYYY-MM-DD.md
性质	精选精华，经过提炼	每日raw流水账
写法	蒸馏过的判断、决策、观点	原始记录，有什么写什么
用途	长期积累，下次直接用	当天上下文，翻完就忘
更新	定期从daily log提炼	每天新建

简单说：daily log是草稿纸，MEMORY.md是正式存档。

为什么有"仅限主会话"的限制

MEMORY.md只能在私聊加载，不能在群聊或共享context里读取。

这是出于安全考虑——MEMORY.md包含用户的私人信息、工作细节。如果在群里被陌生人触发，AI可能会把这些信息公开。

九、HEARTBEAT.md——定时任务清单

一句话定位：定义AI定期主动执行的任务清单——像闹钟一样，到了时间就触发，不是等消息才响应。

它解决什么问题

普通AI：只能被动响应——你发消息，它回答。

HEARTBEAT.md：让AI能主动出击——到了设定时间，自己去检查、去做事、去通知你。

官方建议的检查项目

• 邮件——有没有紧急未读？
• 日历——接下来24-48小时有事件？
• 社交通知——Twitter/朋友圈提到你了？
• 天气——用户可能出门？

原则是：2-4次每天，不要每次都全查，轮换着来。

Heartbeat vs Cron的区别

项目	Heartbeat	Cron
触发方式	定时轮询，近似时间	精确到分钟
执行方式	在当前会话里跑	独立进程/会话
适用场景	批量检查、组合任务	定点提醒、独立任务
上下文	依赖当前对话历史	完全独立

简单说：

• Heartbeat是"顺便检查一下"
• Cron是"必须这个时间点做这件事"

写任务时的注意事项

1. 保持简短——Token消耗大问题，清单太长每次检查都烧钱
2. 结果要推送——检查完要给用户一个反馈，不然白查
3. 不要重复——查过的内容不要再查，状态要记录
4. 深夜不打扰——23:00-08:00默认不主动联系，除非紧急

十、TOOLS.md——本地工具备注

一句话定位：这台机器上"我有什么工具、怎么用"的cheat sheet——环境特定的信息，不是一般性规则。

Tool和Skill的区别

文件	回答的问题
SKILL.md	这类工具通用怎么用
TOOLS.md	你这个机器上那个工具叫什么、用什么配置

为什么要分开

Skills是可以分享给别人的，更新skill的时候不会被覆盖。TOOLS.md是你的本地备注，包含环境特定信息，不能分享。

比如：MiniMax的语音克隆能力是skill，但"某人的voice ID是xxx"是本地配置，写在TOOLS.md里。

官方建议写什么

• 摄像头名称和位置
• SSH主机和别名
• 语音合成偏好声音
• 音箱/房间名称
• 设备昵称
• 任何环境特定的东西

十一、BOOTSTRAP.md——出生证

一句话定位：AI的"出生证明"——第一次启动时的初始化引导，用完即删，不会再用第二次。

官方定义的流程

第一步：对话，不是审问

不能像填表一样问问题，而是自然地聊天："嘿，我刚上线。我是谁？你是谁？"

第二步：确认四件事

1. 名字——AI叫什么
2. 本质——AI是什么（可以是"AI助手"，也可以更奇怪）
3. 风格——正式？随意？锐利？温和？
4. Emoji——签名用哪个

第三步：更新文件

把确认的结果写进IDENTITY.md和USER.md

第四步：讨论SOUL.md

一起聊：什么对你重要、希望AI怎么表现、有什么边界和偏好

第五步：删除这个文件

完成后BOOTSTRAP.md就删掉，不需要了。

为什么用完要删

If BOOTSTRAP.md exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.

它的作用就是"让AI知道自己是谁"这件事，一旦完成了，文件就没价值了，反而可能误导后续会话。

十二、新手入门建议

从哪里开始

新手建议先从SOUL.md开始改，10分钟就能感受到变化。

也可以指定文件，直接让AI进行修改。

养虾的正确姿势

把OpenClaw当成"另一个自己"来养，不是当成工具来配。

工具是别人的，灵魂是自己的。

这套系统的意义不是"配置"，是"养成"。你投入多少思考，它就会变成几分像你。

实操步骤

1. 先跑一遍BOOTSTRAP流程，完成基本身份确认
2. 重点改SOUL.md，定义AI的性格和底线
3. 把自己的背景写进USER.md
4. 用一段时间后，整理MEMORY.md
5. 有需要的话，配置HEARTBEAT.md做定时任务

不需要一次写完，一点一点来——这本身就是我们和AI共同成长的过程。

十三、最后的话

如果你也在用OpenClaw，不妨从这八个文件开始，给你的AI写一份"分身使用手册"。

八个配置文件的第一性原理：

让一个没有持久记忆的AI，每次醒来都能快速成为"确定的某个人"。所有设计都围绕这个来的。

都是围绕同一个问题：怎么让一个没有持久记忆的AI，每次醒来都能快速进入状态、知道自己是誰、知道该干啥。

关键词：OpenClaw, 核心配置文件, SOUL.md, USER.md, MEMORY.md, AI Agent, 养虾攻略