混合动态多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年的北京
要求：有明确的世界观，逻辑严谨，有科技感

系统执行：

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

示例2：悬疑小说创作

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

系统执行：

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

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

调用方式：

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

系统执行：

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

核心原则：

• 去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成功次数
• 修改要求：记录到经验库

相关文档

• 架构说明
• 部署指南
• API参考
• 故障排除

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/：

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

最后更新：2026-04-07