混合动态多Agent协作系统

核心定位

运行在OpenClaw之上的通用元级别协作系统，让单一主Agent能够动态创建、管理、协调多个临时子Agent，并行/串行完成复杂任务。

设计理念

轻量临时：子Agent都是临时创建，任务完成立即销毁，无长期资源占用
动态适配：不固定子Agent数量，完全根据任务复杂度按需分配
质量优先：三层审查机制，每环节都有质量把关
持续进化：执行经验自动沉淀，成功3次的流程固化为可复用Skill

何时使用此Skill

✅ 使用场景：

复杂创意写作（小说、剧本、系列文章）
多步骤数据分析与报告
完整项目开发（需求→设计→编码→测试）
研究与信息整理（多来源信息整合）
方案设计与规划

❌ 不使用场景：

简单查询（"今天天气如何"）
单一计算任务
已有专用Skill的标准任务
强实时性要求的任务（<1秒响应）

任务分类规则

类型1：单一任务

判断标准：

任务单维度（只涉及一个领域）
不需要多角色协作
主Agent可在合理时间内完成

示例：

"把这段文字翻译成英文"
"帮我总结这篇文章"
"计算这组数据的平均值"

处理方式： 主Agent直接执行或创建1个子Agent

类型2：标准任务

判断标准：

任务类型在Skill库中有匹配
执行次数≥3次（已验证的Skill）
用户没有特殊要求修改流程

示例：

"写一个科幻小说" → 已有科幻创作Skill
"分析数据并生成报告" → 已有数据分析Skill

处理方式： 加载Skill，按固化流程执行

类型3：创新任务 + 标准任务

判断标准：

主体任务有对应Skill
但需要特殊处理或定制
在标准流程基础上增加定制步骤

示例：

"写一本科幻小说，重点描写科技细节"
"分析数据，但要对比行业基准"

处理方式： 加载Skill，添加定制环节

类型4：创新任务（新任务）

判断标准：

任务类型在Skill库中无匹配
或者虽然类型匹配但有重大变化
需要全新流程或角色分工

示例：

"帮我设计一套完整的公司管理体系"
"写一个推理小说，采用叙事诡计+时间诡计"

处理方式： 动态组建，创建子Agent团队

子Agent动态分配规则

数量标准

| 任务复杂度 | 维度数 | 子Agent数量 | 示例 | |------------|--------|-------------|------| | 简单 | 1-2个 | 1-2个 | 短篇故事、单模块开发 | | 中等 | 2-3个 | 3个 | 中篇小说、多模块开发 | | 复杂 | 4+个 | 4-6个 | 长篇小说、大型项目 |

复杂度计算

任务复杂度 = 维度数 × 每个维度的复杂度

分配原则

基于任务上下文分解
主Agent充分理解后按需分配
一个Agent可承担多个Skill（非1:1对应）

执行流程

标准流程（创新任务）

1. 用户输入任务描述
   ↓
2. 任务分类器判断任务类型
   ↓
3. 任务分解器分解为子任务
   ↓
4. 队伍组建器创建子Agent
   ↓
5. 执行协调器协调执行
   ├─ 子Agent执行 + 自我检查
   ├─ 主Agent确认 / 审查Agent审查
   └─ 通过 → 下一环节
   ↓
6. 主Agent整合输出
   ↓
7. 交付用户
   ↓
8. Skill进化分析器分析
   ↓
9. 资源清理器删除临时子Agent
   ↓
10. 结束

质量检查机制

三层检查

| 层级 | 执行者 | 职责 | |------|--------|------| | 自我检查 | 子Agent | 完成任务后自我检查，输出检查报告 | | 主Agent确认 | 主Agent | 确认输出是否符合需求 | | 审查Agent | 临时审查Agent | 复杂任务时独立审查（≥4子Agent） |

审查Agent双重身份

| 阶段 | 身份 | 生命周期 | |------|------|----------| | ≤2次同类型任务 | 临时子Agent | 任务完成后删除 | | ≥3次同类型任务 | 固化功能 | 合并到Skill中 |

Skill固化规则

触发条件

相同类型任务成功执行3次
用户满意度≥4分
无重大错误

固化内容

标准执行流程
子Agent角色分配
各环节审查逻辑

版本管理

小优化：升级次版本（v1.0→v1.1）
重大变更：升级主版本（v1.1→v2.0）

异常处理

| 异常类型 | 处理方式 | |----------|----------| | 子Agent创建失败 | 重试1-2次→降级→主Agent接手 | | 子Agent执行失败 | 提供反馈→重新执行→3次失败后主Agent接手 | | 检查不通过 | 指出问题→返回修改→最多3次 | | 清理失败 | 记录日志→下次启动时强制清理 |

资源配置

默认配置

max-concurrent-tasks: 3      # 最多并发3个主任务
max-sub-agents: 12           # 系统总共最多12个子Agent
subagent-timeout: 300s       # 子Agent超时5分钟
confidence-threshold: 0.7    # 分类置信度70%

模型选择建议

| 场景 | 推荐模型 | 优势 | |------|----------|------| | 通用写作/对话 | qwen3.5-plus | 能力均衡，性价比高 | | 复杂逻辑推理 | qwen3-max | 推理能力强 | | 代码开发 | qwen3-coder-plus | 代码专项能力 | | 快速执行 | MiniMax-M2.5 | 响应速度快 |

使用示例

示例1：科幻小说创作

任务：写一篇800字的科幻短文
主题：2077年的北京
要求：有明确的世界观，逻辑严谨，有科技感

系统执行：

分类：创新任务（创意写作）
分解：世界观设计→大纲→写作
组建：世界观专家+写作专家
执行：并行/串行协作
输出：完整科幻短文

示例2：悬疑小说创作

任务：创作悬疑短篇小说
要求：
- 暴风雪山庄模式
- 密室杀人
- 10章，每章1000字

系统执行：

分类：创新任务（悬疑创作）
分解：案件设计→大纲→写作→审查
组建：案件专家+大纲专家+写作专家+审查Agent
执行：串行协作，每环节审查
输出：完整悬疑小说

🌟 小说创作专用模式：《吾名午夜》

调用方式：

任务：创作《吾名午夜》第X章
章节：X章
要求：去AI味、逻辑缜密、称呼统一

系统执行：

分类：类型3（标准任务-长篇小说）
加载模板：novel-wuming
组建Agent团队：
- plot-architect（剧情架构）
- world-builder（世界观审计）
- character-editor（人物调校）
- content-writer（内容创作）
- consistency-checker（逻辑审查）
- tone-editor（文风编辑）
执行：6Agent协作，串行为主
质量检查：三层审查
输出：符合设定的章节正文

核心原则：

去AI味：对话简短、描写不完美
逻辑缜密：时间线、称呼、势力关系一致
质量优先：未通过审查不输出

系统边界

✅ 能做的事

任务智能分解和子Agent动态分配
多Agent并行/串行协作完成复杂任务
全流程质量控制，输出质量稳定
经验自动沉淀，系统能力持续进化
完全兼容现有OpenClaw生态

❌ 不能做的事

改变OpenClaw核心架构
突破OpenClaw的安全权限限制
提高模型本身的能力上限
处理强实时性要求的任务（<1秒响应）
控制外部系统或硬件设备

记忆与持久化

共享记忆层

任务上下文存储
中间成果存储
执行日志记录
Skill计数追踪

存储位置

独立JSON文件（避免污染主记忆）
路径：./skills/dynamic-multi-agent-system/state/

反馈与改进

用户反馈收集

任务完成后自动询问：

【任务完成反馈】
任务：{task-description}
完成时间：{timestamp}

请评分（1-5分）：
□ 5 - 超出预期
□ 4 - 满意
□ 3 - 一般
□ 2 - 不满意
□ 1 - 非常不满意

可选：具体建议或修改要求

改进触发

评分<3分：触发反思改进器分析
评分≥4分：计入Skill成功次数
修改要求：记录到经验库

v1.3 新增功能

A2 - 任务模板库

新增 24+ 个预设模板，覆盖写作/代码/分析/商业/学术/创意/视频/翻译/社媒等场景
模板管理器支持分类检索、关键词搜索、Prompt 参数填充
每个模板包含：Agent 角色配置、Prompt 模板、复杂度评估、输出格式定义
文件：templates/task-template-manager.ps1

A4 - 结果导出功能

支持 5 种导出格式：Markdown / JSON / TXT / HTML / CSV
增强 HTML 导出样式，支持打印为 PDF
包含元数据导出、批量导出、导出历史管理
文件：core/exporter/enhanced-result-exporter.ps1

A6 - 性能再优化

智能裁剪：自动截断超长上下文，保留关键结构（代码块/标题/列表）
结果缓存：LRU 驱逐策略、TTL 过期、命中率统计
执行包装器：Invoke-CachedExecution 支持缓存复用
文件：core/optimization/enhanced-performance-optimizer.ps1

B1 - 多级缓存机制

L1 内存缓存：毫秒级访问，LRU 驱逐
L2 磁盘缓存：持久化存储，支持压缩
L3 语义缓存：相似度匹配（阈值 0.85），自动回填
三级缓存统一接口：自动穿透查询、分级写入
文件：core/cache/multi-level-cache.ps1

B6 - 监控告警增强

系统指标监控：CPU / 内存 / 磁盘 / Gateway 状态
应用指标监控：缓存命中率 / 任务队列 / 活跃 Agent
四级告警：info / warning / error / critical
告警去重、自动触发、配置管理
文件：core/monitoring/enhanced-system-monitor.ps1

v1.3.1 新增功能

A1 - Agent角色扩展（18→30种）⭐⭐⭐⭐⭐

文件： core/subagent-manager/roles/*.md

| 指标 | v1.3 | v1.3.1 | 改进 | |------|------|--------|------| | 角色数量 | 18 | 30 | +67% | | 角色分类 | 4类 | 6类 | +2类 |

新增角色（12个）：

数据类：

数据分析师 - SQL/Python/可视化
数据工程师 - ETL/数据管道
BI分析师 - 报表/仪表盘
数据科学家 - 机器学习/统计建模

开发类：

测试工程师 - 单元测试/集成测试
DevOps工程师 - CI/CD/部署
安全工程师 - 代码审计/渗透测试
系统管理员 - 服务器/权限管理

创意类：

UI设计师 - 原型/Figma
UX研究员 - 用户研究/可用性测试
品牌策划 - 营销/文案
内容策略师 - 内容规划/矩阵

专业类：

法律顾问 - 合同/合规
财务分析师 - 报表/预算
项目经理 - 敏捷/Scrum
产品经理 - PRD/需求管理

运营类：

SEO专家 - 搜索优化/关键词
增长黑客 - AARRR/获客策略
客户成功经理 - 培训/满意度
运维分析师 - 监控/告警

B8 - 模型选择优化 ⭐⭐⭐⭐⭐

文件： core/model-selector/SKILL.md（升级至v2.0）

新功能：

| 功能 | 说明 | |------|------| | 任务复杂度评估 | 自动分析任务难度（1-10分），选择合适模型 | | 成本优化 | 同等效果选更便宜的，预估节省30-40% | | 性能预测 | 根据任务类型（写作/代码/分析）预估所需模型 | | 备选模型自动切换 | 主模型失败自动切换备选链 | | 模型质量评分 | 实时评分，动态调整推荐 |

模型矩阵v2.0：

| 模型 | 能力 | 速度 | 成本 | 上下文 | |------|------|------|------|--------| | MiniMax-M2.5 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ¥ | 32K | | MiniMax-M2.7 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ¥¥ | 32K | | Qwen3-Coder | ⭐⭐⭐⭐ | ⭐⭐⭐ | ¥¥ | 32K | | Qwen3.5-Plus | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ¥¥¥ | 32K | | Qwen3-Max | ⭐⭐⭐⭐⭐ | ⭐⭐ | ¥¥¥¥ | 32K | | Qwen3.5-Max | ⭐⭐⭐⭐⭐ | ⭐⭐ | ¥¥¥¥ | 128K | | GPT-4o | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ¥¥¥¥ | 128K | | Claude-3.5 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ¥¥¥¥ | 200K |

B3 - 错误处理增强 ⭐⭐⭐⭐⭐

文件： core/error-handler/SKILL.md

| 功能 | 说明 | |------|------| | 200+错误码定义 | 19个错误类别，覆盖全场景 | | 错误分类 | RETRY（重试）/ SKIP（跳过）/ ABORT（中止） | | 自动诊断 | 智能分析错误原因，即时给出处理建议 | | 恢复建议 | 每个错误码提供具体解决方案 | | 友好提示 | 用户可理解的错误信息 |

错误码分类：

| 类别 | 范围 | 说明 | |------|------|------| | ERR-SYS | 0001-0099 | 系统错误 | | ERR-NET | 0101-0199 | 网络错误 | | ERR-API | 0201-0299 | API错误 | | ERR-AGT | 0301-0399 | Agent错误 | | ERR-TASK | 0401-0499 | 任务错误 | | ERR-AUTH | 0501-0599 | 认证错误 | | ERR-DATA | 0601-0699 | 数据错误 | | ERR-FILE | 0701-0799 | 文件错误 | | ERR-CACHE | 0801-0899 | 缓存错误 | | ERR-PERM | 0901-0999 | 权限错误 | | ERR-VAL | 1001-1099 | 验证错误 | | ERR-TIME | 1101-1199 | 超时错误 | | ERR-MEM | 1201-1299 | 内存错误 | | ERR-DISK | 1301-1399 | 磁盘错误 | | ERR-MODEL | 1401-1499 | 模型错误 | | ERR-PARSE | 1501-1599 | 解析错误 | | ERR-FLOW | 1601-1699 | 流程错误 | | ERR-INTEG | 1701-1799 | 集成错误 | | ERR-SKILL | 1801-1899 | Skill错误 | | ERR-BATCH | 1901-1999 | 批处理错误 |

版本历史

| 版本 | 日期 | 变更 | |------|------|------| | 1.3.1 | 2026-04-07 | Agent角色扩展(A1)、模型选择优化(B8)、错误处理增强(B3) | | 1.3.0 | 2026-04-07 | 任务模板库(A2)、结果导出(A4)、性能再优化(A6)、多级缓存(B1)、监控告警增强(B6) | | 1.0.0-alpha | 2026-04-03 | 初始版本，核心功能实现 |

🧠 与Brain记忆系统隔离规则

重要： 本系统与主Agent的brain/记忆系统完全隔离。

隔离原则

| 系统 | 路径 | 用途 | 访问权限 | |------|------|------|----------| | Brain | workspace/brain/ | 主Agent的个人记忆，服务于"记住用户" | 仅主Agent访问，子Agent不可读 | | Shared-Memory | core/shared-memory/ | 子Agent间共享的任务数据 | 子Agent可读写 |

子Agent行为规范

【禁止】
- ❌ 读取 brain/ 目录下的任何文件
- ❌ 写入 brain/ 目录下的任何文件
- ❌ 访问用户的个人信息、偏好、身份数据

【允许】
- ✅ 读写 core/shared-memory/ 下的任务数据
- ✅ 使用 skill-counters.json 记录统计
- ✅ 在 shared-memory/ 中创建临时任务文件

主Agent行为规范

【当调用多Agent系统时】
1. 主Agent负责读取 brain/ 了解用户上下文
2. 主Agent将必要的项目信息注入到系统提示
3. 子Agent只通过 shared-memory/ 获取任务信息
4. 任务完成后，主Agent负责更新 brain/ 记录学习

记忆职责划分

| 记忆类型 | 存储位置 | 管理者 | 更新时机 | |----------|----------|--------|----------| | 用户身份/偏好 | brain/me/identity.md | 主Agent | 每次获得新信息 | | 用户目标/方向 | brain/plan.md | 主Agent | 目标变化时 | | 用户任务 | brain/tasks/active.md | 主Agent | 任务创建/完成时 | | 用户决策 | brain/decisions/ | 主Agent | 决策做出时 | | 子Agent任务状态 | core/shared-memory/ | 子Agent | 任务执行中 | | 系统使用统计 | state/skill-counters.json | 子Agent | 任务完成时 |

违规处理

如果子Agent尝试访问 brain/：

拒绝访问并记录警告
在下次报告时通知主Agent
记录到错误日志

最后更新：2026-04-07

混合动态多 Agent 协作系统

混合动态多Agent协作系统

核心定位

设计理念

何时使用此Skill

任务分类规则

类型1：单一任务

类型2：标准任务

类型3：创新任务 + 标准任务

类型4：创新任务（新任务）

子Agent动态分配规则

数量标准

复杂度计算

分配原则

执行流程

标准流程（创新任务）

质量检查机制

三层检查

审查Agent双重身份

Skill固化规则

触发条件

固化内容

版本管理

异常处理

资源配置

默认配置

模型选择建议

使用示例

示例1：科幻小说创作

示例2：悬疑小说创作

🌟 小说创作专用模式：《吾名午夜》

系统边界

✅ 能做的事

❌ 不能做的事

记忆与持久化

共享记忆层

存储位置

反馈与改进

用户反馈收集

改进触发

相关文档

v1.3 新增功能

A2 - 任务模板库

A4 - 结果导出功能

A6 - 性能再优化

B1 - 多级缓存机制

B6 - 监控告警增强

v1.3.1 新增功能

A1 - Agent角色扩展（18→30种）⭐⭐⭐⭐⭐

B8 - 模型选择优化 ⭐⭐⭐⭐⭐

B3 - 错误处理增强 ⭐⭐⭐⭐⭐

版本历史

🧠 与Brain记忆系统隔离规则

隔离原则

子Agent行为规范

主Agent行为规范

记忆职责划分

违规处理