feishu-multi-agent-factory
by cchenwei
批量配置 OpenClaw 多 agent + 飞书 channel。当用户说「添加 agent」「新建 agent」「配置飞书」「批量创建 agent」「添加新机器人」时触发。通过对话引导收集信息,一键写入 openclaw.json 并初始化工作区。
安装
claude skill add --url https://github.com/openclaw/skills文档
Agent Factory — 多 agent 批量配置向导
通过对话快速创建新 agent,自动完成所有配置:
- 写入
openclaw.json(agents / feishu accounts / bindings) - 创建 workspace 目录 + IDENTITY.md 等基础文件
- 创建 agentDir + defaults.json + auth-profiles.json
核心脚本
code
~/.openclaw/workspace/skills/feishu-multi-agent-factory/scripts/setup_agents.py
对话示例
用户说:
code
帮我创建2个 agent:
1. id: painter,图片处理专家🌞,飞书 AppId: <PAINTER_APP_ID>,Secret: <PAINTER_SECRET>
2. id: take,行业资讯抓手👋,飞书 AppId: <TAKE_APP_ID>,Secret: <TAKE_SECRET>
你的回应(先 dry-run 确认):
code
好的,我来预览一下即将创建的配置:
▶ 🌞 图片处理专家 (id: painter)
• workspace → ~/.openclaw/workspace-painter/
• agentDir → ~/.openclaw/agents/painter/agent/
• 飞书 account 'painter' 已配置
▶ 👋 行业资讯抓手 (id: take)
• workspace → ~/.openclaw/workspace-take/
• agentDir → ~/.openclaw/agents/take/agent/
• 飞书 account 'take' 已配置
确认执行吗?
用户确认后执行,回应:
code
✅ 创建: 2 个
新 agents: painter, take
请运行 `openclaw configure` 为各 agent 配置 API key。
已重启 gateway,两个飞书机器人上线后即可收发消息。
对话流程
第一步:收集信息
用户说想添加新 agent 时,按以下格式引导(可批量,一次多个):
code
我需要以下信息来创建 agent:
1. **Agent ID**(英文小写,如 `coder`、`hr-bot`)
2. **中文名称**(如「代码专家」)
3. **Emoji**(如 💻)
4. **飞书 App ID**(格式:cli_xxxxxxxx)
5. **飞书 App Secret**
6. **简介**(可选)
可以一次提供多个,直接列出来就行。
第二步:确认预览(dry-run)
收到信息后,先 dry-run 预览,确认无误再执行:
bash
python3 ~/.openclaw/workspace/skills/feishu-multi-agent-factory/scripts/setup_agents.py \
--dry-run \
--config '<JSON>'
第三步:执行创建
用户确认后,正式执行并重启 gateway:
bash
python3 ~/.openclaw/workspace/skills/feishu-multi-agent-factory/scripts/setup_agents.py \
--config '<JSON>' \
--restart
JSON 格式
json
{
"agents": [
{
"id": "coder",
"name": "代码专家",
"emoji": "💻",
"description": "负责写代码和 code review",
"feishu_app_id": "<YOUR_APP_ID>",
"feishu_app_secret": "<YOUR_APP_SECRET>"
},
{
"id": "hr-bot",
"name": "HR 助手",
"emoji": "👔",
"feishu_app_id": "<YOUR_APP_ID>",
"feishu_app_secret": "<YOUR_APP_SECRET>"
}
]
}
其他命令
查看当前所有 agents
bash
python3 ~/.openclaw/workspace/skills/feishu-multi-agent-factory/scripts/setup_agents.py --list
删除某个 agent(仅移除配置,不删目录)
bash
python3 ~/.openclaw/workspace/skills/feishu-multi-agent-factory/scripts/setup_agents.py --remove <id>
自动完成的事项清单
每个新 agent 执行完成后会自动:
| 步骤 | 内容 |
|---|---|
| ✅ workspace 目录 | ~/.openclaw/workspace-{id}/ |
| ✅ IDENTITY.md | 包含名称、emoji、描述 |
| ✅ SOUL / AGENTS / TOOLS.md | 基础工作区文件 |
| ✅ agentDir | ~/.openclaw/agents/{id}/agent/ |
| ✅ defaults.json | 继承全局模型配置 |
| ✅ auth-profiles.json | 从 main agent 复制 |
| ✅ agents.list | 写入 openclaw.json |
| ✅ feishu accounts | 写入 openclaw.json |
| ✅ bindings | agent ↔ feishu account |
| ✅ agentToAgent.allow | 加入协作白名单 |
飞书 App 说明
每个 agent 对应一个独立的飞书机器人应用(需在飞书开放平台预先创建)。
需要的权限(在飞书开放平台开通):
im:message— 收发消息im:message.group_at_msg— 群消息 @ 机器人
连接模式默认为 websocket(长连接),无需公网 IP。
常见问题
Q: 飞书凭据在哪里找? 飞书开放平台 → 我的应用 → 选择应用 → 凭证与基础信息 → App ID / App Secret
Q: 创建后 agent 没反应?
确认已运行 openclaw gateway restart,并在飞书开放平台确认机器人已上线。
Q: 想给某个 agent 单独设置模型?
创建完成后编辑 ~/.openclaw/agents/{id}/agent/defaults.json,修改 model.primary。