| name | feishu-multi-agent |
| description | 飞书多 Agent 系统搭建指南。当用户要求创建新的功能 Agent、配置飞书群聊绑定、
搭建多 Agent 协作系统时激活此 skill。
触发词:创建 agent、新建 agent、添加 agent、create agent、多 agent、飞书绑定。
|
飞书多 Agent 系统
你要做什么
帮用户搭建「一个飞书 Bot → 多个独立 AI Agent」的系统。每个 Agent 绑定一个飞书群聊,互相独立,可以通信。
读取顺序(严格按顺序)
第一步:理解架构
read("INDEX.md") # 文档索引
read("01-architecture.md") # 架构设计
读完你会知道:binding、session、agent 间通信的概念。
第二步:收集用户信息
read("10-setup-wizard.md")
read("examples/PLACEHOLDERS.md")
读完按 Phase 1 的问卷向用户收集信息。PLACEHOLDERS.md 列出了所有需要用户提供的字段。不要跳过任何问题。
第三步:执行创建
用户回答完问题后,运行创建脚本:
read("scripts/create_agent.py")
exec("python3 scripts/create_agent.py --agent-id xxx --role xxx ...")
第四步:按需深入
- 用户问飞书权限 →
read("02-feishu-setup.md")
- 用户问 Agent 绑定 →
read("03-agent-binding.md")
- 用户问 Agent 通信 →
read("04-agent-communication.md")
- 用户问飞书文档 →
read("05-feishu-doc.md")
- 用户问群聊管理 →
read("06-feishu-chat-management.md")
- 用户问消息格式 →
read("07-feishu-message-format.md")
- 用户问 skill 组织 →
read("08-skill-organization.md")
- 用户问最佳实践 →
read("09-best-practices.md")
⚠️ 关键注意事项
- 不要一次读所有文件 — 按需读取,节省上下文
- 不要跳过信息收集 — 缺少 app_id/open_id 后面全部会失败
- 修改 openclaw.json 必须包含所有 Agent — agents.list 是整体替换,遗漏 = 丢失
- 创建群聊后必须注册 — 加 binding + groups 配置 + 重启 gateway
- Bot 创建的文档必须授权 — 否则用户看不到
🔧 项目维护(仅供维护者)
如果你要修改项目本身(如添加新 Agent、修改配置格式、更新文档),必须先阅读:
read("skills/maintenance/SKILL.md")
read("skills/maintenance/references/project-maintenance.md")
⚠️ 开发原则(强制遵守):
- 强制脱敏:模型 ID、内部事故记录、真实路径、API Key 等均为敏感信息,示例中用占位符
- 内容通用性:开源内容面向所有用户,不包含特定团队的内部信息
- 提交前必须运行脱敏检查:
python3 scripts/check_sensitive.py
违反原则的提交将被拒绝合并。