什么是 Agent-Weave？

Agent-Weave 是一个强大的编排层，旨在管理复杂的代理架构和分布式系统。它允许开发人员构建可扩展的环境，其中主代理协调多个工作代理以处理高并发任务。通过将其集成到您的 Openclaw Skills 库中，您可以实现复杂的 MapReduce 风格工作流，并确保父进程与子进程之间安全、隔离的通信。此技能为任何希望将其代理任务执行扩展到超越单线程或单代理环境限制的用户提供了必要的基础设施。

下载入口:https://github.com/openclaw/skills/tree/main/skills/gl813788-byte/agent-weave

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Agent-Weave 应用场景

• 构建需要高吞吐量并行处理的分布式代理系统。
• 编排多个专业代理以协作完成复杂的、多步骤的目标。
• 为数据密集型 AI 操作实施 MapReduce 风格的工作流。
• 在托管的工作代理群中动态扩展任务执行。
• 在 Openclaw Skills 内部为企业级自动化创建弹性的主从架构。

1. 初始化 Loom 工厂，作为代理集群生命周期的主要管理器。
2. 创建一个主代理（Master），作为集群的中央编排器和任务调度器。
3. 生成多个工作代理（Worker），通过专用的通信层安全地绑定到父级主代理。
4. 从主代理发送数据或任务，主代理会自动将负载分配到所有活动的工作代理中。
5. 工作代理并行处理分配的任务，并将处理后的数据返回给主代理。
6. Tapestry 引擎汇总最终结果，支持复杂的数据规约和编排逻辑。

Agent-Weave 配置指南

要在 Openclaw Skills 环境中开始使用此工具，请通过 npm 安装包：

npm install agent-weave

您也可以直接通过 CLI 管理集群：

# 创建名为 my-cluster 的新主代理
weave loom create-master --name my-cluster

# 为指定的主代理生成 5 个工作代理
weave loom spawn --parent  --count 5

# 可视化代理层级结构
weave loom list --tree

Agent-Weave 数据架构与分类体系

Agent-Weave 通过分层元数据分类法组织其内部数据和集群关系，以确保可靠的任务跟踪。

name: agent-weave
description: Master-Worker Agent Cluster for parallel task execution. Use when building distributed agent systems with parallel processing needs, task orchestration, or MapReduce-style workflows.

Agent-Weave

Master-Worker Agent Cluster with parallel task execution and secure parent-child communication.

When to Use This Skill

Use agent-weave when you need to:

• Build distributed agent systems with parallel processing
• Orchestrate multiple agents working together
• Implement MapReduce-style workflows
• Scale task execution across worker agents
• Build master-worker architectures

Quick Start

Installation

npm install agent-weave

Basic Usage

const { Loom } = require('agent-weave');

// Create cluster
const loom = new Loom();
const master = loom.createMaster('my-cluster');

// Create workers
const workers = loom.spawnWorkers(master.id, 5, async (data) => {
  // Process data
  return { result: data * 2 };
});

// Execute tasks
const results = await master.dispatch([1, 2, 3, 4, 5]);
console.log(results);

CLI Commands

# Create master
weave loom create-master --name my-cluster

# Spawn workers
weave loom spawn --parent  --count 5

# List agents
weave loom list --tree

Features

• Master-Worker Architecture: Orchestrate multiple worker agents
• Parallel Execution: Distribute tasks across workers
• Secure Communication: Parent-child relationship enforcement
• MapReduce Support: Built-in map-reduce workflows
• Auto-scaling: Dynamic worker management
• Event-driven: EventEmitter-based communication

API Reference

Loom

Factory for creating and managing agents.

Master

Manages a cluster of worker agents.

Worker

Executes tasks assigned by the master.

Thread

Secure communication layer between agents.

Tapestry

Task orchestration engine for MapReduce workflows.

License

MIT