OpenClaw clawdtributor 技能完整解析
一、名称词义拆解
clawdtributor = Clawd(OpenClaw 前身项目名)+ distributor(分发器),直译:Clawd 任务分发调度器,是 OpenClaw 内置多智能体核心编排技能,路径:.agents/skills/clawdtributor 属于Agent 调度层内置技能,区别于普通业务 Skill。二、核心定位
它是主协调 Agent(Orchestrator)专用任务分发引擎,专门负责把复杂大任务自动拆分、批量下发给子 Agent 并行执行,再统一收集、合并、校验所有子任务结果,是 OpenClaw 多 Agent 并行工作流的底层调度核心learnopenc...。
三、完整功能清单
1. 任务自动拆解(Fan-out 扇出)
接收用户 / 主 Agent 的复杂目标,LLM 自动拆解为无依赖、可并行的独立子任务 DAG 任务图:
- 自动识别可并行、有先后依赖的任务
- 给每个子任务分配对应能力、模型、权限
- 输出标准化子任务队列
2. 多分发调度策略(内置 4 种负载均衡)
- 轮询 Round-Robin:均匀分配给同类型空闲子 Agent,均衡负载
- 能力匹配 Auction 拍卖:按 Agent 技能 / 模型 / 资源竞标,任务分给最适配实例
- 最小负载 Least-Busy:优先发给当前任务最少的 Agent,防单点过载
- 静态分组 Fan-out 批量:一次性批量生成一批独立子 Agent 同步跑任务(爬虫、批量调研、批量代码审查场景)
3. 子 Agent 生命周期管理
- 动态隔离创建子 Agent:独立上下文、独立工具权限、独立模型会话,互不崩溃干扰
- 超时 / 失败自动重试、死任务重分配、故障 Agent 隔离
- 限制最大并发 Agent 数量,防止资源耗尽
4. 结果汇总合并(Fan-in 扇入)
所有子任务完成后统一聚合:
- 去重、冲突校验、缺失数据补全
- 自动格式化统一输出
- 可选内置评审子 Agent 二次校验结果准确性
5. 跨实例分布式分发(高级)
支持跨机器、跨网关的远程 Agent 集群分发,本地与远端节点混合调度,适合大规模分布式 AI 集群部署
四、与 clawtributor 区分(极易混淆)
很多人拼错名称,两者完全无关:
| 技能 | 名称 | 用途 | 领域 |
|---|---|---|---|
| clawdtributor | 任务分发器 | 多 Agent 并行调度、任务拆分 | 工作流编排 |
| clawtributor | 安全事件上报器 | 上报恶意 Prompt、漏洞 Skill、攻击行为到 GitHub 安全公告 | 社区安全反馈 |
五、典型使用场景
- 批量调研:同时启动多个子 Agent 分别搜索不同竞品 / 资料,汇总对比报告
- 代码批量审查:拆分多个文件分给子 Agent 并行审计,统一汇总漏洞清单
- 大规模数据爬取:多 Agent 分片抓取网页,合并数据
- 复杂写作流水线:调研、素材整理、初稿、校对并行拆分提速
- 分布式生产 AI 集群:多台机器 Agent 池负载均衡调度任务
六、底层依赖工具
内部会调用 OpenClaw 原生底层工具:
sessions_spawn:创建隔离子 Agent 会话memory_shared:多 Agent 共享内存交换中间数据agent_list:查询集群内所有可用 Worker Agenttask_queue:本地异步任务队列
七、运行流程总览
- 主 Agent 接收复杂需求 → 调用 clawdtributor
- 技能拆解任务 DAG,选择调度策略
- 批量 Spawn 子 Agent 下发独立子任务并行执行
- 监控每个子任务状态,处理超时 / 报错重分配
- 全部完成后聚合、校验、合并输出完整结果返还主 Agent
八、部署与启用
该技能是仓库内置原生技能,无需额外安装:
- 路径:
repo/.agents/skills/clawdtributor - 启用方式:主 Agent 配置文件
AGENTS.md加入允许列表allow: ["clawdtributor"] - 调用:自然语言指令(“并行拆分任务给多个子 Agent 执行汇总”)或斜杠命令
/clawdtributor run