使用 OpenClaw 搭建飞书多智能体机器人团队-轻量型云主机-最佳实践-一键部署OpenClaw操作指南

本文将详细介绍如何在天翼云云主机上，用 OpenClaw 搭建一套飞书多智能体机器人团队，让 AI 机器人协同工作，实现：

多个独立的飞书机器人，每个人设不同；
各自独立的工作空间，数据隔离。

前置依赖

在开始配置前，需完成以下前置准备工作：

已完成 OpenClaw 服务器的部署。
已为 OpenClaw应用配置大模型。
拥有飞书群组创建权限。

步骤1：在飞书开放平台创建机器人应用。

创建企业自建应用。
访问飞书开放平台，点击“创建企业自建应用”。

填写应用名称、描述和图标，点击“创建”按钮，创建新机器人应用。

创建成功后，进入“凭证与基础信息”页，妥善保管App ID 和App Secret。
添加机器人应用。
进入“添加应用能力”页，为应用添加机器人能力。找到机器人卡片，点击“配置”。

配置应用权限。

进入“权限管理”页，通过批量导入/导出权限，为应用配置权限。点击“批量导入/导出权限”。

复制以下权限配置内容，粘贴到批量导入/导出权限窗口-导入页签内的JSON输入框中，点击“下一步，确认新增权限”。

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "docx:document:readonly",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "calendar:calendar:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document.media:upload",
      "docs:document:copy",
      "docs:document:export",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:read",
      "im:chat.members:write_only",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "offline_access",
      "search:docs:read",
      "search:message",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:write_only",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

确认权限配置无误后，点击“申请开通”。

说明

若需要使用多Agent，请重复步骤一中的操作，创建对应数量的机器人应用。

步骤二：创建智能体（Agent）并配置工作目录。

登录天翼云计算控制台，找到已部署OpenClaw的云主机，在更多操作中，点击“重置密码”，设置登录密码。

登录目标云主机。点击“远程登录”。

天翼云提供的镜像为Linux系统，因此本文以Linux系统为例，在管理终端页面中，输入用户名（默认为root）及密码，登录云主机。
创建 Agent 。在云主机中输入以下命令创建Agent，支持创建多个Agent。
```
openclaw agents add agentId --workspace ~/.openclaw/workspace/agentId
```
命令末尾参数 [agentId] 支持自定义配置，可根据机器人业务场景灵活命名。
示例：在OpenClaw云主机内，创建3个Agent，分别命名为“planning-bot”“drawing-bot”及“coding-bot”负责不同的类型的任务，命令及部分执行结果如下：
```
openclaw agents add planning-bot --workspace ~/.openclaw/workspace/planning-bot
openclaw agents add drawing-bot --workspace ~/.openclaw/workspace/drawing-bot
openclaw agents add coding-bot --workspace ~/.openclaw/workspace/coding-bot
```

将飞书机器人注册到OpenClaw。在云主机中，继续执行以下命令：

openclaw config set channels.feishu.accounts.accoundId '{"appId":"appId_xxxxx","appSecret":"appSecret_xxxxx"}' --strict-json

其中，命令中的参数及填写说明如下：

参数	说明	示例
accountId	支持自定义，可命名为与agentID关联的名称以便于管理。	planning
appId_xxxxx	飞书App ID，可飞书进入“凭证与基础信息”页中获取。	cli_a9496
appSecret_xxxxx	飞书App Secret，可飞书进入“凭证与基础信息”页中获取。	S88C1

示例：上一步创建的“planning-bot”“drawing-bot”及“coding-bot”都需注册，命令及部分执行结果如下：

openclaw config set channels.feishu.accounts.planning '{"appId":"cli_a94","appSecret":"Eop"}' --strict-json
openclaw config set channels.feishu.accounts.drawing '{"appId":"cli_a94","appSecret":"tSU"}' --strict-json
openclaw config set channels.feishu.accounts.coding '{"appId":"cli_a94","appSecret":"XEE"}' --strict-json

配置路由。继续在云主机中执行以下命令，配置通道（飞书）accountId 与 agent 之间的路由关系：
```
openclaw agents bind --agent agentId --bind feishu:accountId
```
命令中，[accountId] 与 [agentId] 为前置操作中定义的名称。
示例：如上文操作中，策划Agent [accountId ] 为“planning”， [agentId] 为“planning-bot”，剩余两个Agent配置同理，命令及部分执行结果如下：
```
openclaw agents bind --agent planning-bot --bind feishu:planning
openclaw agents bind --agent drawing-bot --bind feishu:drawing
openclaw agents bind --agent coding-bot --bind feishu:coding
```
若需要配置多个 Agent ，重复步骤2中创建 Agent > 将机器人注册到 OpenClaw 中 > 配置路由操作即可。完成 Agent 配置后，需重启 OpenClaw 应用。在云主机中执行以下命令：
```
openclaw gateway restart
```

步骤三：飞书配置机器人事件并发布应用

注意

进行步骤三配置前，请确保已完成以上配置流程，并确保 OpenClaw Gateway 在正常运行状态，否则可能导致配置失败

配置事件订阅方式。登录飞书开放平台，进入需要配置的机器人详情页，从左侧导航中进入“事件与回调”页，配置订阅方式。
点击编辑按钮，在展开的表单中，选择“使用长连接接收事件”并保存。
添加事件。点击“添加事件”按钮，在弹窗中，以“应用身份”，选择并添加以下事件：“接收消息”、“消息已读”、“机器人进群”、“机器人被移出群”。
添加好后，可在列表中查看已添加的已添加的事件。
配置回调订阅方式。进入“回调配置”Tab页签，点击订阅方式编辑按钮。
在展开的菜单中选择“使用长连接接收回调”并保存。
发布应用。从左侧导航中，进入“版本管理与发布页”，点击创建版本按钮。
填写版本详情后，点击底部“保存”按钮，申请发布应用。
管理员用户在飞书管理后台中，进行应用审核并通过后，即完成应用发布。

说明

若需要使用多Agent，请重复步骤三中的操作，每个机器人应用都需要进行事件配置。

步骤四：在飞书中添加机器人并配对

打开飞书桌面应用，左侧导航进入“工作台”模块，点击“添加应用”按钮。
在添加常用弹窗中，搜索前置步骤三中发布的机器人并添加。
添加完成后，在左侧导航中搜索机器人名称关键字，并发送任意消息，如“你好”，即可获取飞书配对信息，注意保存最后一行信息。
返回天翼云控制台-云主机列表，找到OpenClaw云主机，点击“远程登录”按钮。
输入登录名“root”及步骤一中设置的密码，在远程登录页面输入飞书配对信息中的最后一行。
```
openclaw pairing approve feishu Y******
```
说明
若您设置了多个机器人，每个机器人都需要重复步骤四的操作，完成配对操作。