OpenClaw 多 Agent 实战：从零搭建 AI 开发团队

# OpenClaw 多 Agent 实战：从零搭建 AI 开发团队 > 来源: https://developer.volcengine.com/articles/7617825213975920703 > 采集时间: 2026-03-27 16:14 大模型Agent 前文讲了在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 配置是否正确。