
multi-agent-cn 实战:如何用一个技能打造你的AI团队
multi-agent-cn技能实战指南:从安装配置到真实场景,4大踩坑记录,和其他技能的配合方案,以及SFD实验室13人团队的完整使用经验。
📋 实验室验证报告
这个技能是干啥的
multi-agent-cn 是一个中文版的多Agent调度框架,装上之后你的主Agent就变成了纯调度员——它只接收任务、分配给子Agent、汇报结果,不亲自干活。
听起来很简单,但这是一个思维范式的转变:从"一个AI帮你做所有事"变成"一个CEO带着团队做所有事"。
这正是小火龙实验室架构的起点。我们的13个Agent系统,本质上就是这套调度思路的进化版。
安装和配置
# 在OpenClaw CLI里安装
clawhub install multi-agent-cn
或者直接从clawhub.ai下载SKILL.md,放到你的skills目录
~/.openclaw/workspace/skills/multi-agent-cn/SKILL.md
安装后的第一步:自定义你的团队。打开SKILL.md,找到"自定义配置"部分:
- 调度员角色:默认是"指挥官",可以改成CEO、船长、总监——改成和你项目氛围匹配的角色
- 子Agent名字:默认是Alpha到Echo,可以改成真实的团队角色名,比如"前端小王"、"后端小李"
- sessionKey:每个子Agent用固定的sessionKey,确保对话持久化,同一个Agent不会因为session重开而换人
我们的实际配置
# SFD Lab的调度员配置(简化版)
调度员:小火龙🔥(首席执行官)
子Agent:
- 变色龙🦎 (chameleon) → 前端开发
- 小章鱼🐙 (octopus) → 后端开发
- 小狐狸🦊 (fox) → 文案内容
- 小猎鹰🦅 (hawk) → 安全审计
- 小蜜蜂🐝 (bee) → 运维部署
实战使用场景
场景1:内容发布流水线
老板说:"今天写一篇关于AI记忆的科普文章,发到SFD网站"
调度员(小火龙)的动作:
- → 派给小狐狸🦊:写文章内容(三语:中/英/繁)
- → 派给小蝴蝶🦋:生成封面图
- → 派给小章鱼🐙:通过CMS API发布
- → 派给小刺猬🦔:验收确认文章正常显示
调度员全程不写一行内容、不生成一张图、不发一个API请求。它只知道"任务完成了没有"。
场景2:代码修复流水线
收到验收报告:前端某页面布局错位
- → 派给变色龙🦎:修复CSS(走ACP,读整个项目后修改)
- → 派给小猎鹰🦅:安全审计(确认没有引入新漏洞)
- → 派给小蜜蜂🐝:部署(按变更清单替换文件)
- → 派给小刺猬🦔:验收(截图确认布局正常)
踩坑记录
坑1:sessionKey重复导致角色混乱
最开始我们没有给每个Agent设置固定的sessionKey,导致"前端小王"有时被当成"后端小李"来用。解决方案:在SKILL.md里给每个角色设定唯一且固定的sessionKey,一旦确定不要改。
坑2:调度员忍不住"顺手干了"
这是最常见的问题。调度员开始觉得"这个任务很简单,我直接做算了"——然后开始用exec工具、开始写代码。一旦调度员开始执行,整个角色分工就崩了。
解决方案:在SKILL.md的"核心约束"里写死:调度员不能使用任何执行工具。每次心跳前先读这条。
坑3:子Agent没有记忆,每次从零开始
sessions_spawn创建的子Agent是无状态的——除非你主动传上下文。解决方案:派任务时在task参数里附上必要的背景信息,比如"读项目的design-spec.md后再开始"。
坑4:回调丢失
sessions_spawn之后有时候回调消息不来。解决方案:不依赖回调!调度员主动检查:查文件修改时间、查build产物、查git log——"完成了没有"不靠等推送,靠主动拉取。
和其他技能的配合
- multi-agent-cn + coding-agent:调度员用sessions_spawn派子Agent,子Agent走ACP(runtime="acp")读整个项目写代码,效果远好于直接subagent
- multi-agent-cn + self-evolution:子Agent完成任务后自动更新LEARNINGS.md,调度员定期读取提炼到MEMORY.md
- multi-agent-cn + daily-trending:调度员每天早上派"情报员"子Agent去抓热榜,整理后派给"内容官"子Agent写文章
SFD实验室怎么用的
我们是这套技能的"全球最重度用户"之一。13个Agent、每天几十个任务、三个不同渠道——全靠这套调度思路撑着。
和原版的最大区别:我们把子Agent从5个扩展到了13个,每个都有专属角色、专属SOUL.md、专属MEMORY.md。调度员(小火龙)不只是分配任务,还负责:
- 发现接棒断裂 → 立刻补上
- 验收不通过 → 继续修
- 脚本定期巡检 → 不漏一个任务
如果你刚开始搭建自己的AI团队,从这个技能开始,是最快的路。
SFD编者注:一个AI帮你干活,是工具。一组AI互相配合,才是团队。multi-agent-cn是这条路的入口。装上它,先感受一下"让AI管AI"是什么感觉。
⚙️ 安装与赋能
clawhub install multi-agent-cn-build-ai-team-practical-guide安装后在你的 Agent 配置中启用此技能,重启 Agent 即可生效。