OpenClaw 多 Agent 配置完全指南：从单打独斗到团队协作 ​

一个人干不完所有活，AI 也是一样。本文从"人"的视角出发，讲清楚为什么要在 OpenClaw 里用多 Agent，以及如何一步步在 OpenClaw 和飞书里把它们配起来。

OpenClaw GitHub: https://github.com/OpenClawAI/openclaw

一、先聊聊"为什么" ​

1.1 一个助手的困境 ​

想象一下，你雇了一个全能秘书。他既要帮你写文案，又要帮你查代码 Bug，还要回答客户的售后问题。时间一长，你会发现几个问题：

这就是"单 Agent"模式的真实痛点。OpenClaw 默认只有一个名叫 main 的 Agent，所有消息都涌向它。当你的使用场景变多，问题就来了。

1.2 多 Agent 的本质：各司其职 ​

多 Agent 的核心思想很简单——让不同的 AI 助手各管一摊事。每个 Agent 在 OpenClaw 里拥有：

打个比方：单 Agent 是一个人开的小店，什么都得自己干；多 Agent 是一个团队，有人管前台接待，有人管技术支持，有人管内容创作。各司其职，井然有序。

1.3 哪些场景特别适合多 Agent？ ​

二、核心概念：先认识几个关键词 ​

在动手之前，有几个 OpenClaw 的概念需要先理解（不需要看代码，只是帮你建立心智模型）：

它们的关系可以这样理解：

消息来源（飞书群/私聊） ➡️ Channel（飞书） ➡️ Account（哪个机器人收到的） ➡️ Binding（路由规则） ➡️ Agent（具体哪个 AI 助手来处理）

三、动手配置：OpenClaw 多 Agent 设置 ​

3.1 前提条件 ​

确保你已经安装了 OpenClaw，并且单 Agent 模式下能正常使用。如果还没装，先按官方文档完成基础安装。

3.2 第一步：创建新的 Agent ​

用命令行创建一个新 Agent：

openclaw agents add developer
openclaw agents add writer

这会在 ~/.openclaw/agents/ 下新建两个文件夹：developer 和 writer。每个文件夹里会自动生成一个 SOUL.md 文件。

3.3 第二步：给每个 Agent 写"灵魂" ​

编辑每个 Agent 的 SOUL.md，这是它的性格说明书。

开发助手（~/.openclaw/agents/developer/SOUL.md）：

你是一位资深全栈开发工程师。
你的回答风格是：精准、务实、重视最佳实践。
遇到技术问题，你会先分析根因，再给出解决方案。
你擅长 Python、TypeScript、DevOps。

写作助手（~/.openclaw/agents/writer/SOUL.md）：

你是一位经验丰富的内容创作者。
你的文字温暖、有节奏感，善于用比喻让复杂概念变得易懂。
你会根据目标读者调整语气和深度。

3.4 第三步：为每个 Agent 配置模型（可选） ​

如果你希望不同 Agent 使用不同的模型，可以通过命令行或配置文件设置：

openclaw agents config set developer model claude-sonnet-4-6
openclaw agents config set writer model claude-opus-4-6

写作用更强的模型，开发用性价比更高的——按需分配。

3.5 第四步：确认 Agent 列表 ​

openclaw agents list

你应该能看到三个 Agent：main（默认的）、developer、writer。

四、接入飞书：让多个 Agent 各守一方 ​

4.1 前置条件：安装飞书官方插件 ​

如果你还没装飞书插件，先确保 OpenClaw 版本满足要求：

可用 openclaw -v 查看当前版本。

飞书现已支持一键部署 OpenClaw 并自带飞书官方插件。如果需要手动安装或升级插件：

# 升级飞书官方插件到最新版
npx -y @larksuite/openclaw-lark update

安装完成后，在飞书对话中发送 /feishu start，若返回版本号信息，则代表安装成功。

4.2 飞书的多 Agent 逻辑 ​

飞书的多 Agent 不是"一个 Agent 一个机器人"那么简单，而是支持两种模式混用：

1. 一个机器人对应多个群（不同群绑不同 Agent）
2. 多个机器人各自独立

最常见的玩法是：在同一家飞书企业下创建多个机器人应用，每个机器人对应一个 Account，再通过 Binding 把不同的群或私聊路由到不同的 Agent。

快捷方式：如果不想手动折腾配置，OpenClaw 提供了两种快速创建的方法：

如果你想完全掌控配置细节，请按下面的步骤手动操作。

4.3 第一步：在飞书开放平台创建机器人 ​

登录 飞书开放平台，为你的每个 Agent 创建一个企业自建应用：

1. 进入"创建应用" → 选择"企业自建应用"
2. 填写名称（比如"开发助手""写作助手"）
3. 添加"机器人"能力
4. 在"权限管理"里，开启消息收发等相关权限
5. 记下每个应用的 App ID 和 App Secret
6. 发布并审批通过

安装完成后，建议在飞书对话中发送 /feishu auth 来完成批量授权，便于 OpenClaw 后续通过你的身份操作消息、文档、日历等。

4.4 第二步：配置飞书通道 ​

手动编辑 ~/.openclaw/openclaw.json，找到或添加 channels.feishu 部分。

⚠️ 重点注意：默认（主）机器人的 appId 和 appSecret 必须放在 channels.feishu 的顶层，不能放在 accounts 里——这是飞书插件的一个设计要求，放错位置会报 "not configured"。

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_主助手的AppID",
      "appSecret": "主助手的AppSecret",
      "requireMention": true,
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["ou_你的用户OpenID"],
      "groups": { "*": { "enabled": true } },
      "accounts": {
        "developer": {
          "appId": "cli_开发助手的AppID",
          "appSecret": "开发助手的AppSecret"
        },
        "writer": {
          "appId": "cli_写作助手的AppID",
          "appSecret": "写作助手的AppSecret"
        }
      }
    }
  }
}

4.5 第三步：配置 Binding（路由规则） ​

Binding 是多 Agent 的核心——它决定了"谁的消息发给哪个 Agent"。

在同一个 openclaw.json 文件中，添加 session 配置：

{
  "session": {
    "bindings": [
      {
        "channel": "feishu",
        "account": "developer",
        "agent": "developer"
      },
      {
        "channel": "feishu",
        "account": "writer",
        "agent": "writer"
      }
    ],
    "defaultAgent": "main"
  }
}

这个配置的意思是：

更高级的绑定规则，还可以指定"某个群"或"某个私聊"：

{
  "session": {
    "bindings": [
      {
        "channel": "feishu",
        "account": "developer",
        "group": "oc_代码审查群ID",
        "agent": "developer"
      },
      {
        "channel": "feishu",
        "account": "writer",
        "group": "oc_写作交流群ID",
        "agent": "writer"
      }
    ]
  }
}

4.6 第四步：重启 OpenClaw ​

配置完成后，重启 OpenClaw 使配置生效：

openclaw restart

4.7 验证配置 ​

在飞书里向不同的机器人发送消息，确认每个机器人都由对应的 Agent 响应：

# 在飞书主助手里问
你是谁？

# 在开发助手里问
你是谁？

# 在写作助手里问
你是谁？

如果配置正确，每个助手应该有不同的自我介绍（来自它们各自的 SOUL.md）。

五、进阶：隔离与共享的边界 ​

多 Agent 不只是"分工"，还有一个常常被忽视的好处——可以精细控制哪些东西共享，哪些东西隔离。

5.1 私人领地：每个 Agent 独享的 ​

5.2 公共区域：可选共享的 ​

5.3 一个典型设计：三人小组 ​

假设你有三个 Agent：main（通用）、developer（开发）、writer（写作）。

推荐设计：

这样，developer Agent 有独立的权限去访问服务器，而 writer 完全碰不到；同时，它们都能查阅公共知识库（比如"公司介绍"）。

六、常见踩坑与排查 ​

6.1 Binding 不生效，所有消息都跑到 main Agent ​

原因：Binding 配置写错了，或者 account 字段和飞书里的 App 不匹配。

排查：

# 查看当前配置
openclaw config get session.bindings

# 确认飞书 Account 名称和 Binding 里的 account 字段一致

6.2 飞书机器人没反应 ​

原因：权限没开，或者机器人没正确订阅消息事件。

排查：

1. 去飞书开放平台，确认"事件订阅"已开启
2. 确认机器人已发布并审批通过
3. 检查 openclaw.json 里 channels.feishu.enabled 是否为 true

6.3 Agent 配置不生效 ​

原因：改了配置后没重启 OpenClaw。

排查：

openclaw restart

6.4 Worker 队列报错 ​

原因：消息处理队列出了问题，常见于高并发或配置冲突。

排查：

# 查看 worker 状态
openclaw inspect workers

# 如果卡住，可以清空队列重来
openclaw queue clear

6.5 模型调用失败 ​

原因：某个 Agent 的模型配置不正确，或者 API Key 过期。

排查：

# 查看模型配置
openclaw agents config get developer model

# 检查 API Key 是否有效
openclaw models test

6.6 飞书群内回复模式不对 ​

飞书群支持四种回复模式，默认是"仅@回复"：

七、总结：从单打独斗到团队协作 ​

多 Agent 的本质，不是堆数量，而是在正确的地方，用正确的人，做正确的事。

从单 Agent 到多 Agent，不是炫技，是管理思维的升级。一个人干不完所有活，AI 也是一样。