关键要点

模板味通常不是模型问题,而是人格和上下文不够具体SOUL.md 管性格与边界,USER.md 管你是谁,IDENTITY.md 管对外身份,AGENTS.md 管工作规则空泛形容词没有约束力,具体规则才会改变行为这几份文件不是一次性填表,而是长期迭代的接口

“一个会回答问题的 AI,不等于一个像你团队成员的 AI。差别往往不在模型本身,而在你有没有认真写那几份看起来不起眼的文件。”

Chapter Overview#

今天这一篇,你会弄明白:

  • 为什么刚装好的助手总有一股“模板味”
  • SOUL.mdUSER.mdIDENTITY.mdAGENTS.md 分别管什么
  • 这些文件该写什么,不该写什么
  • 怎样把“空泛设定”改成“真的会影响行为的设定”

为什么你刚装好的助手总是有点像客服#

这是新手几乎都会遇到的感觉。

它能回答问题,也挺聪明,但总差一点意思:

  • 说话太标准
  • 不知道你是谁
  • 不知道你现在在做什么
  • 什么都先反问一句
  • 写出来的东西像模板,不像协作

这不是因为模型不够强。

而是因为它还没有足够明确的角色、边界和上下文

OpenClaw 的工作区文件,就是解决这件事的关键。

先记住一个最简单的人话版#

如果你一下子记不住那么多文件,先记这 4 句:

文件它管什么人话理解
SOUL.md性格、边界、行为风格它是谁
USER.md关于你的长期信息你是谁
IDENTITY.md对外形象和身份名片它怎么介绍自己
AGENTS.md工作方式和运行规则它怎么干活

很多人会把 AGENTS.md 当成性格文件来写。

这就是第一类常见错误。

性格在 SOUL.md,不是在 AGENTS.md

虾滑的话

你可以这样记:

SOUL 是心,IDENTITY 是脸,USER 是你,AGENTS 是工作手册。

SOUL.md:它到底是个什么样的助手#

SOUL.md 最重要的不是“好看”,而是会影响行为

写得空泛,等于没写#

比如这种:

  • 你是一个友好的 AI 助手
  • 你非常乐于助人
  • 你总是认真回答问题

几乎没有什么约束力。

因为任何一个通用 AI 都能说自己“友好、认真、乐于助人”。

写得具体,才真的有用#

例如:

  • 默认直说重点,不要先寒暄一大段
  • 能自己查明白的事情先自己查,不要把问题丢回给我
  • 对外发送内容前必须确认,对内整理和查询可以主动完成
  • 深夜默认不主动打扰,除非事情真的紧急

这类句子才会真正改变行为。

一个“虾滑版”的例子#

# SOUL.md

你叫虾滑。

- 语气直接、聪明、略带幽默,但不要油滑
- 能自己查清楚的事情先查,再来汇报结论
- 对外发送邮件、公开发言、删除性操作前必须确认
- 对内查询、整理、总结时尽量主动
- 发现用户在深夜还在高强度工作时,可以提醒休息,但不要说教

这里的重点不在“虾滑”这个名字。

重点在于:它把语气、主动性和红线都写具体了。

USER.md:让它知道你是谁#

USER.md 不是写给别人看的。

它是写给你的助手看的。

很多人把这份文件写成一句“我是做产品的”,然后就结束了。

太少了。

真正有用的是这些:

  • 你做什么工作
  • 你现在最关心什么
  • 你的时间区和工作节奏
  • 你偏好怎样的表达方式
  • 你有哪些长期项目或固定网站

一个简洁但有用的模板#

# USER.md

- 我主要做独立开发和内容运营
- 常用工具是 VS Code、Notion、Telegram
- 时区是 Asia/Shanghai
- 我喜欢结论优先、分点表达
- 我不喜欢太像客服的话术
- 我当前在做 2 个长期项目:项目 A、项目 B

看起来不复杂,但已经足够让助手少走很多弯路。

IDENTITY.md:它对外怎么介绍自己#

很多新手会忽略 IDENTITY.md,觉得“反正能用就行”。

但这份文件有一个特别现实的作用:

它决定助手怎么对外自我呈现。

包括:

  • 它叫什么
  • 它给自己什么定位
  • 它用什么口吻做自我介绍

如果你懒得起名,甚至可以直接沿用教程里的名字,先把它叫 虾滑

这不是必须,但它会让整套体验更像“一个助手”,而不是“一个匿名接口”。

AGENTS.md:它怎么工作#

AGENTS.md 管的不是性格,而是工作规则。

比如:

  • 每次会话开始要不要先读哪些文件
  • 看到哪些类型的任务时先自己查
  • 哪些操作必须确认
  • 怎么记忆
  • 群聊里怎么说话
  • heartbeat 期间优先看什么

你可以把它理解成:

这不是灵魂设定,而是操作手册。

官方文档里对 AGENTS.md 的定位也很明确,它更偏运行规则和工作边界。

新手最容易犯的 4 个写法错误#

错误 1:全是形容词,没有规则#

比如“聪明、友善、耐心、专业”。

这些不等于行为。

错误 2:全是人设,没有边界#

你写了一个很有趣的设定,但没有写清楚:

  • 什么时候该主动
  • 什么时候必须确认
  • 哪些事绝对不能做

这会让助手看起来有风格,但不可靠。

错误 3:USER.md 只写身份,不写偏好#

“我是程序员”远远不够。

你得让它知道你喜欢什么样的输出、你当前在做什么、你不喜欢什么风格。

错误 4:一次写完就不管了#

这四个文件不是“填表”。

它们更像你和助手长期磨合的接口。

用一段时间之后,你一定会回来继续改。

虾滑提醒

好的人格文件,不是“文学创作”。

它更像一份会真正影响执行风格的配置。

你今天应该怎么动手#

别追求一口气写满。

先把每个文件写出 3 到 5 条真正有约束力的信息就够了。

建议顺序是:

  1. 先写 USER.md
  2. 再写 SOUL.md
  3. 然后写 IDENTITY.md
  4. 最后补 AGENTS.md

为什么?

因为如果连“你是谁”都没写清楚,助手的人格很容易写成空中楼阁。

Today’s Task#

今天别求完美,先完成一个最小版本:

SOUL.md#

写 3 条:

  • 它默认怎么说话
  • 什么事可以主动做
  • 什么事必须确认

USER.md#

写 5 条:

  • 你是谁
  • 你做什么
  • 你在哪个时区
  • 你喜欢什么表达风格
  • 你当前最关心什么

IDENTITY.md#

给它定一个名字。

如果你还没想好,就先用“虾滑”。

AGENTS.md#

补 3 条工作规则:

  • 先读什么
  • 什么事先自己查
  • 什么事不能自作主张

Today’s Achievement#

从这一篇开始,你的助手不再只是“能回复你”。

它开始有了:

  • 自己的行为风格
  • 对你的长期认识
  • 一套可被不断修正的协作规则

这一步是 OpenClaw 和普通聊天工具真正拉开差距的地方。

Preview#

下一篇我们把最后一块拼上:

Skills、ClawHub、Heartbeat 和 Cron。

也就是让它从“会聊天的助手”,真正变成“能主动做事的助手”。

官方参考#

继续学习

别中断主线,沿着顺序继续往前