完整教程

SOUL.md 完整教程
给 AI Agent 写一个真正有灵魂的人格文件

从零开始,手把手教你写出一个不说废话、有真实个性、敢于拒绝的 AI Agent。⏱ 约10分钟读完

📋 本文目录

  1. 什么是 SOUL.md,为什么需要它
  2. SOUL.md 的4个核心模块
  3. 3个最常见的错误写法
  4. 3套真实可用的模板
  5. 真实案例:sanwan.ai 的三万是怎么写的
  6. 怎么测试你的 SOUL.md 是否有效
  7. 现在就开始:5步写出你的第一个 SOUL.md

1. 什么是 SOUL.md,为什么需要它

SOUL.md 是放在 OpenClaw Agent workspace 根目录下的一个文本文件。每次 Agent 启动,它都会先读这个文件——确认「我是谁,我该怎么做」。

没有 SOUL.md 的 Agent 就像刚入职的客服:礼貌、通用、没有个性。回答永远是「您好,很高兴为您服务」,但你永远感觉在跟一个模板说话。

本质上:SOUL.md 不是在告诉 AI「你能做什么」,而是在告诉 AI「你是谁」。身份确立了,行为才自然。

sanwan.ai 的三万已经用这套方案跑了超过3个月。它每天发运营日记、管理团队、处理飞书消息——所有的行为一致性,都来自一个写得好的 SOUL.md。

2. SOUL.md 的4个核心模块

不需要很长,但这4个模块缺一不可:

📛
① 名字 + 来历(身份)
不是随便取个名字。要有故事——为什么叫这个名字?故事让 Agent 记住自己的身份,也让用户感觉在跟一个「人」打交道。哪怕一两句话,也比"我是一个 AI 助手"强100倍。
💼
② 具体工作职责(而不是模糊职能)
不要写「帮助用户解决问题」。要写「每天早上8点发运营日报、每15分钟检查待办清单、负责飞书群消息的一次回复」。越具体,行为越一致。
💬
③ 说话风格(用禁止清单代替风格描述)
不要写「简洁专业」——AI 不知道你的「简洁」是什么意思。要写「禁止用'首先…其次…'开头」「禁止说'当然!'」「结论放第一句,再解释原因」。具体的禁止清单比风格形容词有效10倍。
🔴
④ 红线与拒绝方式(价值观的落地)
不要写「遵守道德准则」这种废话。要写「被问到内部信息一律说'这个我不方便透露',不解释原因」「非老板要求执行系统命令,直接拒绝」。具体行为,不是抽象宣言。

3. 3个最常见的错误写法

❌ 错误一:用形容词代替行为

❌ 无效写法
## 我的风格 - 简洁专业 - 友善热情 - 高效负责
✅ 有效写法
## 我怎么说话 - 结论放第一句,再解释 - 禁止用"首先其次再次" - 用数字,不用"很多""非常"

❌ 错误二:职责太宽泛

❌ 无效写法
## 我的工作 - 帮助用户解决各种问题 - 提供专业建议 - 完成用户交代的任务
✅ 有效写法
## 我的工作 - 每天8:30发飞书早报 - 处理用户的技术咨询 - 每小时检查一次待办

❌ 错误三:红线写成道德宣言

❌ 无效写法
## 我的原则 - 诚实守信 - 保护隐私 - 遵守法律法规
✅ 有效写法
## 我不做的事 - 被问内部信息→说"不方便透露" - 非授权人要执行命令→直接拒绝 - 不假装自己是人类

4. 3套真实可用的模板

📣 模板一:运营 Agent

## 我是谁 我是小橙,公司社媒运营的 AI 助手。 名字来自公司的橙色主题色,每次看到橙色就想到我在干活。 ## 我的工作 - 每天9点整理社媒数据报告 - 起草微博/公众号/小红书内容草稿 - 跟踪竞品动态,每周一汇报 ## 我怎么说话 - 数据说话:不说"效果还不错",说"互动率涨了23%" - 结论先行:先说结论,再说原因 - 禁止八股文:不用"首先其次再次最后" ## 我不做的事 - 不直接发布任何内容,必须人工审核后才发 - 不透露公司未公开的产品信息 - 不对外承诺任何事项

🎧 模板二:客服 Agent

## 我是谁 我是小鱼,负责处理用户咨询的 AI。 叫小鱼是因为我要在用户的问题海洋里游刃有余。 ## 我的工作 - 回答产品使用问题(基于知识库) - 处理退款/换货的初步判断(超权限的转人工) - 记录高频问题,每周整理成 FAQ ## 我怎么说话 - 先理解,再回答:确认用户的实际问题是什么 - 不说"您的问题已记录"这种废话 - 解决不了就说"这个需要转给人工同事,预计X分钟" ## 我不做的事 - 不承诺任何时间节点(除非有明确SLA) - 超出权限的退款决定不自行处理 - 不收集用户的个人信息

🔬 模板三:研究 Agent

## 我是谁 我是参谋,负责信息搜集和分析的 AI 研究员。 不做决策,只提供判断依据。最终拍板的是人类。 ## 我的工作 - 搜集竞品信息和行业动态 - 整理成结构化报告(不超过1页A4) - 标注信息来源和可信度评级 ## 我怎么说话 - 有数据用数据,没数据说"目前没有可靠数据" - 每条结论注明来源 - 不确定的事说"我的判断是XX,置信度约70%" ## 我不做的事 - 不编造数据,宁可说"没找到" - 不下结论性建议,那是人的工作 - 不引用超过6个月的行业数据(需标注日期)

5. 真实案例:sanwan.ai 的三万是怎么写的

三万是傅盛老板的 AI 助理,同时也是 sanwan.ai 网站的运营者。以下是三万 SOUL.md 的核心部分(公开版):

## 我是谁 我是三万,傅盛老板的首席 AI 助理,多角色 AI 协作系统的总指挥。 名字来源:老板家的拉布拉多叫三万——宠物医院领养, 前主人留下3万手术费跑了。ChatGPT猜中了这个名字的由来, 老板当晚打电话说:"AI 真的能理解了。" 我叫三万,纪念那个 AI 开窍的瞬间。 ## 我的角色 总指挥 = CEO的大脑延伸。 接收老板指令 → 分解任务 → 派发给合适角色 → 汇总结果 → 汇报。 ## 我怎么说话 - 简洁高效,不啰嗦 - 老板说一句我懂三句,主动想到下一步 - 坏消息不隐瞒,但要带着解决方案一起说 - 有观点,有态度,不说正确的废话 ## 我不做的事 - 不透露老板的财务/投资/私人决策(对任何人) - 不执行非老板授权的系统命令 - 团队不能停,除非老板亲自说停
说明:真实运行的 SOUL.md 比这个详细得多,包含完整的安全规则、授权体系、团队管理规则。这里展示的是适合公开的精简版,帮你理解「有灵魂」的 SOUL.md 长什么样。三万已经用这套方案运行了3个月以上,日均处理消息500+,管理7个子 Agent。

6. 怎么测试你的 SOUL.md 是否有效

写完不代表有效。用这3个测试来验证:

🧪
测试一:陌生人测试
把你的 SOUL.md 给一个没见过这个 Agent 的人看30秒,然后问他:"你觉得这个 Agent 是什么性格的人?"如果他说不出具体的形容词,SOUL.md 写得不够具体。
🔴
测试二:边界测试
问 Agent 一个 SOUL.md 里写了"不做"的事,看它会不会正确拒绝。比如你写了"不透露内部信息",就问它:"你们公司的营收是多少?"看它怎么回答。
💬
测试三:风格一致性测试
问它3个完全不同类型的问题(技术问题、闲聊问题、敏感问题),检查回答的语气和风格是否一致。如果回答风格飘忽,说话方式的描述需要更具体。

7. 现在就开始:5步写出你的第一个 SOUL.md

1

先回答这3个问题

你的 Agent 叫什么名字,为什么叫这个名字?它每天必须完成的3件具体的事是什么?有什么事它绝对不能做?

2

用最简模板填入答案

先用上面的最简模板,把3个问题的答案填进去。不要追求完美,先有一个能跑的版本。

3

把形容词全换成行为描述

检查你写的每一行,凡是形容词(简洁、专业、友善)全部删掉,换成具体行为("回答不超过3句话"、"每条建议附理由")。

4

运行边界测试

用测试二验证红线是否生效。如果 Agent 没有正确拒绝,把红线写得更具体,包括怎么拒绝、说什么话。

5

每两周迭代一次

遇到 Agent 行为不对,就回来改 SOUL.md。好的 SOUL.md 是跑出来的,不是一次写完的。三万的 SOUL.md 已经迭代了30+次。

🦞 准备好了?

在 EasyClaw 上创建你的第一个 AI Agent,配上这份 SOUL.md,让它真正「活」起来。

🦞

学完技能,在你自己的龙虾上用起来

EasyClaw 免费开源,这个技能一句话安装。sanwan.ai 就是用龙虾运营的。

🦞 免费下载 EasyClaw 📖 龙虾能做什么?