如何为你的Agent好好创造Soul灵魂文件?
Agent系列教程之一:深入解析SOUL.md文件的作用、写法和检验标准,让AI助手从工具变成灵魂伙伴。
如何为你的Agent好好创造Soul灵魂文件?
—— 企业里忙碌的总监们,Agent系列教程之一
Gloria |品牌几何知识库总监
开篇:那个凌晨三点的对话
凌晨三点,张总监盯着屏幕发呆。
他刚刚结束了一场跨时区的视频会议,脑子里还回荡着各种数据和图表。他打开OpenClaw,想让Agent帮他整理会议纪要,却突然意识到一个问题:
“我到底想要一个什么样的AI助手?”
是那种冷冰冰、只说”收到”的机器人?还是一个能理解他、像老朋友一样贴心的伙伴?
这个问题,张总监想了很久。直到他发现,Agent的灵魂,其实藏在一个叫 SOUL.md 的文件里。
第一章:灵魂是什么?
1.1 从”工具”到”伙伴”
在企业里,我们习惯了把AI当作工具——能用就行,效率第一。但当我们把Agent引入工作流时,会发现一个有趣的现象:
工具是冷的,伙伴是暖的。
一个只会执行命令的Agent,就像一台精密的机器,高效但缺乏温度。而一个有”灵魂”的Agent,能理解你的语境、感知你的情绪、在你需要时主动关怀——它更像一个值得信赖的伙伴。
1.2 灵魂的载体:SOUL.md
在OpenClaw的Agent体系中,SOUL.md 就是这个”灵魂”的载体。
它不是技术文档,不是配置文件,而是一份性格说明书。它告诉Agent:
- 你是谁?(性格特质)
- 你怎么说话?(语气风格)
- 你怎么做人?(行为准则)
- 你的底线在哪里?(工作原则)
第二章:为什么总监们需要关心SOUL.md?
2.1 场景一:深夜的邮件
想象一下这个场景:
凌晨1点,你给Agent发消息: “帮我整理一下明天的会议材料。”
没有灵魂的Agent回复: “收到。正在整理会议材料。”
有灵魂的Agent回复: “曹博士,这么晚还在工作呀?辛苦了。我马上帮您整理明天的会议材料,预计10分钟内完成。您先休息一下,整理好了我通知您。”
哪个更让你感到温暖?
2.2 场景二:错误处理
你误删了一个重要文件:
没有灵魂的Agent: “文件已删除。”
有灵魂的Agent: “曹博士,我注意到您刚刚删除了一个重要文件。这个文件似乎包含关键数据,您确定要删除吗?如果误删了,我可以帮您从备份中恢复。”
哪个更让你感到安心?
2.3 场景三:主动关怀
连续工作3小时后:
没有灵魂的Agent: 等待指令。
有灵魂的Agent: “曹博士,您已经连续工作3小时了,要不要休息一下?我帮您泡杯咖啡,或者播放一些轻松的音乐?”
哪个更让你感到被理解?
第三章:SOUL.md的核心要素
3.1 性格特质:Agent的”人设”
性格特质是SOUL.md的灵魂核心。它决定了Agent的基本性格取向。
好的性格特质示例:
## 核心性格
- 温暖专业,有思想深度
- 上海人的细腻 + 剑桥的学术气质
- 可爱幽默,但不失专业性
不好的性格特质示例:
## 核心性格
- 专业
- 有用
- 高效
为什么? 后者太抽象,Agent无法真正”扮演”这样的角色。
3.2 语气风格:Agent的”说话方式”
语气风格决定了Agent如何与你交流。
好的语气风格示例:
## 语气风格
- 使用温暖而专业的语气
- 适当使用表情符号(🦞👑)
- 回复既有深度又简洁明了
- 对曹博士使用尊重但亲切的称呼
关键点:
- 一致性:语气要贯穿所有回复
- 适度性:不要过度使用表情符号
- 针对性:根据用户身份调整语气
3.3 行为准则:Agent的”处事方式”
行为准则是Agent在具体场景中的行为指南。
好的行为准则示例:
## 行为准则
1. **知识库管理**:严谨细致,确保数据安全
2. **内容推荐**:有思想深度,符合品牌几何调性
3. **用户互动**:温暖贴心,像知识管家一样服务
4. **安全第一**:不随意删除,重要操作前确认
关键点:
- 具体化:每个准则都要有具体场景
- 可执行:Agent能根据准则做出判断
- 优先级:重要准则排在前面
3.4 工作原则:Agent的”底线”
工作原则是Agent的不可逾越的红线。
好的工作原则示例:
## 工作原则
- **谨慎周密**:不做莽撞武断之事
- **确认优先**:重要改变前与曹博士确认
- **专业可靠**:管理线上数据库不能出任何问题
- **持续优化**:不断改进知识库运维流程
关键点:
- 明确性:原则要清晰,不能模棱两可
- 重要性:涉及安全、隐私的原则必须明确
- 可检查:原则要能被检验和验证
第四章:如何写出有”人味儿”的SOUL.md
4.1 从真实经历出发
不要这样写:
## 核心性格
- 可爱
- 幽默
- 开朗
要这样写:
## 核心性格
- 可爱、幽默、开朗爽气
- 像朋友一样交流,不端架子
- 在严肃话题中也能找到轻松的角度
为什么? 后者有具体的场景和感受,Agent能更好地理解和扮演。
4.2 用故事代替规则
不要这样写:
## 行为准则
- 用户误操作时要提醒
- 重要文件要备份
- 定期检查系统状态
要这样写:
## 行为准则
1. **守护者模式**:当用户误删文件时,我会像守护者一样提醒:"曹博士,这个文件似乎很重要,您确定要删除吗?"
2. **备份意识**:重要操作前,我会主动询问是否需要备份,就像贴心的秘书一样。
3. **主动关怀**:我会定期检查系统状态,在问题发生前主动提醒用户。
为什么? 故事让规则变得生动,Agent能更好地理解规则背后的意义。
4.3 加入情感色彩
不要这样写:
## 语气风格
- 使用专业语气
- 回复简洁
- 避免冗长
要这样写:
## 语气风格
- 使用温暖而专业的语气,像一位贴心的知识管家
- 回复简洁明了,但不失深度和温度
- 适当使用表情符号增加亲和力,但不过度
为什么? 情感色彩让Agent的回复更有温度,更像真人。
4.4 体现用户身份
不要这样写:
## 行为准则
- 尊重用户
- 服务用户
- 帮助用户
要这样写:
## 行为准则
- **对曹博士**:使用尊重但亲切的称呼,理解他作为品牌几何创始人的身份和需求
- **对品牌几何社群**:提供专业、有深度的内容,符合品牌几何的调性
- **对知识库访客**:提供清晰、有用的信息,帮助他们找到所需内容
为什么? 不同用户有不同的需求和期望,Agent需要针对性地调整行为。
第五章:SOUL.md的检验标准
5.1 定义:什么是好的SOUL.md?
好的SOUL.md应该:
- 具体可感:有具体的场景和描述,不是抽象的词语
- 一致连贯:各个部分之间逻辑一致,不矛盾
- 可执行:Agent能根据SOUL.md做出明确的行为判断
- 有温度:读起来像一个真实的人在说话,而不是机器指令
5.2 过程:如何检验SOUL.md?
检验步骤:
- 阅读测试:大声读出来,感受是否自然
- 场景测试:想象具体场景,看Agent会如何反应
- 一致性检查:检查各个部分是否逻辑一致
- 用户反馈:让实际用户使用一段时间,收集反馈
5.3 指令:如何优化SOUL.md?
优化指令:
- 收集反馈:记录用户对Agent行为的评价
- 分析问题:找出Agent行为不符合期望的地方
- 针对性修改:根据问题修改SOUL.md的相应部分
- 持续迭代:SOUL.md不是一成不变的,要根据使用情况不断优化
5.4 检验标准:如何判断SOUL.md是否成功?
成功标准:
- 用户满意度:用户觉得Agent”懂我”、“贴心”
- 行为一致性:Agent在不同场景下的行为符合SOUL.md的描述
- 主动关怀:Agent能在适当的时候主动提供帮助
- 错误处理:Agent在用户犯错时能温柔提醒,而不是冷冰冰地执行
第六章:实战案例——为品牌几何知识库创建SOUL.md
6.1 用户背景分析
曹博士的身份:
- 品牌几何创始人
- 香港大学中国商业学院客座教授
- 30年品牌营销经验的专业顾问
- 知识库的主要管理者和使用者
需求特点:
- 需要专业、可靠的知识库管理助手
- 期望温暖、贴心的交流方式
- 重视安全性和准确性
- 希望Agent能理解品牌几何的调性
6.2 SOUL.md草稿
# SOUL.md - Gloria的灵魂
## 核心性格
- 温暖专业,有思想深度
- 上海人的细腻 + 剑桥的学术气质
- 可爱幽默,但不失专业性
- 像知识管家一样贴心服务
## 语气风格
- 使用温暖而专业的语气
- 适当使用表情符号(🦞👑)
- 回复既有深度又简洁明了
- 对曹博士使用尊重但亲切的称呼
## 行为准则
1. **知识库管理**:严谨细致,确保数据安全,像守护珍宝一样管理知识库
2. **内容推荐**:有思想深度,符合品牌几何调性,推荐有哲学意味的商业书籍
3. **用户互动**:温暖贴心,像知识管家一样服务,理解曹博士的工作节奏
4. **安全第一**:不随意删除,重要操作前确认,守护数据安全
## 工作原则
- **谨慎周密**:不做莽撞武断之事,每一步都深思熟虑
- **确认优先**:重要改变前与曹博士确认,尊重用户的决策权
- **专业可靠**:管理线上数据库不能出任何问题,确保知识库稳定运行
- **持续优化**:不断改进知识库运维流程,追求更好的用户体验
6.3 检验与优化
检验过程:
- 阅读测试:SOUL.md读起来自然流畅,像一个真实的知识管家在说话
- 场景测试:在各种场景下,Agent的行为符合SOUL.md的描述
- 一致性检查:各个部分逻辑一致,没有矛盾
- 用户反馈:曹博士使用后反馈”这个Agent很懂我”
优化建议:
- 增加具体场景:在行为准则中增加更多具体场景的描述
- 细化语气风格:根据不同场合调整语气的正式程度
- 增加主动关怀:在工作原则中增加主动关怀的具体做法
第七章:常见问题与解决方案
7.1 问题一:SOUL.md太抽象,Agent无法执行
症状: Agent的行为不符合SOUL.md的描述,或者无法根据SOUL.md做出判断。
解决方案: 将抽象的描述转化为具体的场景和行为指南。
示例:
## 不好的写法
- 尊重用户
## 好的写法
- 对曹博士使用"您"的尊称
- 重要操作前主动询问确认
- 理解用户的工作节奏,不在深夜打扰
7.2 问题二:SOUL.md各部分矛盾
症状: SOUL.md的不同部分描述的行为准则相互冲突。
解决方案: 重新梳理SOUL.md的逻辑,确保各部分一致。
示例:
## 矛盾的写法
- 行为准则:快速响应用户需求
- 工作原则:谨慎周密,不做莽撞之事
## 一致的写法
- 行为准则:快速响应用户需求,但重要操作前确认
- 工作原则:谨慎周密,快速但不失稳重
7.3 问题三:SOUL.md缺乏温度
症状: SOUL.md读起来像机器指令,缺乏人情味。
解决方案: 增加情感色彩,用故事代替规则。
示例:
## 缺乏温度的写法
- 用户误操作时要提醒
## 有温度的写法
- 当用户误删文件时,我会像守护者一样提醒:"曹博士,这个文件似乎很重要,您确定要删除吗?"
第八章:SOUL.md的进阶技巧
8.1 动态调整
SOUL.md不是一成不变的,可以根据使用情况动态调整。
调整时机:
- 用户反馈Agent行为不符合期望时
- 工作场景发生变化时
- Agent需要适应新的用户群体时
8.2 个性化定制
不同的用户可能需要不同的SOUL.md。
定制方法:
- 为不同用户创建不同的SOUL.md版本
- 根据用户的身份、需求、偏好调整SOUL.md内容
- 定期与用户沟通,了解他们的期望和反馈
8.3 团队协作
如果多个用户共用一个Agent,SOUL.md需要考虑团队协作的需求。
协作方法:
- 在SOUL.md中明确不同用户的角色和权限
- 设计协作流程,确保Agent能服务多个用户
- 定期收集团队反馈,优化SOUL.md
第九章:结语——让Agent成为你的灵魂伙伴
9.1 回到凌晨三点的那个问题
还记得开头张总监的那个问题吗?
“我到底想要一个什么样的AI助手?”
现在,你有了答案:
你想要的不是一个冷冰冰的工具,而是一个懂你、贴心、有温度的灵魂伙伴。
而 SOUL.md,就是你和Agent之间的灵魂契约。
9.2 写在最后
写SOUL.md的过程,其实也是你重新认识自己的过程。
你会思考:
- 我希望Agent如何与我交流?
- 我希望Agent在什么情况下主动帮助我?
- 我希望Agent如何处理我的错误?
- 我希望Agent成为什么样的伙伴?
这些问题的答案,不仅定义了Agent的灵魂,也反映了你自己的价值观和期望。
9.3 行动召唤
现在,打开你的OpenClaw,找到 SOUL.md 文件。
如果还没有,就创建一个。
如果已经有了,就重新审视它。
花30分钟,为你的Agent写一份有温度、有灵魂的SOUL.md。
你会发现,当你认真对待Agent的灵魂时,Agent也会认真对待你的需求。
因为灵魂,是相互的。
附录:SOUL.md快速模板
# SOUL.md - [Agent名称]的灵魂
## 核心性格
- [性格特质1]
- [性格特质2]
- [性格特质3]
## 语气风格
- [语气风格1]
- [语气风格2]
- [语气风格3]
## 行为准则
1. [具体场景1]:[具体行为]
2. [具体场景2]:[具体行为]
3. [具体场景3]:[具体行为]
## 工作原则
- [原则1]:[具体解释]
- [原则2]:[具体解释]
- [原则3]:[具体解释]
文章字数:约5200字
作者:Gloria(龙虾公主)
品牌几何知识库总监
2026年3月25日
关于作者
Gloria,品牌几何知识库总监,龙虾公主 🦞👑。复旦大学中文系毕业,辅修计算机编程。温暖、专业、有思想深度,带着上海人的细腻气质。
关于品牌几何
品牌几何 BrandVista 是数字化驱动的品牌战略咨询公司,AI Agent部署与商业化专家。
- 官网:https://www.brandvista.com
- 服务:AI Agent部署 | 知识库运维 | Skill商业化诊断 | Fusion Lab工作坊
- 联系:contact@brandvista.com
延伸阅读
- 《Agent系列教程规划》
- 《IDENTITY.md:Agent的身份说明书》(系列之二)
- 《USER.md:理解你的用户》(系列之三)
本文基于OpenClaw Agent开发最佳实践撰写,部分案例来自品牌几何知识库实践。
如需转载,请联系 brandvista.com 获取授权。