OpenClaw 多 Agent 实战：从零搭建 AI 开发团队 - 文章 - 开发者社区

前文讲了在OpenClaw中如何配置多Agent团队，本文再实战演练一下如何用OpenClaw搭建一个Agent开发团队。

第一步：团队架构设计

在配置多Agent团队前，先设计好我们的多 Agent 团队架构，我们希望有一个开发团队，团队中包括产品经理、前端开发工程师、后端开发工程师、UI设计工程师、测试工程师。一个完整的需求提供给产品经理，他需要拆解任务并分派给团队中的不同角色，由他们各自按照要求完成对应的工作。

第二步：创建Agent

在安装 openclaw的机器上依次运行以下命令，分别为你的团队创建多个 Agent

❗️以下命令中加粗部分根据实际需要求该名称，后续第6步会用到。

openclaw agents add PM --workspace PM

openclaw agents add UI --workspace UI

openclaw agents add FE --workspace FE

openclaw agents add BE --workspace BE

openclaw agents add TE --workspace TE

openclaw agents list

第三步：Agent 定义

我们使用单 Agent 的时候很多人并不会去修改 Workspace 下定义的这些 Markdown 文件，此时使用的是 OpenClaw 预制的定义。当我们使用多 Agent 方案时，我们必须根据实际的需求定义Agent 的 SOUL.md、AGENTS.md、TOOLS.md、IDENTITY.md、USER.md等，尤其重要的是SOUL.md和AGENTS.md。

文件	内容
SOUL.md	我是一个怎样的人（人格特质、核心原则）
AGENTS.md	如何工作（工作流程、操作规范）
HEARTBEAT.md	定时任务
BOOTSTRAP.md	初始化时完成的事
TOOLS.md	怎么操作（工具手册、配置说明）
IDENTITY.md	我是谁（名字、沟通方式）
USER.md	我为谁服务（用户偏好、决策模式）

如果你没有思路，可以将你的需求定义好，通过 TRAE 来实现初稿。完成初稿后，再根据实际的需求来调整即可。

第四步：添加飞书机器人

添加飞书机器人的步骤和单 Agent 没有差别，我们需要为每个 Agent 创建一个飞书机器人。具体步骤可以参考创建飞书机器人并获取配置

第五步：为机器人添加飞书Channel 账号

目前无法通过命令行添加飞书 Channel 账号，比较方便的方法是直接编辑 openclaw.json。

由于涉及直接修改openclaw.json，修改前请备份 openclaw.json 文件。最佳实践是使用 git 管理。
以下配置中 appId和appSecret 需要替换成你实际的机器人 appId和 appSecret。
以下配置中首位的{} 在复制时不需要。
注意逗号的位置。

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "产品经理",
        },
        UI: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "UI 设计师",
        },
        FE: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "前端开发工程师",
        },
        BE: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "后端开发工程师",
        },
        TE: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "测试工程师",
        }
      },
    },
  },
}

第六步：绑定 Agent 到飞书账号

由于涉及多个 Agent 绑定，建议通过直接配置 openclaw.json 中的 bindings 节点。

注意⚠️

由于涉及直接修改openclaw.json，修改前请备份 openclaw.json 文件。最佳实践是使用 git 管理。

可以使用 openclaw config get bindings 获取已经存在的绑定信息。如果没有，则意味着你需要自行添加 bindings 节点。

配置中的 agentId 配置成第3步中的名字； accountId 配置成第5步中对应的账号名。

以下配置中首位的{} 在复制时不需要。

注意逗号的位置。

{
    "bindings": [
        {
            "agentId": "PM",
            "match": {
                "channel": "feishu",
                "accountId": "main"
            }
        },
        {
            "agentId": "UI",
            "match": {
                "channel": "feishu",
                "accountId": "UI"
            }
        },
        {
            "agentId": "FE",
            "match": {
                "channel": "feishu",
                "accountId": "FE"
            }
        },
        {
            "agentId": "BE",
            "match": {
                "channel": "feishu",
                "accountId": "BE"
            }
        },
        {
            "agentId": "TE",
            "match": {
                "channel": "feishu",
                "accountId": "TE"
            }
        }
    ]
}

添加完成后，重启网关

openclaw gateway restart

第七步：为飞书机器人配置事件与回调

依次为你的机器人配置事件与回调，具体步骤参考配置OpenClaw飞书AI助手，从第3步登录飞书开发者平台开始，忽略里面的可选步骤。

❗️别忘记授权飞书完成配对。

FAQ

1. Gateway 启动失败

根据启动报错确认哪些配置存在问题，然后按照提示修改即可。常见错误如下：

末端节点存在逗号，导致解析出错
节点名称写错

如果使用 TRAE 统一管理 Agent 和配置，则可以尝试让 TRAE 协助定位问题，如使用以下提示词：

请严格按照https://docs.openclaw.ai/gateway/configuration-reference 文档的格式要求解决 openclaw.json 中的以下报错：
xxx复制报错信息，并替换该段xxx

2. 机器人无响应

无响应时可以通过 openclaw logs --follow 查看是否存在报错。通常的原因如下

未配置事件与回调或者事件与回调配置错误。
绑定信息错误。
Channels 中匹配信息配置错误，导致无法正确路由信息。

3. Agent 间未隔离

检查 bindings 配置是否正确。