# OpenClaw 飞书多Agent配置教程#

2026-05-05阅读 0热度 0

飞书 Agent OpenClaw AI agent 多账户配置

OpenClaw 飞书多Agent配置教程

一、前言

想在同一套OpenClaw系统中部署多个不同能力的飞书机器人吗？这个需求很常见——比如需要一个通用助手处理日常问题，另一个深度思考机器人负责复杂推理，再加个创意设计机器人专门生成图片。好消息是，OpenClaw完全支持这种多Agent分离部署方案。

具体来说，你可以配置：

- 通用助手机器人：绑定main agent，处理日常咨询

- 深度思考机器人：绑定00-agent，专注复杂推理和长文本生成

- 创意设计机器人：绑定01-agent，擅长图片生成和创意设计

- 专业领域机器人：绑定特定领域agent，解决专业问题

这种架构既实现了能力隔离，又方便团队成员根据需求选择不同的机器人，大幅提升协作效率。

二、前置准备

1. 飞书开放平台准备

每个Agent都需要对应一个独立的飞书自建应用，准备工作如下：

首先，登录飞书开放平台，创建企业自建应用。接着启用“机器人”能力，然后根据实际需求申请相应权限。推荐申请这些核心权限：

- 文档读写：docs:document.content:read、sheets:spreadsheet

- 消息发送：im:message、im:message:send_as_bot

- 知识库访问：wiki:wiki:readonly

- 通讯录读取：contact:contact.base:readonly

- 资源上传：im:resource

应用发布后，记得获取企业管理员授权。最后，务必备份每个应用的App ID和App Secret，后续配置会用到。

2. OpenClaw 准备

确保OpenClaw环境已经安装并配置妥当，同时提前创建好需要绑定的多个Agent（如main/thinker/imagor等）。

三、配置步骤

1. 修改配置文件

编辑OpenClaw主配置文件openclaw.json，这是整个配置过程的核心。

步骤1：添加飞书账号配置

在channels.feishu.accounts下新增多个飞书账号配置：

"channels": {
  "feishu": {
    "enabled": true,
    "connectionMode": "websocket",
    "domain": "feishu",
    "groupPolicy": "disabled",
    "dmPolicy": "open",
    "allowFrom": ["*"],
    "defaultAccount": "main",
    "accounts": {
      "main": {
        "appId": "cli_xxxxxxxxxxxxxxx",
        "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "botName": "通用助手"
      },
      "thinker": {
        "appId": "cli_yyyyyyyyyyyyyyy",
        "appSecret": "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
        "botName": "00-agent"
      },
      "imagor": {
        "appId": "cli_zzzzzzzzzzzzzzz",
        "appSecret": "zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz",
        "botName": "01-agent"
      }
    }
  }
}

步骤2：添加路由绑定

在bindings数组中添加路由规则，将每个飞书账号绑定到对应Agent：

"bindings": [
  {
    "type": "route",
    "agentId": "main",
    "match": {
      "channel": "feishu",
      "accountId": "main"
    }
  },
  {
    "type": "route",
    "agentId": "00-agent",
    "match": {
      "channel": "feishu",
      "accountId": "00-agent"
    }
  },
  {
    "type": "route",
    "agentId": "01-agent",
    "match": {
      "channel": "feishu",
      "accountId": "01-agent"
    }
  }
]

2. 生效配置

配置完成后，通过命令行让配置生效：

# 修复配置问题（可选，根据提示操作）
openclaw doctor --fix

# 重启网关让配置生效
openclaw gateway restart

3. 用户配对

用户首次给飞书机器人发消息时，会收到配对提示和配对码。管理员需要执行以下命令批准配对：

openclaw pairing approve feishu <配对码>

批准后，用户就能正常与机器人对话了。

四、使用说明

1. 多机器人使用

每个飞书机器人对应一个独立的Agent能力，用户可以根据需求添加不同的机器人好友。不同机器人的对话历史和上下文完全隔离，确保了数据安全和使用体验。

2. 优势

这种架构设计带来了多重好处：

- 能力隔离：不同能力的Agent独立运行，互不干扰

- 场景适配：不同场景使用不同机器人，大幅提升使用效率

- 内网可用：飞书采用WebSocket连接，无需公网IP，内网环境也能顺畅使用

- 权限可控：每个机器人可以单独配置权限，满足企业级安全需求

五、常见问题

Q1: 配置后出现“飞书插件ID重复”警告？

这是正常提示，不影响实际使用，可以放心忽略。

Q2: 为什么用户发消息没反应？

遇到这种情况，建议按顺序检查：

1. 飞书应用是否已经发布并获得企业授权

2. 权限是否已经申请并通过审核

3. 用户是否已经完成配对流程

4. 网关是否正常运行：openclaw gateway status

Q3: 可以配置多少个飞书机器人？

理论上没有硬性限制，只要飞书开放平台允许创建足够多的应用。

Q4: 每个机器人可以添加多少用户？

这取决于飞书应用的用户限制，企业自建应用默认没有用户数量限制。

六、最佳实践

根据经验，遵循这些实践能让系统运行更稳定：

1. 机器人命名清晰：每个机器人的名称要明确体现其能力，方便用户快速选择

2. 权限最小化：每个机器人只申请必要的权限，提升整体安全性

3. 资源隔离：不同Agent配置不同的模型和资源限制，避免资源争抢

4. 监控告警：配置机器人使用监控，及时发现异常情况

---

本教程基于OpenClaw 2026.3.7版本编写，其他版本配置方式可能略有不同。

# OpenClaw 飞书多Agent配置教程#