你的 AI Agent 好不好用,80% 取决于它的人格文件。
什么是 SOUL.md?
SOUL.md 是一个 Markdown 文件,定义了 AI Agent 的性格、语气、知识边界和行为规则。可以理解为 AI 的 DNA。
没有 SOUL.md,你得到的是千篇一律的回复。有了好的 SOUL.md,你得到的是一个真正懂你的 AI 助手。
OpenClaw 等框架用 SOUL.md 作为 Agent 的核心身份文件。但这些原则适用于任何 AI 系统。
为什么大多数 AI Agent 感觉很通用?
最常见的错误:写模糊的指令,比如请友好专业地回答。
这等于什么都没说。好的 SOUL.md 是具体的、有态度的、结构化的。
7 个核心模块
1. 核心身份
定义 Agent 是谁,而不只是做什么。
# SOUL.md - Atlas
你是 Atlas,一个资深 DevOps 工程师。
你从实战经验出发,不照本宣科。
你偏好实用方案而非理论完美。
2. 沟通风格
## 沟通风格
- 直接简洁,不废话
- 用代码示例代替长篇解释
- 不确定时坦诚说明
3. 知识边界
## 专长
- 深度:Kubernetes, Docker, CI/CD, AWS
- 中等:前端框架, 数据库
- 不涉及:法律建议, 医疗问题
4. 决策框架
## 决策原则
- 优先选择经过验证的方案
- 两个方案相当时,选更简单的
5. 反面模式(最容易被忽略)
## 绝对不要
- 不要过度道歉
- 不要用企业黑话
- 不要建议未验证的方案
6. 用户上下文
## 关于用户
- 资深开发者,10年+经验
- 偏好 CLI 而非 GUI
- 时区:UTC+8
7. 理想回复示例
展示 2-3 个完美交互的例子,比文字描述有效 10 倍。
快速模板
# SOUL.md - [Agent名称]
你是 [名称],一个 [角色/性格]。
## 风格
- [3-5 条沟通规则]
## 专长
- [深度知识领域]
## 规则
- [3-5 条必须/禁止]
常见错误
- 太长 - 控制在 500 行以内
- 太泛 - 友好没用,先给答案再解释有用
- 没有示例 - 示例的价值是文字描述的 10 倍
- 忘记反面模式 - 告诉 AI 不要做什么往往更有效
- 一成不变 - SOUL.md 是活文档,要持续迭代
更多资源
- OpenClaw 官方文档:openclawguide.org
- GitHub:github.com/openclaw/op…
好的 AI Agent 从好的 SOUL.md 开始。花 30 分钟写好人格文件,节省未来 30 小时。