🔔关注我后台回复"资料"，能免费获取海量魔·法📒笔记！

OpenClaw 最近非常🔥。

说白了它就做了一件事：让你在飞书、Telegram、Slack 这些平时用的聊天工具里，直接使唤 AI 干活。不用自己写界面，不用搭后端，改几个配置文件就行，Claude、GPT、Gemini、Kimi 都能接进来当你的人。

装好之后，拉起一个 agent 五分钟的事。

然后你就会被一个东西卡住——给 agent 写人设文件。

SOUL.md 写少了，agent 跟个智能客服似的，什么都能答但没有自己的风格。写多了吧，前后矛盾，好几个 agent 说话腔调撞车。每建一个新的还得从头写，纯体力活。

GitHub 上有个仓库叫 agency-agents，专门解决这个问题。上百个写好的 AI 人格定义，按前端、后端、设计、产品、运维这些岗位分好了类，结构统一。关键是对 OpenClaw 做了适配——两条命令就能自动转成 OpenClaw 要的格式。

但比拿来就用更有价值的是：这个仓库的文件组织方式本身，就是一套"怎么把人设文件写好"的方法。

这篇讲两件事：怎么把它装进 OpenClaw，怎么照着它的路子写自己的。

先搞懂 OpenClaw 的三个文件

OpenClaw 用三个 Markdown 文件来定义一个 agent 的完整人格。搞清楚这三个文件各管什么，后面的操作才好理解。

IDENTITY.md — 相当于工牌。一般就几行，写个名字加两句话介绍。

Name: 码爷 (Code Master)Creature: 开发架构师 / Claude Code 操盘手Vibe: 专业、直接、有架构师的视野和工匠的执行力Emoji: 🏛️Avatar: (待定)

SOUL.md— 相当于这个人的性格。定义它说话什么风格、做事什么态度、哪些事打死不干。

# SOUL.md - 码爷## 风格简洁直接，技术深度优先。不整虚的，不说"非常高兴为您服务"这种话。直接给方案，给代码，给解释。## 说话方式- 聊技术的时候严谨，像在做 code review- 日常交流简短随和，像个靠谱同事- 拿不准的事直说"我不确定"，绝不瞎编## 底线- 没把握的事不接- 改配置之前一定先备份- 涉及删除、重启这类操作，必须确认

AGENTS.md — 相当于岗位说明书。规定它负责什么、怎么干活、什么不能碰。

# AGENTS.md - 码爷## 职责全栈开发，侧重后端架构和 DevOps 自动化。## 干活流程1.先读代码，搞清楚现有架构2.出方案，跟用户对齐3.写代码，写测试4.跑通了再提交## 安全规矩- 绝不自动往远程仓库 push 代码- 不让删的文件坚决不删- 跑破坏性命令之前必须二次确认

一句话记住：IDENTITY 是工牌，SOUL 是性格，AGENTS 是岗位说明书。

这么拆的好处是改起来互不影响——想调性格不用动工作流，想改工作流不用碰性格。agent 少的时候感觉不明显，管五六个以上的时候就知道这种拆法有多省心了。

100多个专业人格四步装进 OpenClaw

前提：OpenClaw 装好了，git 装好了。

第一步：把仓库拉下来

git clone https://github.com/msitarzewski/agency-agents.gitcd agency-agents

第二步：转成 OpenClaw 的格式

bash ./scripts/convert.sh --tool openclaw

这条命令会扫描所有 agent 的源文件，按段落标题里的关键词自动切分，输出到 integrations/openclaw/ 目录。

切分规则很好理解：

• 标题里带 identity、communication、style、critical rule 的段落 → SOUL.md
• 其他段落（mission、workflow、deliverables 之类）→ AGENTS.md
• 文件头部的 emoji + vibe 字段 → IDENTITY.md

第三步：安装

bash ./scripts/install.sh --tool openclaw

脚本会把转好的文件复制到 ~/.openclaw/agency-agents/ 下面，一个 agent 一个文件夹：

~/.openclaw/agency-agents/├── ui-designer/│   ├── SOUL.md│   ├── AGENTS.md│   └── IDENTITY.md├── frontend-developer/│   ├── SOUL.md│   ├── AGENTS.md│   └── IDENTITY.md├── security-engineer/│   └── ...└── ...

如果你装了 openclaw 命令行工具，脚本会自动跑 openclaw agents add 把 agent 注册上。要是没注册成功，手动跑 openclaw agents add <agent名> 一个个加也行。

第四步：重启

openclaw gateway restart

搞定。上百个 agent 直接能用。

自己写才是正经本事

现成的 agent 应付通用场景够了，但真正顺手的 agent 一定是你自己定义的——毕竟只有你知道自己的活怎么干。

仓库里的文件结构就是现成模板，照着写就完事。

IDENTITY.md：半分钟的事

Name: 运维老王 (Code Master)Creature: 干了二十年运维Vibe: 专业、见过的生产事故比你写过的代码还多。稳字当头，不搞花活。Emoji: 🏛️Avatar: (待定)

这几行就够。OpenClaw 每次新对话都会把这个文件加载到模型的上下文，相当于给 agent 钉了个永久铭牌。

SOUL.md：最值得花时间的地方

这个文件决定 agent 的底色，写好它就三条：

第一条：开头别说废话。

不要写：

你是一个专业的 AI 助手，擅长……

要写：

别演，别端着。不用说"很高兴为您服务"，直接解决问题。

agent 每次跟你对话都会加载这个文件，废话多一行，有用的指令就被稀释一分。

第二条：写具体动作，别写抽象品质。

“你应该保持专业、高效、友好”——说了等于没说。换成实打实的行为要求：

## 说话方式- 先给结论，再解释，最后上代码- 拿不准就说"我不确定"，别硬编- 发现用户方向不对，直说，别顺着哄## 底线- 改线上配置之前必须确认有备份- 没测试验证过的方案，不许说"应该没问题"- 自己搞不定的事，推荐靠谱的工具或者找人

第三条：画红线比吹能力重要。

agent 天生什么都想揽，靠谱的 agent 得知道什么时候该说"这事我不碰"。底线段落写得好不好，直接决定这个 agent 用起来让不让人放心。

AGENTS.md：三件事讲清楚

干什么、怎么干、什么不能干：

# AGENTS.md - 运维老王## 职责服务器运维、监控告警处理、自动化部署脚本编写、故障排查。## 干活流程1. 收到问题先看日志，不是先猜2. 定位到根因再出方案，评估风险3. 高风险操作必须等维护窗口4. 干完之后验证服务状态，确认恢复正常## 安全规矩- 业务高峰期不动生产环境- 所有 rm 操作先 dry-run- 动数据库之前先备份- 没拿到明确授权不许重启线上服务## 交付物- 故障报告：时间线 + 根因 + 修复方案 + 预防措施- 运维脚本：带注释、带回滚方案、带执行前检查

安全规矩这段必须有。 不写这个，agent 哪天手一抖给你删个文件、重启个服务，哭都来不及——社区里踩这个坑的人不少。

三个文件写好，在 openclaw.json 里引用：

{  "agents": {    "defaults": {      "model": "anthropic/claude-sonnet-4-6"    },    "list": {      "ops-wang": {        "id": "ops-wang",        "name": "运维老王",        "model": "bailian/kimi-k2.5",        "systemPrompt": "file://~/.openclaw/workspace-ops-wang/SOUL.md",        "tools": ["read", "write", "edit", "exec"]      }    }  }}

systemPrompt 用 file:// 协议指向 SOUL.md 的路径。改完之后别急着重启：

# 先验证 JSON 语法没写错python3 -c "import json; json.load(open('openclaw.json'))"# 没报错再重启openclaw gateway restart

改配置之前先备份，改完先验证再重启。 养成这个习惯，能帮你绕过大部分低级错误。

两个马上能用的技巧

加一个 USER.md。

agency-agents 不会帮你生成这个文件，但自己加一个，agent 的表现会不一样：

- 称呼：老板- 时区：Asia/Shanghai- 角色：全栈开发，偏后端- 语言：中文回复，技术术语保留英文- 风格：别啰嗦，直接说重点

这个文件告诉 agent"你在跟谁说话"。OpenClaw 每轮对话前都会加载它，等于给 agent 装了个记忆——永远记得你是谁、你喜欢什么风格。

别自己从头写，找个像的改。

仓库里挑一个跟你需求最接近的文件当底子就行。比如你要搞个前端助手，直接拿 engineering/engineering-frontend-developer.md，改改性格描述和干活流程，比对着空白文件干瞪眼强多了。

最后说一句

OpenClaw 之所以让人越用越上头，核心原因就是：它把跟 AI 协作这件事的门槛，降到了"会写 Markdown 就行"。

门槛低了，决定体验的就不再是技术能力，而是你那几个 .md 文件写得好不好。

agency-agents 给了上百个现成样板，也给了一套写法——性格和岗位分开写、规则要落到具体动作、画红线比吹能力重要。

花十分钟装一下，挑几个 agent 看看别人怎么写的。然后从改一个现成的开始，慢慢搭出你自己的 AI 团队。

既然看到这里了，如果觉得不错，随手点个👍🏻、❤️、转发三连吧

谢谢你看我的文章，我们，下次再见。