| name | huo15-openclaw-multi-agent |
| displayName | 火一五多智能体技能 |
| description | 火一五多智能体协同 - 基于 OpenClaw sessions_spawn 的多 Agent 并行工作系统。支持协调者模式、任务分配、结果汇总。触发词：多智能体协同、多 Agent、并行任务、协调者模式。 |
| version | 2.3.0 |
| dependencies | {"optional":["huo15-memory-evolution","huo15-cost-tracker"]} |
| aliases | ["火一五多智能体技能","火一五多Agent技能","火一五协调者技能","火一五并行任务技能","火一五Agent协同技能","多智能体","multi agent","sessions_spawn"] |
🤖 火一五多智能体协同 (huo15-multi-agent)
作者: 火一五信息科技有限公司
版本: v2.3.0
基于: OpenClaw sessions_spawn(对齐 2026.6.8 官方 docs/tools/subagents.md)
一、核心概念
| 概念 | 说明 |
|---|
| Coordinator | 主 Agent，协调任务分配 |
| Worker | 工作 Agent，执行具体任务 |
| sessions_spawn | OpenClaw 内置派生子 Agent |
| announce | 结果自动汇报给主 Agent |
OpenClaw subagent 架构
主 Agent (depth 0)
↓ sessions_spawn
Worker A (depth 1) ─┐
Worker B (depth 1) ─┼─ 执行中...
Worker C (depth 1) ─┘
↓ announce 汇报
主 Agent ← 接收结果汇总
二、使用方式
2.1 协调者模式触发
当用户说"帮我同时处理..."时：
用户: "帮我同时分析这三个项目的代码"
↓
我: "好的，启动协调者模式，分3个并行任务"
↓
使用 sessions_spawn 启动 3 个 Worker
↓
Worker 们并行执行，完成后 announce 结果
↓
汇总结果，报告给用户
2.2 命令参考
| 命令 | 说明 |
|---|
/subagents list | 查看当前会话的子 Agent |
/subagents log <id 或 #> [limit] [tools] | 查看子 Agent 日志 |
/subagents info <id 或 #> | 运行元信息(状态/时间/会话id/transcript) |
⚠️ 没有 /subagents spawn 或 kill:派生用工具 sessions_spawn;停止/清理由运行超时 + 自动归档(archiveAfterMinutes,默认 60 分钟)管理。线程绑定另有 /focus /unfocus /agents。
2.3 编程接口
sessions_spawn({
task: "分析代码仓库 A",
label: "code-analyzer-a",
taskName: "analyze_repo_a",
context: "isolated"
})
sessions_yield()
subagents()
三、工作流程(push 完成模型,非轮询)
openclaw 官方铁律:sessions_spawn 非阻塞,完成是 push 的。派生后不要用 Promise.all / sessions_history / sessions_list / sleep 轮询等结果——用 sessions_yield。
3.1 派生并行任务
sessions_spawn({ task: "分析模块 A", taskName: "module_a" })
sessions_spawn({ task: "分析模块 B", taskName: "module_b" })
sessions_spawn({ task: "分析模块 C", taskName: "module_c" })
3.2 让出本轮,等完成事件
sessions_yield()
完成后 openclaw 把每个子 Agent 结果以 agent 回合 announce 回当前会话;活动期间还会注入 Active Subagents 块让你看到状态,无需轮询。
3.3 汇总报告
子结果到达后,协调者(主 Agent)综合各 Worker 的 announce 内容,核对后再决定是否给用户最终答复。需回看某子 Agent 历史时用 sessions_history(有界、安全过滤)——仅按需调用,不要循环。
四、配置
4.1 OpenClaw 配置
在 ~/.openclaw/openclaw.json(键路径 agents.defaults.subagents):
{
agents: {
defaults: {
subagents: {
maxSpawnDepth: 2, // 默认 1(子 Agent 不能再派生);设 2 开启一层嵌套(orchestrator)
maxChildrenPerAgent: 5, // 每 Agent 同时活动子数上限(默认 5)
maxConcurrent: 8, // 全局并发上限(默认 8)
runTimeoutSeconds: 900, // sessions_spawn 默认超时秒(0=不超时)
model: "MiniMax-M2.1", // 子 Agent 默认模型(省钱;留空=继承主 Agent)
},
},
},
}
4.2 开启 sessions_spawn 工具
coding / full 工具档默认暴露 sessions_spawn;messaging 档不暴露。要让某 Agent 能派生:
{
agents: {
list: [{
id: "coordinator",
tools: {
// 二选一:整档切 coding,或在现档基础上追加这几个工具
profile: "coding",
alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
},
}],
},
}
用 /tools 查当前会话生效的工具列表确认。
五、最佳实践
5.1 任务拆分原则
- 每个 Worker 任务独立，不依赖其他 Worker
- 任务时长建议 5-30 分钟
- 嵌套上限 depth 2:主(0)→ 编排子(1)→ leaf worker(2),leaf 不能再派生;默认
maxSpawnDepth: 1 即不嵌套
5.2 成本控制
sessions_spawn({
task: "简单分析",
model: "MiniMax-M2.1"
})
5.3 错误处理
try {
const result = await sessions_spawn({
task: "可能失败的任务"
})
} catch (e) {
reportError(e)
}
六、与传统方式对比
| 方式 | 同步 | 并行 | 结果汇总 |
|---|
| 顺序执行 | ✅ | ❌ | 手动 |
| 传统 skill | ⚠️ | ⚠️ | 手动 |
| sessions_spawn | ❌ | ✅ | 自动 announce |
七、版本历史
| 版本 | 日期 | 更新内容 |
|---|
| v2.3.0 | 2026-06-20 | 按 2026.6.8 官方 docs/tools/subagents.md 校正:/subagents 子命令(list/log/info)、push 完成模型 + sessions_yield(替代轮询)、移除非法 per-call runTimeoutSeconds、配置文件改 openclaw.json + 工具档 tools.profile/alsoAllow、嵌套 depth 语义 |
| v2.0.0 | 2026-04-05 | 集成 OpenClaw sessions_spawn |
| v1.0.0 | 2026-04-05 | 初始版本（纯脚本） |
