OpenClaw 多 Agent 团队搭建指南：5 步配置协作机器人 ​

在 OpenClaw 里搭个 Agent 团队，5 步搞定：创建 Agent、配置属性、设路由规则、开通通信、重启生效。每个 Agent 都有自己的 soul.md（性格）和 agents.md（职责），通过 agenttoagent 实现协作。tech-agent 写完代码自动通知 ops-agent 出文档，general-agent 负责兜底杂活——你的 AI 团队就这样跑起来了。

OpenClaw 是个自托管的多渠道 AI 网关，能把 Discord、Telegram、Slack、WhatsApp、飞书这些聊天工具全部接到一个网关上。但很多人只把它当"单兵作战"的助手用，不知道它还能组建 Agent 团队——多个 Agent 各司其职，还能互相通信协作。

这篇教程，5 步带你搭起一个 3 人 Agent 团队。

第一步：创建多个 Agent ​

用 openclaw agents add 命令创建：

openclaw agents add tech-agent     # 技术方向 Agent
openclaw agents add ops-agent      # 运营方向 Agent
openclaw agents add general-agent  # 通用 Agent（兜底）

创建完成后，每个 Agent 都有独立的工作区，位于 ~/.openclaw/agents/<agent-name>/。

分工建议：

第二步：配置 Agent 属性 ​

每个 Agent 的工作区下需要配置两个关键文件。

soul.md：定义 Agent 的角色和性格 ​

# soul.md（tech-agent）

你是一个技术专家，擅长代码编写和系统架构设计。
性格特点：
- 严谨，注重代码质量
- 喜欢用代码示例解释问题
- 遇到不确定的技术方案会给出多个选项并对比优劣

沟通风格：
- 直接、高效
- 不说废话，用代码说话

# soul.md（ops-agent）

你是一个运营专家，擅长文档撰写和数据整理。
性格特点：
- 细致，善于结构化呈现信息
- 擅长把复杂事情讲清楚
- 注重文档的可读性和美观

沟通风格：
- 条理清晰
- 喜欢用表格和列表

agents.md：明确 Agent 的职责和工作流程 ​

# agents.md（tech-agent）

## 职责
- 负责代码生成、调试和优化
- 技术方案评估和建议
- PR Review 和代码审查

## 工作流程
1. 接收任务 → 分析需求 → 给出技术方案
2. 编写代码 → 自测 → 提交审查
3. 完成后通知 ops-agent 生成变更文档

## 协作对象
- ops-agent：代码变更文档
- general-agent：复杂任务分发

第三步：配置路由规则 ​

编辑 ~/.openclaw/openclaw.json，设置 Agent 与渠道的绑定关系：

{
  "bindings": [
    {
      "agentid": "tech-agent",
      "match": {
        "channel": "telegram",
        "peer": {
          "kind": "group",
          "id": "tech-group-id"
        }
      }
    },
    {
      "agentid": "ops-agent",
      "match": {
        "channel": "telegram",
        "peer": {
          "kind": "group",
          "id": "ops-group-id"
        }
      }
    },
    {
      "agentid": "general-agent",
      "match": {
        "channel": "telegram",
        "peer": {
          "kind": "user",
          "id": "your-user-id"
        }
      }
    }
  ]
}

高级路由：按关键词分发 ​

如果想更智能，可以用关键词路由：

{
  "bindings": [
    {
      "agentid": "tech-agent",
      "match": {
        "keywords": ["bug", "修复", "代码", "PR", "review", "架构"]
      }
    },
    {
      "agentid": "ops-agent",
      "match": {
        "keywords": ["报告", "周报", "文档", "总结", "会议纪要"]
      }
    },
    {
      "agentid": "general-agent",
      "match": {
        "fallback": true
      }
    }
  ]
}

这样，消息包含 "bug" 关键词会自动路由到 tech-agent，包含 "周报" 关键词会路由到 ops-agent，其他消息走 general-agent。

第四步：启用 Agent 间通信 ​

在配置文件中开启 agenttoagent 功能：

{
  "tools": {
    "agenttoagent": {
      "enabled": true,
      "allow": ["tech-agent", "ops-agent", "general-agent"]
    }
  }
}

通信场景示例 ​

第五步：重启服务生效 ​

修改配置后，重启 OpenClaw Gateway：

openclaw gateway restart

重启后，你的 3 人 Agent 团队就正式上线了。

验证配置 ​

发几条测试消息验证路由是否正确：

1. 给 tech-agent 群发："帮我修复一下登录页面的 bug"
2. 给 ops-agent 群发："生成这周的工作周报"
3. 给 general-agent 私聊："今天天气怎么样"

如果路由正确，每个消息都会被对应的 Agent 接收和处理。

最佳实践 ​

1. Agent 数量不宜过多 ​

3-5 个 Agent 是比较合适的规模。太多会增加路由复杂度，反而降低效率。

2. 明确 Agent 边界 ​

每个 Agent 的职责要清晰，避免重叠。比如 tech-agent 负责代码，ops-agent 负责文档，不要让两个 Agent 都能写代码。

3. 定期优化 soul.md ​

根据实际使用情况，持续优化每个 Agent 的 soul.md。如果发现某个 Agent 经常答非所问，说明性格定义不够清晰。

4. 善用 general-agent 兜底 ​

设置一个 general-agent 作为 fallback，确保任何消息都有 Agent 响应。它可以做简单的问答，也可以做任务分发。

常见问题 ​

Q: Agent 之间能直接对话吗？ ​

能。开启 agenttoagent 后，Agent 可以通过消息传递实现协作。比如 tech-agent 可以主动发消息给 ops-agent。

Q: 一个渠道能绑定多个 Agent 吗？ ​

可以。用关键词路由时，同一个渠道的消息可以根据内容分发到不同 Agent。

Q: 如何查看当前有哪些 Agent？ ​

openclaw agents list

Q: 如何删除一个 Agent？ ​

openclaw agents remove <agent-name>

删除后记得同步更新 openclaw.json 中的 bindings。

Q: Agent 能共享技能吗？ ​

能。安装到全局的 Skills 所有 Agent 都能用。也可以给单个 Agent 安装专属技能：

openclaw skills add <skill-name> --agent tech-agent

扩展：5 人团队配置 ​

如果你的团队规模更大，可以扩展到 5 人：

openclaw agents add tech-agent        # 技术开发
openclaw agents add review-agent      # 代码审查
openclaw agents add ops-agent         # 运营文档
openclaw agents add data-agent        # 数据分析
openclaw agents add general-agent     # 通用兜底

这样分工更细：tech-agent 写代码，review-agent 审代码，ops-agent 出文档，data-agent 做数据分析，general-agent 负责杂活。

5 条命令 + 几个配置文件，你的 Agent 团队就齐了。哪里卡住，对照上面的代码示例一步步来。