装好龙虾之后,很多人做的第一件事是去研究 ~/.openclaw/workspace/ 里那堆 .md 文件。我也是,前几天折腾了一下:

但说实话,改完之后龙虾并没有脱胎换骨。
如果你觉得龙虾不够好用,原因大概率不在配置文件——模型选择、使用场景、Skill 安装这些因素的影响更大。配置文件解决的是”协作顺畅度”的问题,不是”能力上限”的问题。
不过,有两个文件值得花15 分钟改一下,改完体感确实会好一截。剩下的,要么默认就够好,要么不该乱动。
先看全貌:7个文件分别干什么
打开 ~/.openclaw/workspace/,你会看到这些文件。把龙虾想象成一个新入职的数字员工,每个文件就好理解了:
下面重点讲两个值得改的,再简单说说其他几个为什么不用动。
第一个要改:USER.md
这是投入产出比最高的配置文件。
默认的 USER.md 长这样:
等于什么都没说。
改完之后,龙虾从第一句话就知道你是谁、在干什么、偏好什么。省掉的是每次重复介绍自己的时间。
怎么写 USER.md
核心原则:只放影响工作协作的信息,不放社交资料。 你的 MBTI、星座不会改变龙虾帮你写文章的方式,但”我是产品经理,不会写代码”会。
可抄改模板
写完之后,验证一下: 跟龙虾说”读一下你的 USER.md,用一句话告诉我你觉得我是什么样的人”。如果它的理解跟你的意图有偏差,就改。
第二个要改:HEARTBEAT.md
这个文件是龙虾和普通聊天 AI 最本质的区别。
ChatGPT、Claude 都是”踹一脚动一下”——你不说话,它永远沉默。龙虾不同:每隔 30 分钟,系统自动给它发一条消息,让它检查有没有事需要做。HEARTBEAT.md 就是它的巡检清单。
默认的 HEARTBEAT.md 非常简略:
这也太泛了。”anything urgent in inboxes” —— 什么算 urgent?哪个 inbox?龙虾看完只能凭自己猜,大概率什么都不做,回一个 HEARTBEAT_OK(意思是”没事,继续睡”)。
改好 HEARTBEAT.md 之后,龙虾才真正从”你问它答”变成”它主动找你”。这是真正能感知到的体验升级。
怎么写 HEARTBEAT.md
核心原则:写得像你交代给实习生的待办清单——具体、可执行、有明确的触发条件。
不要写”关注行业动态”,要写”查看 Hacker News 前 5 条,如果有 AI Agent 相关的,发摘要给我”。
可抄改模板
重要提醒: HEARTBEAT.md 要写得尽量短小。这个文件每 30 分钟被读一次,太长会浪费 token。把它想象成一张便利贴,不是一份工作手册。
其他文件:为什么不用动
SOUL.md:默认就不错,别画蛇添足。
Peter Steinberger 写的原始 SOUL.md 已经包含了合理的人格设定。大模型本身的默认行为就很”professional and helpful”,SOUL.md 的默认值跟这个方向一致,改了反而可能引入矛盾。
除非你有非常具体的需求——比如你希望龙虾永远用中文回复、或者你希望它的语气更直接不要客套——否则不建议改。如果你确实有这类需求,在 USER.md 的”沟通偏好”里写就行了,不需要动 SOUL.md。
AGENTS.md:规则复杂,改错了会出问题。
这个文件定义了龙虾的权限边界——什么操作需要先问你、什么能自动执行、怎么处理子任务。默认规则经过社区大量用户验证,已经足够安全和实用。
MEMORY.md 和每日日志:龙虾自己维护的,你别管。
MEMORY.md 是龙虾的长期记忆,每日日志是它自动写的工作记录。它们会随着你的使用自动积累内容。你不需要手动写入,也不建议随意删改——除非你发现龙虾记住了错误的信息,可以手动修正。
TOOLS.md:因人而异,没有通用模板。
这个文件列出龙虾能调用的工具和服务。每个人装的 Skill 不同,所以没法给通用模板。可以在这里更新,也可以不更新,因为skill在workspace目录下有文件夹。

改完之后,期待什么、不期待什么
可以期待的:
- 龙虾不再每次从零猜你的背景,对话效率提升
- 龙虾会按照你的巡检清单主动给你有用的信息
- 整体协作感觉更”顺”,更像一个了解你的搭档
不要期待的:
- 龙虾突然变得比 Claude/GPT 直接对话更聪明(智能上限取决于模型,不取决于配置文件)
- 龙虾能完美执行所有任务(它不是魔法,复杂任务还是会出错)
- 改完文件立刻天翻地覆(这是锦上添花,不是脱胎换骨)
如果你改完还觉得不够好用,问题大概率出在更底层:接的模型不够强、工作流没有设计好,场景不适合龙虾、或者 Skill 没装到位。
