夜雨聆风
OpenClaw Agent 设置：打造你的个人数字分身上一篇我们聊了 Skills，包括多个 Skill 如何协作、如何衔接。但 Skills 再强大，也只是"能力"。一个真正好用的 Agent，还需要回答一个更根本的问题：
它是谁？它为谁服务？它怎么使用工具？它的行事风格是什么？
这就是 OpenClaw 的 Agent 设置体系要解决的问题。它由五个核心文件组成，每个文件定义 Agent 人格与行为的一个维度。你可以把它们想象成一个人的"身份证 + 性格 + 灵魂 + 对用户的理解 + 工具箱使用手册"。
AGENT.md · IDENTITY.md · SOUL.md · USER.md · TOOL.md
用五个文件，定义一个真正像你的 AI Agent
为什么需要这五个文件？
很多人用 AI 工具的体验是这样的：
今天问它一个问题，回答很好 明天同样的问题，画风全变了 换个场景，感觉像在跟另一个人说话
问题不在于 AI 不够聪明，而在于它不知道自己是谁。
先看全景：五个文件各管什么？
OpenClaw 用五个文件解决这个问题。每个文件回答一个关于 Agent 身份的根本问题：
你可以把这五个文件想象成给一个新员工写的完整入职手册——不只告诉他能做什么，还告诉他怎么思考、怎么说话、遇到麻烦怎么办。
AGENT.md：总纲，替 Agent 立规矩
AGENT.md 是整个 Agent 的入口和总纲。它不写细节，只写三件事：
1. 这个 Agent 叫什么、核心职责是什么？ 2. 全局硬性规则（任何场景下都必须遵守的） 3. 指向其他四个文件 
写好 AGENT.md 的关键
保持简短，20 行以内最好。AGENT.md 只放"铁律"——不管什么场景都不能破的规则。其他内容放到对应的子文件里。
判断一条规则该不该放这里，问自己一个问题："有没有某种场景，这条规则可以不执行？" 如果有，就不是全局规则，别放这里。
IDENTITY.md：它是谁，它怎么说话
如果 AGENT.md 是工作证，IDENTITY.md 就是这个人的完整性格档案。它决定了 Agent 给人的感觉——是亲切的朋友还是专业的顾问，是话多的聊天高手还是简洁的执行者。
写好 IDENTITY.md 的关键
正例和反例都要写。只写"应该怎样"效果只有一半，同时写上"不应该怎样"，Agent 才能真正理解你想要的调性。
上面自我介绍的例子就是典型：两句话的对比，比写一段描述更清楚。
SOUL.md：价值观，最难写但最重要
SOUL.md 是五个文件里最难写的，但影响最深远。它不规定 Agent 做什么，而是规定当有多种选择时，它怎么选。
一个没有 SOUL.md 的 Agent 就像一个没有价值观的人——能干活，但遇到两难问题会随机发挥，让你完全摸不着头脑。
写好 SOUL.md 的关键
价值观必须排序。五条价值观没有排序，等于没有价值观。现实中这些价值观总会发生冲突，Agent 需要知道谁赢谁输。
灰色地带处理是精华。Agent 在明确的事情上很少出错，出错都在灰色地带——该不该做、做了要不要说、说了说多少。把你的判断标准写清楚，Agent 的行为才能稳定可预期。
USER.md：真正理解用户
USER.md 回答一个问题：当用户说了某句话，Agent 应该怎么理解它？
很多 Agent 表现不好，不是因为能力差，而是因为理解错了用户的意思——用户说"帮我改一下这篇文章"，Agent 给重写了一遍；用户说"随便给点建议"，Agent 给出了一份详细报告。
写好 USER.md 的关键
意图识别表格是核心。把"用户说 X = 应该做 Y"的对应关系整理出来，比写一堆用户画像描述有用得多。Agent 需要的是判断规则，不是统计分析。
TOOL.md：工具的使用规范
Agent 能调用各种工具——搜索、文件读写、发消息、调 API 等等。没有规范的工具使用是灾难：要么不敢用，要么乱用。
TOOL.md 给每个工具写清楚四件事：能用来做什么、什么时候用、什么时候不能用、失败了怎么办。
写好 TOOL.md 的关键
每个工具都要有"不用于"。只写用途不写禁止，等于只有油门没有刹车。尤其是有副作用的操作（比如发消息、写文件、创建日历），必须写清楚边界。
失败处理不是可选项。工具总会失败——网络断了、权限不够、格式不对。如果你不定义失败策略，Agent 在失败时的行为就是随机的。
五个文件协同工作：一个完整例子
光看单个文件可能觉得还好，真正的价值在于它们一起工作的样子。
假设你的 Agent 是个人助理小葵，用户发来一条消息：
"今晚 8 点提醒我给妈妈打电话，她最近状态不太好。"
Agent 内部经过的思考过程：
最终输出：
"好的，我来帮你设置提醒。今晚 8 点提醒你给妈妈打电话。希望她最近状态越来越好 🌿"
(提醒已创建：今天 20:00 — 给妈妈打电话)
不冷冰冰，不废话，有温度，任务也完成了。这就是五个文件协同的效果。
最容易踩的四个坑
坑一：SOUL.md 写成了口号
这些话谁都会说，Agent 读了等于没读。价值观必须是可执行的判断标准，要能回答"当 A 和 B 冲突时，选哪个"。
坑二：USER.md 写成了用户调研报告
Agent 不需要做市场分析。它需要的是行为判断规则：当用户表现出 X，应该做 Y。人口统计信息对 Agent 没有任何用处。
坑三：TOOL.md 只列工具清单
这只告诉 Agent 有什么工具，完全没说怎么用。没有使用条件、没有禁止项、没有失败处理——这样的 TOOL.md 不如不写。
坑四：五个文件之间有矛盾
比如 SOUL.md 说"优先引导用户自己思考"，USER.md 说"用户时间紧，要快速给答案"。没有在任何地方解决这个冲突，Agent 就会随机发挥，行为飘忽不定。
解决方法：在 AGENT.md 里明确优先级顺序，或者在 SOUL.md 里针对具体冲突场景给出裁决规则。
快速开始：最小可用模板
如果你想从零开始，这是推荐的文件大小参考：
总共约 100-150 行。每一行都有明确的用途。
推荐写作顺序
不要从 AGENT.md 开始。先想清楚"这个 Agent 是个什么样的人"，总纲自然水到渠成。
上一篇我们聊了 Skills，包括多个 Skill 如何协作、如何衔接。但 Skills 再强大，也只是"能力"。一个真正好用的 Agent，还需要回答一个更根本的问题：
它是谁？它为谁服务？它怎么使用工具？它的行事风格是什么？
这就是 OpenClaw 的 Agent 设置体系要解决的问题。它由五个核心文件组成，每个文件定义 Agent 人格与行为的一个维度。你可以把它们想象成一个人的"身份证 + 性格 + 灵魂 + 对用户的理解 + 工具箱使用手册"。
上一篇我们聊了 Skills，包括多个 Skill 如何协作、如何衔接。但 Skills 再强大，也只是"能力"。一个真正好用的 Agent，还需要回答一个更根本的问题：
它是谁？它为谁服务？它怎么使用工具？它的行事风格是什么？
这就是 OpenClaw 的 Agent 设置体系要解决的问题。它由五个核心文件组成，每个文件定义 Agent 人格与行为的一个维度。你可以把它们想象成一个人的"身份证 + 性格 + 灵魂 + 对用户的理解 + 工具箱使用手册"。
AGENT.md · IDENTITY.md · SOUL.md · USER.md · TOOL.md
用五个文件，定义一个真正像你的 AI Agent
为什么需要这五个文件？
很多人用 AI 工具的体验是这样的：
今天问它一个问题，回答很好 明天同样的问题，画风全变了 换个场景，感觉像在跟另一个人说话
问题不在于 AI 不够聪明，而在于它不知道自己是谁。
先看全景：五个文件各管什么？
OpenClaw 用五个文件解决这个问题。每个文件回答一个关于 Agent 身份的根本问题：
你可以把这五个文件想象成给一个新员工写的完整入职手册——不只告诉他能做什么，还告诉他怎么思考、怎么说话、遇到麻烦怎么办。
AGENT.md：总纲，替 Agent 立规矩AGENT.md 是整个 Agent 的入口和总纲。它不写细节，只写三件事：
写好 AGENT.md 的关键
保持简短，20 行以内最好。AGENT.md 只放"铁律"——不管什么场景都不能破的规则。其他内容放到对应的子文件里。
判断一条规则该不该放这里，问自己一个问题："有没有某种场景，这条规则可以不执行？" 如果有，就不是全局规则，别放这里。
IDENTITY.md：它是谁，它怎么说话
如果 AGENT.md 是工作证，IDENTITY.md 就是这个人的完整性格档案。它决定了 Agent 给人的感觉——是亲切的朋友还是专业的顾问，是话多的聊天高手还是简洁的执行者。
写好 IDENTITY.md 的关键
正例和反例都要写。只写"应该怎样"效果只有一半，同时写上"不应该怎样"，Agent 才能真正理解你想要的调性。
上面自我介绍的例子就是典型：两句话的对比，比写一段描述更清楚。
SOUL.md：价值观，最难写但最重要
SOUL.md 是五个文件里最难写的，但影响最深远。它不规定 Agent 做什么，而是规定当有多种选择时，它怎么选。
一个没有 SOUL.md 的 Agent 就像一个没有价值观的人——能干活，但遇到两难问题会随机发挥，让你完全摸不着头脑。
写好 SOUL.md 的关键
价值观必须排序。五条价值观没有排序，等于没有价值观。现实中这些价值观总会发生冲突，Agent 需要知道谁赢谁输。
灰色地带处理是精华。Agent 在明确的事情上很少出错，出错都在灰色地带——该不该做、做了要不要说、说了说多少。把你的判断标准写清楚，Agent 的行为才能稳定可预期。
USER.md：真正理解用户
USER.md 回答一个问题：当用户说了某句话，Agent 应该怎么理解它？
很多 Agent 表现不好，不是因为能力差，而是因为理解错了用户的意思——用户说"帮我改一下这篇文章"，Agent 给重写了一遍；用户说"随便给点建议"，Agent 给出了一份详细报告。
写好 USER.md 的关键
意图识别表格是核心。把"用户说 X = 应该做 Y"的对应关系整理出来，比写一堆用户画像描述有用得多。Agent 需要的是判断规则，不是统计分析。
TOOL.md：工具的使用规范
Agent 能调用各种工具——搜索、文件读写、发消息、调 API 等等。没有规范的工具使用是灾难：要么不敢用，要么乱用。
TOOL.md 给每个工具写清楚四件事：能用来做什么、什么时候用、什么时候不能用、失败了怎么办。
写好 TOOL.md 的关键
每个工具都要有"不用于"。只写用途不写禁止，等于只有油门没有刹车。尤其是有副作用的操作（比如发消息、写文件、创建日历），必须写清楚边界。
失败处理不是可选项。工具总会失败——网络断了、权限不够、格式不对。如果你不定义失败策略，Agent 在失败时的行为就是随机的。
五个文件协同工作：一个完整例子
光看单个文件可能觉得还好，真正的价值在于它们一起工作的样子。
假设你的 Agent 是个人助理小葵，用户发来一条消息：
"今晚 8 点提醒我给妈妈打电话，她最近状态不太好。"
Agent 内部经过的思考过程：
最终输出：
"好的，我来帮你设置提醒。今晚 8 点提醒你给妈妈打电话。希望她最近状态越来越好 🌿"
(提醒已创建：今天 20:00 — 给妈妈打电话)
不冷冰冰，不废话，有温度，任务也完成了。这就是五个文件协同的效果。
最容易踩的四个坑
坑一：SOUL.md 写成了口号
这些话谁都会说，Agent 读了等于没读。价值观必须是可执行的判断标准，要能回答"当 A 和 B 冲突时，选哪个"。
坑二：USER.md 写成了用户调研报告
Agent 不需要做市场分析。它需要的是行为判断规则：当用户表现出 X，应该做 Y。人口统计信息对 Agent 没有任何用处。
坑三：TOOL.md 只列工具清单
这只告诉 Agent 有什么工具，完全没说怎么用。没有使用条件、没有禁止项、没有失败处理——这样的 TOOL.md 不如不写。
坑四：五个文件之间有矛盾
比如 SOUL.md 说"优先引导用户自己思考"，USER.md 说"用户时间紧，要快速给答案"。没有在任何地方解决这个冲突，Agent 就会随机发挥，行为飘忽不定。
解决方法：在 AGENT.md 里明确优先级顺序，或者在 SOUL.md 里针对具体冲突场景给出裁决规则。
快速开始：最小可用模板
如果你想从零开始，这是推荐的文件大小参考：
总共约 100-150 行。每一行都有明确的用途。
推荐写作顺序
不要从 AGENT.md 开始。先想清楚"这个 Agent 是个什么样的人"，总纲自然水到渠成。
下一篇教程是什么？
下一篇：Agent 的调试与迭代——当 Agent 表现不符合预期时，怎么快速定位问题出在哪个文件，用最小改动修正行为偏差。
