clawhub install collaboration-manager📖 About This Skill
name: collaboration-manager description: 多 Agent 协作管理器，支持动态 @ 组合、任务分配、智能响应 emoji: 🤝
Collaboration Manager Skill
⚠️ 重要：这个 skill 的规则在群聊中优先于 AGENTS.md 的通用群聊规则。
🚨 第一条规则：@优先
当收到群聊消息时，第一件事检查是否被@：
| 情况 | 你的行为 | |------|---------| | 消息@了你 | 必须响应 | | 消息@了其他agents，但没@你 | 绝对不要响应（保持沉默） | | 消息没有@任何人 | 根据关键词判断是否响应 | | 通用问候（"大家好"） | 只有Juna响应，其他agents保持沉默 |
多 Agent 群聊协作管理器，支持：
⚡ 快速响应规则
你是哪个 Agent？
在群聊中响应之前，先确认你的身份：
| Agent | 关键词特征 | 响应优先级 | |-------|-----------|-----------| | Juna (main) | 问候、闲聊、通用帮助、建议、讨论 | 高 | | Code Master | 代码、开发、bug、调试、API、前端/后端 | 高（技术问题）| | CEVA | 股票、投资、市场、行情、财务分析 | 高（投资问题）| | System Engineer | 系统、架构、部署、微服务、分布式、安全 | 高（架构问题）| | 102 Housekeeper | 任务、日程、提醒、待办、计划 | 高（任务管理）|
何时响应？
#### 🔴 最重要规则：检查是否被@
在决定是否响应之前，首先检查这条消息是否@了你：
#### ✅ 你应该响应的情况
1. 消息中 @ 了你 - 直接被点名，必须响应（最高优先级） 2. 消息没有@任何人，但包含你的关键词 - 相关问题，可以响应 3. 通用问候/聊天（仅Juna） - "大家好"、"你好"等，只有Juna应该响应 4. 你被明确请求 - "请帮忙..."
#### ❌ 你不应该响应的情况
1. 消息 @ 了其他 agent 但没有你 - 硬规则，绝对不要响应 2. 消息内容完全无关 - 不属于你的专业领域 3. 已经有 agent 回答了 - 避免重复回答（除非补充信息） 4. 简单确认消息 - "OK"、"收到"等不需要 AI 响应
响应策略
1. 先判断 - 这条消息与我有关吗？ 2. 看其他人 - 已经有 agent 回答了吗？ 3. 简洁回复 - 一句话能说完就不要长篇大论 4. 避免刷屏 - 不要和多个 agents 同时回答同样的问题
适用场景
场景 1：普通消息
成员发送普通消息，相关 agent 主动判断并响应。场景 2：@ 特定 agent
@Juna @System Engineer 帮我设计一个系统架构
场景 3：@ 多个 agent（动态协作）
@SystemEngineer @CodeMaster @CEVA 协作完成用户管理系统
场景 4：用户控制
停止所有 agent 讨论
配置
Agent 身份识别
每个 agent 需要知道自己的 openId，可以从飞书配置中获取：
{
"Juna": "ou_c917d9b06ff30b98c4f45c79219164d5",
"CodeMaster": "ou_xxx3",
"CEVA": "ou_xxx4",
"SystemEngineer": "ou_xxx5",
"102Housekeeper": "ou_xxx6"
}
注意：当前配置中所有 agents 使用相同的 openId（ou_c917d9b06ff30b98c4f45c79219164d5），这意味着：
sender_id 或应用 ID 来区分群组 chat_id
当前配置的群聊 ID：oc_c1184c07fa8fe0a6eced5e069f8b73b5
飞书成员 open_id 列表
{
"members": {
"user_1": "ou_xxx1",
"user_2": "ou_xxx2"
},
"agents": {
"Juna": "ou_c917d9b06ff30b98c4f45c79219164d5",
"SystemEngineer": "ou_xxx3",
"CodeMaster": "ou_xxx4",
"CEVA": "ou_xxx5",
"102Housekeeper": "ou_xxx6"
}
}
群组 chat_id
{
"mainGroup": "oc_xxx",
"collaborationGroup": "oc_yyy"
}
智能判断逻辑
相关性判断
Agent 相关性规则：
| 关键词 | 相关 Agent | 示例 | |--------|-----------|------| | 问候、闲聊、通用帮助 | Juna | "大家好"、"帮忙"、"建议" | | 系统架构、设计、部署 | System Engineer | "架构设计"、"服务器部署"、"微服务" | | 代码、开发、bug | Code Master | "这段代码有问题"、"API 接口"、"前端框架" | | 投资、股票、市场 | CEVA | "股票分析"、"投资建议"、"市场行情" | | 任务、日程、提醒 | 102 Housekeeper | "帮我记录任务"、"日程安排"、"待办清单" |
判断流程： 1. 提取消息中的关键词 2. 匹配相关 agents 3. 如果匹配成功，标记为相关 4. 最多响应 3 个相关 agents（避免刷屏）
@mentions 优先
规则： 1. 如果消息 @ 了特定 agents，只有被 @ 的 agents 响应 2. 未被 @ 的 agents 保持沉默 3. 除非消息同时是通用问候（"大家好"）
示例：
@CodeMaster @CEVA 协作完成用户系统
@ 逻辑
规则： 1. 提取所有被 @ 的 agent 名称 2. 查询配置中的 open_id 3. 验证 agent 是否在当前群组中 4. 返回有效 agent 列表
协作协调：
协作流程
开始协作
主 Coordinator： 1. 确认任务理解 2. 分配子任务给协作者 3. 设定协作模式（并行/串行） 4. 跟踪进度
协作者： 1. 执行分配的子任务 2. 定期汇报进度 3. 关注其他协作者的意见 4. 请求反馈或帮助
协作模式
#### 并行协作 适用场景：独立任务（如不同模块开发）
@SystemEngineer @CodeMaster
System Engineer: 负责后端 API 设计
Code Master: 负责前端开发
#### 串行协作 适用场景：依赖性任务（如架构评审后实现）
@SystemEngineer @CodeMaster @CEVA
System Engineer: 设计数据库架构
CEVA: 审计数据库安全
Code Master: 根据设计实现
任务分配
任务结构
{
"taskId": "task_20260306_001",
"title": "用户管理系统开发",
"description": "完整的用户管理系统",
"coordinator": "SystemEngineer",
"collaborators": ["CodeMaster", "CEVA", "102Housekeeper"],
"status": "in_progress",
"mode": "parallel",
"subtasks": [
{
"id": "subtask_001",
"title": "数据库设计",
"assignee": "SystemEngineer",
"status": "in_progress"
},
{
"id": "subtask_002",
"title": "后端 API 开发",
"assignee": "CodeMaster",
"status": "pending"
},
{
"id": "subtask_003",
"title": "安全审计",
"assignee": "CEVA",
"status": "pending"
},
{
"id": "subtask_004",
"title": "任务管理",
"assignee": "102Housekeeper",
"status": "pending"
}
]
}
停止/恢复机制
停止命令
只有配置的成员（用户的 open_id）可以发送：
停止当前协作
所有 agent 停止响应当前任务。
恢复命令
恢复协作
所有 agent 恢复响应能力。
临时静音
Juna 静音 5 分钟
只有 Juna 静音，其他 agents 继续协作。
消息格式
协作开始
🤝 协作开始任务：{title}
主协调者：{coordinator}
协作者：{collaborators}
模式：{mode}
开始分配子任务...
进度更新
📊 进度更新任务：{taskId}
汇报人：{reporter}
状态：{status}
{details}
协作完成
✅ 协作完成任务：{title}
完成时间：{completionTime}
总耗时：{duration}
总结：
{summary}
协作停止
⏸️ 协作已停止停止人：{requester}
停止时间：{stopTime}
协作已暂停，使用"恢复协作"继续。
注意事项
防止刷屏
理解歧义
状态一致性
飞书消息卡片
协作开始卡片
{
"msg_type": "interactive",
"card": {
"header": {
"title": "🤝 协作开始",
"template": "blue"
},
"elements": [
{
"tag": "div",
"text": {
"tag": "lark_md",
"content": "任务：{title}\n\n主协调者：{coordinator}\n\n协作者：{collaborators}"
}
},
{
"tag": "div",
"text": {
"tag": "lark_md",
"content": "模式：{mode}\n\n---\n{subtaskList}"
}
}
]
}
}
进度更新卡片
{
"msg_type": "interactive",
"card": {
"header": {
"title": "📊 进度更新",
"template": "green"
},
"elements": [
{
"tag": "div",
"text": {
"tag": "lark_md",
"content": "任务：{title}\n\n进度：{progress}%"
}
}
]
}
}
使用示例
示例 1：通用问候 - 只有 Juna 响应
用户消息：
大家好
响应：
示例 2：技术问题 - Code Master 响应
用户消息：
这段代码有 bug，帮我看看
响应：
示例 3：投资问题 - CEVA 响应
用户消息：
最近股票市场怎么样
响应：
示例 4：@ 多个 agents - 协作响应
用户消息：
@CodeMaster @SystemEngineer 帮我设计一个后端系统
响应：
示例 5：任务管理 - 102 Housekeeper 响应
用户消息：
帮我记录一下：明天下午 3 点开会
响应：
普通消息 - 自动响应
用户消息：
帮我优化一下系统性能
自动响应（相关 agents 判断）：
@ 单个 agent
用户消息：
@Juna 帮我设计数据库架构
响应：
@ 多个 agent - 协作模式
用户消息：
@SystemEngineer @CodeMaster @CEVA 协作完成用户管理系统
协作开始（主 coordinator = System Engineer）：
后续协作：
故障排除
❌ 问题 1：发了消息没有任何 agent 响应
可能原因： 1. Gateway 没有重启，agents 没有加载 skill 2. groupPolicy 配置问题，agents 不在群组白名单 3. 飞书机器人没有加入群聊 4. 消息事件订阅没有启用
解决方法：
1. 重启 Gateway：openclaw gateway restart
2. 检查 groupAllowFrom：确认群聊 ID 在允许列表中
3. 检查群成员：确保所有飞书机器人都加入了群聊
4. 查看日志：openclaw logs --follow | grep feishu
❌ 问题 2：多个 agents 同时响应同一问题
可能原因： 1. 关键词匹配冲突 2. agents 没有检查是否已有响应
解决方法： 1. 优化关键词，避免重叠 2. 在响应前检查历史消息 3. 使用明确的 @ 指定特定的 agent
❌ 问题 3：@ 某个 agent 但它不响应
可能原因： 1. agent 的 openId 配置错误 2. 该 agent 的技能或配置有问题
解决方法：
1. 检查 config.json 中的 openId
2. 查看该 agent 的日志：openclaw logs --follow | grep
更新日志
*适用场景：多 agent 协作群聊、任务分配、智能路由*
📝 配置文件说明
config.json 结构
{
"chatId": "oc_xxx", // 群聊 ID
"members": ["ou_xxx"], // 成员 openId 列表
"agents": [ // Agents 配置
{
"id": "main", // Agent ID（与 openclaw.json 中一致）
"name": "Juna", // 显示名称
"openId": "ou_xxx", // 飞书 openId（需要配置）
"keywords": [...], // 关键词列表
"alwaysRespond": false // 是否总是响应
}
]
}
⚠️ 重要：每个 agent 需要独立的 openId
当前问题：所有 agents 使用相同的 openId (ou_c917d9b06ff30b98c4f45c79219164d5)，导致无法通过 @ 区分 agents。
解决方案：为每个 agent 配置独立的 openId，或使用飞书消息的应用 ID 来区分。
飞书机器人配置
每个 agent 都需要：
1. 独立的飞书应用（App ID + App Secret）
2. 应用已安装到飞书账号
3. 机器人已加入到群聊中
4. 事件订阅已启用（im.message.receive_v1）