OpenClaw 多Agent配置指南
OpenClaw 多Agent协同架构配置精要
本指南详解如何配置飞书多机器人Agent架构，实现专业化任务分派与团队化内容生产流程。
1. 架构设计概述
多Agent配置的核心在于角色专业化，通过精细化分工提升生产效能与内容一致性：
- main：项目总控Agent，负责指令分发、进度追踪与最终交付
- architect：架构规划Agent，专注世界观构建、故事线与结构设计
- writer：内容创作Agent，执行具体的叙事与文本生成任务
- quality：质量审核Agent，把控内容一致性、逻辑性与风格规范
2. 配置实施步骤
2.1 飞书应用矩阵创建
为每个Agent角色在飞书开放平台建立独立应用实体：
- 依次创建多个应用，并明确记录各应用的App ID与App Secret
- 逐一配置应用权限，确保具备完整的消息接收与发送能力
- 完成应用发布流程，获取线上运行状态
- 将各应用的“开发者测试机器人”添加至目标协作群组
2.2 openclaw.json核心配置文件修改
定位并编辑配置文件 ~/.openclaw/openclaw.json，建立Agent与飞书账户的映射关系：
{
"agents": {
"bindings": [
{
"agentId": "main",
"match": {
"channel": "feishu",
"accountId": "main"
}
},
{
"agentId": "architect",
"match": {
"channel": "feishu",
"accountId": "architect"
}
},
{
"agentId": "writer",
"match": {
"channel": "feishu",
"accountId": "writer"
}
},
{
"agentId": "quality",
"match": {
"channel": "feishu",
"accountId": "quality"
}
}
]
},
"channels": {
"feishu": {
"accounts": {
"main": {
"enabled": true,
"appId": "cli_xxx1",
"appSecret": "xxx"
},
"architect": {
"enabled": true,
"appId": "cli_xxx2",
"appSecret": "xxx"
},
"writer": {
"enabled": true,
"appId": "cli_xxx3",
"appSecret": "xxx"
},
"quality": {
"enabled": true,
"appId": "cli_xxx4",
"appSecret": "xxx"
}
}
}
},
"agents": {
"list": [
{
"id": "main",
"subagents": {
"allowAgents": ["architect", "writer", "quality"]
}
},
{
"id": "architect",
"name": "architect",
"workspace": "/path/to/workspace-architect"
},
{
"id": "writer",
"name": "writer",
"workspace": "/path/to/workspace-writer"
},
{
"id": "quality",
"name": "Quality",
"workspace": "/path/to/workspace-Quality"
}
]
}
}
2.3 独立工作空间初始化
为每个角色Agent创建专属的本地工作目录，确保数据隔离：
mkdir -p ~/.openclaw/workspace-architect
mkdir -p ~/.openclaw/workspace-writer
mkdir -p ~/.openclaw/workspace-Quality
2.4 Agent角色定义文件配置
进入各Agent工作空间，创建以下核心身份文件以明确其职责：
SOUL.md：定义Agent的核心行为准则、决策逻辑与专长领域IDENTITY.md：记录Agent的元数据、交互协议与上下文处理规则
3. 多Agent工作流详解
3.1 核心任务流转链路
用户指令 → main接收 → 派发至architect → (产出策划书) → main审核 → 派发至writer → (产出具体章节) → quality审核 → (通过) → main汇总 → 交付用户确认
3.2 任务派发机制
主控Agent（main）通过subagents功能向下级Agent发起任务调用：
使用命令行工具直接派发：
openclaw subagents spawn --agent writer --task "撰写第1章"
或在您的代码中通过API调用：
sessions_spawn(agentId="writer", task="撰写第1章")
4. 关键配置注意事项
- 飞书Bot实体独立性：切勿复用App ID，每个Agent必须对应一个独立的飞书应用及Bot实例
- 群聊集成是必须项：所有配置的Bot账号均需提前加入目标飞书群，否则无法触发消息流
- 事件订阅配置校验：在飞书开放平台确保已为每个应用正确配置“接收消息”等相关事件订阅URL
- 严格的工作空间隔离：为每个Agent配置不同的物理路径，避免文件与上下文数据污染
5. 配置问题诊断
Q: 如何在群聊中调用特定Agent？
A: 在飞书群消息中通过@功能，精确指定目标Bot的账号名称即可定向触发对应Agent。
Q: Bot配置后无响应？
A: 按顺序排查：1) 验证Bot在群成员列表中 2) 确认应用已完成“发布”而非仅保存草稿 3) 核对事件订阅URL已正确配置且网络可达
Q: 如何验证基础配置成功？
A: 在已加入的群聊中，@任一已配置的Bot并发送“/ping”或简短问候，观察其是否响应。