此向导可帮助 OpenClaw 新手快速完成 飞书多机器人账号 与 多 Agent 的路由配置,支持完全隔离的工作空间和自定义人设。
- 零代码环境探测:自动收集本机 OpenClaw 运行版本、现有 Agent 列表和已绑定的飞书账号。
- 多轮渐进式对话:用最少的对话(通常1-2轮)引导用户完成配置,只询问用户才知道的关键信息(如
App ID,App Secret, 人设名称等)。 - 自动化构建:自带
scripts/apply_agents.py辅助脚本,一键生成config.patchJSON 片段,并自动生成 Agent 所需的 7 个完整基础配置文件(SOUL.md,IDENTITY.md,AGENTS.md等)。 - 安全重启保障:使用
gateway config.patch与 SIGUSR1 热重启,避免配置断连和回滚。
feishu-multi-agent/
├── SKILL.md # 核心向导脚本,规范对话与预检流程
├── README.md # 本文件
├── scripts/
│ └── apply_agents.py # 配置应用脚本,支持一键创建完整的 workspace 骨架
└── references/
├── config-schema.md # 详细的配置字段结构与防踩坑记录
└── routing.md # 各种飞书路由方案(按账号、群组、私聊等)
当用户提到以下触发词时,本 Skill 会被激活:
- "飞书多 Agent"
- "飞书多机器人"
- "配置多个飞书"
- "飞书 Agent 路由"
- "feishu multi-agent"
- Schema 键值约束:飞书多账号配置在
channels.feishu.accounts下,路由规则由外层的bindings定义。请勿使用类似plugins.entries.feishu-xxx的非法路径。 - 严禁 systemctl 重启:
systemctl restart在遭遇 schema 校验错误时会自动回滚备份。所有配置修改必须使用gateway config.patch。 - Workspace 完整性:Agent 工作空间需要至少 7 个核心文件作为上下文支撑,脚本已集成生成模板功能。