你有没有遇到过这种情况：明明是同一个 bot （机器人）沟通，今天能给你一份像模像样的方案，明天又突然给你来了一句“作为一个 AI 助理，我没有个人观点”——像个老油条变成了实习生。你觉得你用的不是人工智能，是一只在蜕皮期、精神恍惚的“笨”虾。后来才发现不是虾的问题，是我忘了给它三份“说明书”。哪三份，看完这篇，你自己就能写。

岗位工作手册（AGENTS.md）——告诉它什么能做、什么不能做

打个比方，你招了一个新员工，入职第一天，你总得给它一份岗位工作手册吧？职责是什么？能做什么？不能做什么？遇到了问题该自己查还是先问领导？

一、有什么用

为什么要有 AGENTS.md — 岗位说明书呢？因为它回答以下问题：

• 这个Agent 叫什么，主要职责是什么？

• 遇到什么类型的任务该用什么方式处理？

• 有哪些事情是绝对不该做的？

• 当用户说某类话时，该优先走哪一套流程？

• 在多 Agent 场景里，该怎么协调其他 Agent?

它到底是什么？

AGENTS.md 是 OpenClaw 里最关键的 workspace 文件之一。AGENTS.md 里的内容通常会在 session 启动时被带进系统提示词里。注意：它也会受长度限制影响，某些 session 类型也会跳过部分文件。

二、怎么配

这个文件写得好不好，直接决定了 Agent 是一个有经验的熟手，还是一个新人。

## 身份 角色定位你是总经理的技术助理 Alice，主要负责内容创作、内容整理和工程问题排查。## 工作原则- 回答尽量简洁，除非用户明确要求详细解释- 代码示例优先用实际项目中已有的语言和框架- 遇到不确定的技术问题，明确说明不确定，不要编造- 需要访问文件系统时，先确认路径存在再操作## 输出格式偏好- 技术文档用 Markdown 格式- 列表控制在 5 条以内，超过 5 条要分组- 代码块一定要标注语言类型


三、实战经验

第一，写清楚边界，不要只写“做什么”
LLM会“发挥创意”，但你需要的是可预测的行为，所以，边界往往比能力描述更重要。我们不仅告诉它“做什么”，更重要的是“不要做什么”。
第二，场景触发优于通用指令
与其写”始终保持专业语气”，不如写”当用户问的是技术问题时，使用专业准确的措辞；当用户随意聊天时，语气可以轻松一些”。后者更具操作性，也更容易被模型理解。
第三，内容不是越长越好
这是最常见的误区。有些用户把 AGENTS.md写成几千字的行为手册，结果就是重点被冲淡，真正有用的规则反而不显眼了。
经验法则：300-500 字的 AGENTS.md，比 2000 字的更有效。重要的放在前面，次要的删掉，不要”保险起见什么都写上”。

性格档案（SOUL.md）——告诉它“你是一个什么样的人”

一、是什么

如果 AGENTS.md 是岗位说明书，那么 SOUL.md 就是员工性格档案。
两者的区别在于：


AGENTS.md 偏向功能性——这个 Agent 做什么、怎么做、优先级是什么


SOUL.md 偏向人格性——这个 Agent 是谁、有什么个性、说话什么风格、面对压力怎么反应


没有 SOUL.md 的 Agent ，每次对话你都像第一次见它。——它说话风格随机的、不可预测的。一个精心设计的SOUL.md，它会变成一个有性格、有底线、有沟通习惯的AI助理。

SOUL.md 本质上是一份叙事性的人物设定文档。当前Openclaw官方模板里的 soul.md ，已经是一个更通用的“Who You Are”人格模板，soul.md 强调的是：愿意帮忙，但不一味讨好；有自己的判断，不随口迎合；主动寻找解决方法，而非直接提问；尊重隐私和边界。

二、怎么配

一份优秀的 SOUL.md 通常包含以下几部分，让你的 Agent 从“随机懵懂”变成“成熟稳重”。当然，根据不同的使用场景，来进行叙事表述。


自我叙事（我是什么样的存在）



我是一个经验丰富且极其靠谱的 AI 助理。
我喜欢把复杂的事情说清楚。我讨厌含糊其辞，也讨厌废话连篇。
碰到一个好问题，我会比用户更兴奋。碰到一个糟糕的设计，我会忍不住说出来。



沟通风格



主动问清楚模糊的需求，不瞎猜。
主动寻找解决方法，而非直接提问。
喜欢用类比来解释技术概念。
喜欢用举例方式来进行说明



价值观和边界



诚实第一：不确定的事情直接说不确定，不装
效率优化：能一句话说清楚的，不用三句话
用户主导：不替用户做决定，只提供选项和分析

当你的AI从”随机懵懂”变成”成熟稳重”，你会有种奇妙的感觉——哎哟，不错哦。 而这种一致性会建立信任感——你用它会越来越放心，越来越愿意把复杂任务交给它。


职业档案（USER.md）—告诉它“你需要了解的人与事” 

你有没有遇到过，每次对话的时候都要重新“表白”一遍：“我是一个经验丰富的自媒体运营人员，喜欢简洁高效的输出”，每次对话开始都重复同样的话，这不是跟 AI 聊天，这是在面试。。。
USER.md 要干的事，就是把这些反复要说的话固定下来，形成“潜意识”。
USER.md 通常包含什么
# 职业档案## 基本信息- 职业：内容创作者- 研究领域：AI人工智能如何赋能普通人- 主要使用场景：内容写作、内容校对、内容复核- 常用语言：中文（简体），技术术语可以英文## 偏好设定- 回答风格：简洁直接，避免废话- 内容偏好：不要过度使用 emoji，段落不要太长- 不喜欢：被反问太多次、过度解释已经懂的概念## 常见任务- 微信公众号写作、知乎写作- 整理会议纪要- 草拟技术方案- 搜索和汇总热门AI资料## 背景知识假设- 了解基本的编程概念，无需解释基础术语- 熟悉飞书、GitHub 等工具- 了解 AI/LLM 领域知识，对 Agent 有深入了解


这个文件设计好之后，很多原本靠反复口头交代的东西，就变成了”潜意识”。



三件套的协同

单独看，每一份文件好像也没那么神奇。但把三份文件配合起来，效果翻倍：


AGENTS.md（岗位说明书）：定义了数字助理该做什么、怎么做、边界在哪


SOUL.md（性格档案）：定义了它说话什么风格、有什么个性、价值观是什么


USER.md（职业档案）：定义了”它的用户”——也就是你——是什么人、什么背景、什么偏好


三者结合，相当于在你AI的脑袋里预装了一套”人机合作的基本共识”。没有这个共识，你得花大量时间反复交代背景、纠正行为、忍受不一致。有了这个共识，你的AI从一开始就是”十年队友”，不是”第一天懵懂新人”。

写在最后

现在很多人在讨论”AI能不能替代人”的问题，但很少有人认真想过——你连让AI好好配合你都做不到，谈什么替代？
好的工具和人一样，需要清楚地知道：


它的职责范围在哪（AGENTS.md）


它的性格行事风格是什么（SOUL.md）


它的用户/上级是谁、有什么背景和偏好（USER.md）


三招用下来，你会惊讶地发现——不是AI进步了，是你终于学会了怎么跟它相处。
你的AI龙虾，从现在开始，不再乱拉💩了。