龙虾的7个配置文件,需要自己手动改吗?

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

Image

但说实话,改完之后龙虾并没有脱胎换骨。

如果你觉得龙虾不够好用,原因大概率不在配置文件——模型选择、使用场景、Skill 安装这些因素的影响更大。配置文件解决的是”协作顺畅度”的问题,不是”能力上限”的问题。

不过,有两个文件值得花15 分钟改一下,改完体感确实会好一截。剩下的,要么默认就够好,要么不该乱动。


先看全貌:7个文件分别干什么

打开 ~/.openclaw/workspace/,你会看到这些文件。把龙虾想象成一个新入职的数字员工,每个文件就好理解了:

下面重点讲两个值得改的,再简单说说其他几个为什么不用动。


第一个要改:USER.md

这是投入产出比最高的配置文件。

默认的 USER.md 长这样:

# User

## About
Tell your assistant about yourself.

## Preferences
Add your preferences here.

等于什么都没说。

改完之后,龙虾从第一句话就知道你是谁、在干什么、偏好什么。省掉的是每次重复介绍自己的时间。

怎么写 USER.md

核心原则:只放影响工作协作的信息,不放社交资料。 你的 MBTI、星座不会改变龙虾帮你写文章的方式,但”我是产品经理,不会写代码”会。

可抄改模板

# User

## 基本背景
- [职业/角色],[一句话说明你在做什么]
- 技术水平:[准确描述——这直接决定龙虾跟你沟通时用多少技术术语]
- 当前主要在做的事:[列2-3个你最常让龙虾帮忙的工作场景]

## 工作偏好
- [你最常见的协作模式——比如"先出大纲确认后再写正文"/"给我结论,不要罗列选项"]
- [你关注什么维度——比如"设计逻辑 > 操作步骤"/"数据和案例 > 理论分析"]
- [你有什么独特的思考方式?值得龙虾主动调用的——比如"经常用XX行业类比AI领域"]

## 沟通偏好
- [语言偏好——中文为主?英文术语保留?]
- [讨厌的沟通方式——要具体到能识别,比如"讨厌先夸再转折的句式"]
- [喜欢的建议方式——比如"直接推荐一个,不要给三个让我选"]

写完之后,验证一下: 跟龙虾说”读一下你的 USER.md,用一句话告诉我你觉得我是什么样的人”。如果它的理解跟你的意图有偏差,就改。


第二个要改:HEARTBEAT.md

这个文件是龙虾和普通聊天 AI 最本质的区别。

ChatGPT、Claude 都是”踹一脚动一下”——你不说话,它永远沉默。龙虾不同:每隔 30 分钟,系统自动给它发一条消息,让它检查有没有事需要做。HEARTBEAT.md 就是它的巡检清单。

默认的 HEARTBEAT.md 非常简略:

# Heartbeat checklist
- Quick scan: anything urgent in inboxes?
- If it's daytime, do a lightweight check-in if nothing else is pending.
- If a task is blocked, write down what is missing and ask next time.

这也太泛了。”anything urgent in inboxes” —— 什么算 urgent?哪个 inbox?龙虾看完只能凭自己猜,大概率什么都不做,回一个 HEARTBEAT_OK(意思是”没事,继续睡”)。

改好 HEARTBEAT.md 之后,龙虾才真正从”你问它答”变成”它主动找你”。这是真正能感知到的体验升级。

怎么写 HEARTBEAT.md

核心原则:写得像你交代给实习生的待办清单——具体、可执行、有明确的触发条件。

不要写”关注行业动态”,要写”查看 Hacker News 前 5 条,如果有 AI Agent 相关的,发摘要给我”。

可抄改模板

# Heartbeat checklist

## 每次都检查
- [ ] 查看待办任务列表(memory/todos.md),如果有逾期任务,提醒我
- [ ] 如果距离上次对话超过 4 小时且是工作时间,发一条简短 check-in

## 特定时间段
- [ ] 早上 8-9 点:[你的晨间信息需求——比如"整理昨晚到现在的XX领域重要新闻"]
- [ ] 晚上 21-22 点:[你的日终需求——比如"总结今天完成的任务和明天待办"]

## 持续监控
- [ ] [你需要龙虾盯着的事——比如"某某竞品有新版本就通知我"]
- [ ] [另一个监控需求]

## 注意
- 如果没有需要报告的事,直接回复 HEARTBEAT_OK,不要强行找话说
- 只在有重要信息时才打扰我,不要每次心跳都发消息

重要提醒: 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目录下有文件夹。

龙虾的7个配置文件,需要自己手动改吗?

改完之后,期待什么、不期待什么

可以期待的:

  • 龙虾不再每次从零猜你的背景,对话效率提升
  • 龙虾会按照你的巡检清单主动给你有用的信息
  • 整体协作感觉更”顺”,更像一个了解你的搭档

不要期待的:

  • 龙虾突然变得比 Claude/GPT 直接对话更聪明(智能上限取决于模型,不取决于配置文件)
  • 龙虾能完美执行所有任务(它不是魔法,复杂任务还是会出错)
  • 改完文件立刻天翻地覆(这是锦上添花,不是脱胎换骨)

如果你改完还觉得不够好用,问题大概率出在更底层:接的模型不够强、工作流没有设计好,场景不适合龙虾、或者 Skill 没装到位。

实战教程

AI Coding 实战:10年祖传系统,54万行代码,2周重构结束

2026-3-19 8:28:25

实战教程

万字讲透OpenClaw:从能用到真好用的分水岭: Workspace 深度解析

2026-3-21 19:17:52

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧