OpenClaw 双模多 Agent 架构:角色分工与任务并行的完整实践指南

一次性采集 20 个竞品网站信息├── 问题：串行执行需要 600 秒（10 分钟）？├── 风险：超时断开、用户体验差└── 需求：并行处理，30 秒完成

~/.openclaw/├── workspace-pm/           # 产品经理工作空间│   ├── AGENTS.md           # 行为准则（产品经理专用）│   ├── SOUL.md             # 人格定义（专业、用户体验导向）│   ├── USER.md             # 用户信息│   ├── TOOLS.md            # 工具笔记│   └── memory/             # 独立记忆系统│       ├── MEMORY.md│       └── YYYY-MM-DD.md│├── workspace-dev/          # 开发经理工作空间│   ├── AGENTS.md           # 行为准则（开发经理专用）│   ├── SOUL.md             # 人格定义（技术导向）│   └── ...│└── workspace-qa/           # 测试经理工作空间    └── ...

~/.openclaw/agents/├── pm/                     # 产品经理 Agent│   ├── agent/│   │   └── auth-profiles.json  # 独立认证配置│   └── sessions/│       ├── sessions.json       # 会话索引│       └── <sessionId>.jsonl   # 会话转录│├── dev/                    # 开发经理 Agent│   ├── agent/│   │   └── auth-profiles.json│   └── sessions/│       └── ...│└── qa/                     # 测试经理 Agent    └── ...

// 配置文件：~/.openclaw/openclaw.json{  // 1. 定义多个角色型 Agent  agents: {    list: [      {        id: "product-manager",        name: "产品经理",        workspace: "~/.openclaw/workspace-pm",        agentDir: "~/.openclaw/agents/pm/agent",        model: "anthropic/claude-opus-4-6", // 高质量模型      },      {        id: "dev-manager",        name: "开发经理",        workspace: "~/.openclaw/workspace-dev",        agentDir: "~/.openclaw/agents/dev/agent",        model: "anthropic/claude-opus-4-6",      },      {        id: "qa-manager",        name: "测试经理",        workspace: "~/.openclaw/workspace-qa",        agentDir: "~/.openclaw/agents/qa/agent",        model: "anthropic/claude-sonnet-4-6", // 性价比模型      },    ],  },  // 2. 配置 Bindings 路由规则  bindings: [    // 产品经理：绑定到 Telegram 渠道    {      type: "acp",      agentId: "product-manager",      match: {        channel: "telegram",        accountId: "pm-bot",      },    },    // 开发经理：绑定到 Discord 渠道    {      type: "acp",      agentId: "dev-manager",      match: {        channel: "discord",        accountId: "dev-bot",      },    },    // 测试经理：绑定到 Slack 渠道    {      type: "acp",      agentId: "qa-manager",      match: {        channel: "slack",        accountId: "qa-bot",      },    },  ],  // 3. 配置多渠道账号  channels: {    telegram: {      accounts: {        pm-bot: {          botToken: "123456:ABC...",          dmPolicy: "pairing",        },      },    },    discord: {      accounts: {        dev-bot: {          token: "DISCORD_BOT_TOKEN_DEV",          guilds: {            "123456789012345678": {              channels: {                "222222222222222222": { allow: true },              },            },          },        },      },    },    slack: {      accounts: {        qa-bot: {          botToken: "xoxb-...",          appToken: "xapp-...",        },      },    },  },}

Telegram 消息 → 产品经理角色 (同时并行)Discord 消息  → 开发经理角色 (同时并行)Slack 消息    → 测试经理角色 (同时并行)

// 配置文件：~/.openclaw/openclaw.json{  // ========== 1. 定义三个角色型 Agent ==========  agents: {    list: [      {        id: "alex-pm",        name: "产品经理 Alex",        workspace: "~/.openclaw/workspace-alex-pm",        agentDir: "~/.openclaw/agents/alex-pm/agent",        model: "anthropic/claude-opus-4-6",        groupChat: {          mentionPatterns: ["@Alex", "@产品经理", "@PM"],        },      },      {        id: "mia-dev",        name: "研发经理 Mia",        workspace: "~/.openclaw/workspace-mia-dev",        agentDir: "~/.openclaw/agents/mia-dev/agent",        model: "anthropic/claude-opus-4-6",        groupChat: {          mentionPatterns: ["@Mia", "@开发", "@技术"],        },      },      {        id: "nico-qa",        name: "测试经理 Nico",        workspace: "~/.openclaw/workspace-nico-qa",        agentDir: "~/.openclaw/agents/nico-qa/agent",        model: "anthropic/claude-sonnet-4-6",        groupChat: {          mentionPatterns: ["@Nico", "@测试", "@QA"],        },      },    ],  },  // ========== 2. 配置飞书渠道 ==========  channels: {    feishu: {      enabled: true,      domain: "feishu",      defaultAccount: "main",      accounts: {        main: {          appId: "cli_a1b2c3d4e5f6g7h8",          appSecret: "your-app-secret-here",          name: "公司协作机器人",        },      },      dmPolicy: "allowlist",      allowFrom: [        "ou_product_owner",        "ou_cto",        "ou_qa_lead",        "ou_alex_user",      ],      groupPolicy: "allowlist",      groupAllowFrom: [        "oc_product_team",        "oc_dev_team",        "oc_qa_team",        "oc_all_hands",      ],      requireMention: true,      groups: {        oc_product_team: {          requireMention: false,          enabled: true,        },        oc_dev_team: {          requireMention: true,          enabled: true,        },        oc_qa_team: {          requireMention: true,          enabled: true,        },      },    },  },  // ========== 3. 配置 Bindings 路由规则 ==========  bindings: [    // 产品经理 Alex 路由    {      agentId: "alex-pm",      match: {        channel: "feishu",        peer: { kind: "direct", id: "ou_product_owner" },      },    },    {      agentId: "alex-pm",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_product_team" },      },    },    // 研发经理 Mia 路由    {      agentId: "mia-dev",      match: {        channel: "feishu",        peer: { kind: "direct", id: "ou_cto" },      },    },    {      agentId: "mia-dev",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_dev_team" },      },    },    // 测试经理 Nico 路由    {      agentId: "nico-qa",      match: {        channel: "feishu",        peer: { kind: "direct", id: "ou_qa_lead" },      },    },    {      agentId: "nico-qa",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_qa_team" },      },    },    // 全员群：根据@关键词路由    {      agentId: "alex-pm",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_all_hands" },      },    },  ],  // ========== 4. 配置子 Agent 并行（所有角色共享） ==========  agents: {    defaults: {      subagents: {        maxSpawnDepth: 2,        maxConcurrent: 8,        model: "anthropic/claude-sonnet-4-6",        archiveAfterMinutes: 60,      },    },  },}

飞书企业账号：公司协作机器人│├── DM 场景│   ├── 产品负责人 → Alex│   ├── CTO → Mia│   └── QA 负责人 → Nico│├── 群聊场景│   ├── 产品团队群 → Alex│   ├── 研发团队群 → Mia│   └── 测试团队群 → Nico│└── 全员群    └── 根据@关键词路由（@Alex/@Mia/@Nico）

# 1. 获取群组 ID（chat_id，格式：oc_xxx）# 打开飞书群 → 右上角菜单 → 设置 → 查看群 ID# 2. 获取用户 ID（open_id，格式：ou_xxx）openclaw logs --follow | grep "open_id"# 3. 查看待配对的请求openclaw pairing list feishu# 4. 批准配对请求openclaw pairing approve feishu <CODE>

# 创建新角色 Agentopenclaw agents add coding# 查看角色列表及 Bindingsopenclaw agents list --bindings# 切换到指定角色（CLI 模式）openclaw agent use product-manager# 查看角色会话状态openclaw sessions --agent product-manager# 检查路由配置openclaw security audit

// 主 Agent 根据需要动态创建子 Agentconst result = await sessions_spawn({  task: "竞品分析",  runtime: "subagent",  mode: "run",  timeoutSeconds: 60,  cleanup: "delete",});

角色型：Gateway 启动时创建 → 长期存在 → 手动管理任务型：运行时动态创建 → 临时存在 → 自动清理

主 Agent 会话├── sessionKey: agent:default:main├── 上下文：用户偏好、长期记忆、完整历史├── 工具策略：完整权限└── 记忆系统：MEMORY.md + memory/*.md子 Agent 1 会话├── sessionKey: session:task-uuid-001├── 上下文：仅任务相关信息（精简）├── 工具策略：受限权限（仅需要的工具）└── 记忆系统：共享主 Agent 记忆子 Agent 2 会话├── sessionKey: session:task-uuid-002├── 上下文：仅任务相关信息（精简）└── ...

主 Agent  ├─→ 子 Agent 1 (任务 A：30 秒)  ├─→ 子 Agent 2 (任务 B：25 秒)  ├─→ 子 Agent 3 (任务 C：35 秒)  └─→ 子 Agent 4 (任务 D：28 秒)  ↓ 汇总结果总耗时：max(30, 25, 35, 28) = 35 秒串行耗时：30 + 25 + 35 + 28 = 118 秒效率提升：3.4 倍

{  agents: {    defaults: {      subagents: {        maxConcurrent: 8,      },    },  },}

// 子 Agent 完成后自动通知主 Agent{  status: "completed",  result: "...",  sessionKey: "session:xxx",  sessionId: "uuid-xxx",  runtime: "5m12s",  tokens: {    input: 1200,    output: 800,    total: 2000,  },  cost: "$0.012",}

{  agents: {    defaults: {      subagents: {        maxSpawnDepth: 1,        maxChildrenPerAgent: 5,        maxConcurrent: 8,        runTimeoutSeconds: 900,        model: "anthropic/claude-sonnet-4-6",        archiveAfterMinutes: 60,      },    },  },}

// 并行采集 5 个网站const websites = [  "https://site-a.com",  "https://site-b.com",  "https://site-c.com",  "https://site-d.com",  "https://site-e.com",];const results = await Promise.all(  websites.map(url => sessions_spawn({    task: `分析 ${url} 的产品信息和定价策略`,    runtime: "subagent",    mode: "run",    timeoutSeconds: 60,  })));

{  agents: {    defaults: {      subagents: {        maxSpawnDepth: 2,        maxChildrenPerAgent: 5,        maxConcurrent: 8,      },    },  },}

// 主 Agent → Orchestrator → Worker// 1. 创建 Orchestrator（协调员）const orchestrator = await sessions_spawn({  task: "协调多个竞品分析任务并汇总报告",  runtime: "subagent",  mode: "session",  label: "competitor-analysis-orchestrator",});// 2. Orchestrator 内部创建 Workerconst workers = await Promise.all([  sessions_spawn({ task: "分析竞品 A" }),  sessions_spawn({ task: "分析竞品 B" }),  sessions_spawn({ task: "分析竞品 C" }),]);

主 Agent  └─→ Orchestrator 子 Agent      ├─→ Worker 1：竞品 A 分析      ├─→ Worker 2：竞品 B 分析      └─→ Worker 3：竞品 C 分析

{  channels: {    discord: {      threadBindings: {        enabled: true,        idleHours: 24,        maxAgeHours: 0,        spawnSubagentSessions: true,      },    },  },}

const threadAgent = await sessions_spawn({  task: "长期项目协作：产品架构 redesign",  runtime: "subagent",  mode: "session",  thread: true,  label: "project-arch-redesign",});

Discord 频道：#product-design  └─→ 线程：架构 redesign 讨论      └─→ 绑定子 Agent：project-arch-redesign

# 查看当前会话的子 Agent 列表/subagents list# 查看子 Agent 详细信息/subagents info <id|#># 查看子 Agent 日志/subagents log <id|#> [limit] [tools]# 发送消息给子 Agent/subagents send <id|#> <message># 终止子 Agent/subagents kill <id|#|all># 手动创建子 Agent/subagents spawn <agentId> <task> [--model <model>]# Discord 线程绑定控制/focus <subagent-label>/unfocus/agents/session idle <duration|off>/session max-age <duration|off>

{  agents: {    list: [{ id: "main", model: "claude-opus-4-6" }],    defaults: {      subagents: { model: "claude-sonnet-4-6" },    },  },}// 成本节省：80%

{  agents: {    defaults: {      subagents: {        archiveAfterMinutes: 60,      },    },  },}

✅ 好：原子任务（30 秒内完成）   - "提取这个网页的标题和正文"   - "分析这段文本的情感倾向"❌ 差：复杂任务（超过 5 分钟）   - "分析整个行业的发展趋势"   应分解为多个原子任务

{  // ========== 1. 三个角色型 Agent ==========  agents: {    list: [      {        id: "alex-pm",        name: "产品经理 Alex",        workspace: "~/.openclaw/workspace-alex-pm",        model: "anthropic/claude-opus-4-6", // 高质量        groupChat: {          mentionPatterns: ["@Alex", "@产品经理", "@PM"],        },      },      {        id: "mia-dev",        name: "研发经理 Mia",        workspace: "~/.openclaw/workspace-mia-dev",        model: "anthropic/claude-opus-4-6",        groupChat: {          mentionPatterns: ["@Mia", "@开发", "@技术"],        },      },      {        id: "nico-qa",        name: "测试经理 Nico",        workspace: "~/.openclaw/workspace-nico-qa",        model: "anthropic/claude-sonnet-4-6",        groupChat: {          mentionPatterns: ["@Nico", "@测试", "@QA"],        },      },    ],  },  // ========== 2. 飞书渠道配置 ==========  channels: {    feishu: {      enabled: true,      domain: "feishu",      dmPolicy: "allowlist",      groupPolicy: "allowlist",      requireMention: true,    },  },  // ========== 3. Bindings 路由 ==========  bindings: [    { agentId: "alex-pm", match: { channel: "feishu", peer: { kind: "group", id: "oc_product_team" } } },    { agentId: "mia-dev", match: { channel: "feishu", peer: { kind: "group", id: "oc_dev_team" } } },    { agentId: "nico-qa", match: { channel: "feishu", peer: { kind: "group", id: "oc_qa_team" } } },  ],  // ========== 4. 子 Agent 并行配置（所有角色共享） ==========  agents: {    defaults: {      subagents: {        maxSpawnDepth: 2,        // 支持 Orchestrator 模式        maxChildrenPerAgent: 5,  // 每个角色最多 5 个子任务        maxConcurrent: 8,        // 全局并发 8 个        runTimeoutSeconds: 900,  // 15 分钟超时        model: "anthropic/claude-sonnet-4-6", // 子任务用性价比模型        archiveAfterMinutes: 60, // 60 分钟后归档      },    },  },}

飞书 DM：产品负责人 → Alex"请分析竞品 X 的最新功能"↓Alex 角色 → 派生 3 个子 Agent 并行：├─→ 子 Agent 1: 竞品功能截图分析（60 秒）├─→ 子 Agent 2: 用户评论情感分析（45 秒）└─→ 子 Agent 3: 功能对比报告生成（55 秒）↓ 汇总（60 秒）Alex 回复产品负责人：完整竞品分析报告

飞书群：研发团队群 → @Mia"这个功能的技术方案怎么设计？"↓Mia 角色 → 派生 3 个子 Agent 并行：├─→ 子 Agent 1: 架构设计草图（90 秒）├─→ 子 Agent 2: 技术栈选型建议（75 秒）└─→ 子 Agent 3: 工作量评估（60 秒）↓ 汇总（90 秒）Mia 回复研发团队：完整技术方案

飞书群：测试团队群 → @Nico"请制定测试计划"↓Nico 角色 → 派生 3 个子 Agent 并行：├─→ 子 Agent 1: 测试用例生成（70 秒）├─→ 子 Agent 2: 自动化测试脚本（85 秒）└─→ 子 Agent 3: 风险评估报告（50 秒）↓ 汇总（85 秒）Nico 回复测试团队：完整测试计划

飞书群：全员群 → @Alex @Mia @Nico"请一起评估这个需求的可行性"↓三个角色各自派生子 Agent 并行处理：Alex（产品经理）:├─→ 子 Agent 1: 市场需求分析└─→ 子 Agent 2: 用户价值评估Mia（研发经理）:├─→ 子 Agent 1: 技术可行性分析└─→ 子 Agent 2: 开发成本评估Nico（测试经理）:├─→ 子 Agent 1: 测试复杂度评估└─→ 子 Agent 2: 质量风险识别↓三个角色各自回复专业意见，实现分工协作