飞书/Lark 接入-无影云电脑企业版-阿里云帮助中心

本文介绍如何通过飞书或 Lark 接入 Agent。飞书提供极速配对（扫码即用，无需建应用）和关联已有机器人两种方式；Lark 仅支持关联已有机器人。

前提条件

已在 Agent 管理中心创建 Agent。

通道配置

前往Agent 管理中心。
在左侧导航栏，选择您的 Agent 类型，例如 JVS Computer。
单击通道配置。
单击目标 Agent 操作列中的查看/配置通道。
在飞书卡片上，单击立即配置。
说明
- 对于中国大陆以外地域的 OpenClaw 和 JVS Computer，飞书卡片会显示为飞书/Lark。您可以在通道类型下拉菜单中选择飞书或 Lark。
- 对于中国大陆地域和其他 Agent 类型，仅支持飞书。

飞书

选择以下任一方式完成飞书机器人接入：

极速配对

说明

极速配对不支持 OpenClaw 类型 Agent，请改用关联已有机器人方式。
要求云电脑镜像版本满足：Linux 3.0.10 及以上。如需更新，可重启云电脑。

单击立即发送。系统会向授权用户下发包含访问链接的短信或邮件。
授权用户通过短信或邮件中的 URL 访问绑定页面获取二维码（您也可在控制台直接获取该 URL）。
使用飞书扫描二维码，完成机器人绑定。

说明

如已绑定其他机器人，扫码后将被替换。

关联已有机器人

说明

本方式要求您所在的飞书企业已具备开发者权限。如所在企业暂无该权限，请联系企业管理员开通。

创建飞书应用

访问飞书开放平台，点击右上角开发者后台。
点击创建企业自建应用，填写必要信息。
在应用的凭证与基础信息页面，复制App ID（格式如cli_xxx）和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:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在弹窗中确认权限无误后，单击申请开通完成操作。

配置事件并发布机器人

在应用能力 > 机器人页面开启机器人能力，并配置机器人名称。
在事件与回调页面，单击事件配置 > 订阅方式，选择使用长连接接收事件并保存。
单击添加事件，添加接收消息（im.message.receive_v1）。
前往版本管理与发布 > 创建版本，填写必要信息后单击保存。

填写凭证完成关联

回到无影云电脑控制台 Agent 管理中心。输入飞书应用的 App ID 和 App Secret，然后单击确认。

配对授权

在飞书中找到已绑定的机器人，向其发送任意一条消息触发配对。

机器人会回复一条消息，其中包含 Feishu user ID 和 Pairing code（配对码），并提示使用命令 openclaw pairing approve feishu <配对码> 完成审批。请记录该配对码，用于后续审批。
打开云电脑终端，执行以下命令批准本次配对：openclaw pairing approve feishu <配对码>。
执行以下命令重启 OpenClaw 服务，使配对授权生效：openclaw gateway restart。

服务重启后，即可在飞书中与机器人正常对话，由 Agent 完成相关任务。

Lark

说明

Lark 通道仅适用于中国大陆以外地域的 OpenClaw 和 JVS Computer。
本方式要求您所在的 Lark 组织已具备开发者权限。如所在组织暂无该权限，请联系组织管理员开通。

创建 Lark 应用

访问Lark 开放平台，点击右上角开发者后台。
点击创建企业自建应用，填写必要信息。
在应用的凭证与基础信息页面，复制App ID（格式如cli_xxx）和App Secret。

配置应用权限

在 Lark 开放平台的应用详情页，单击权限管理 > 开通权限，然后单击批量导入/导出权限。

粘贴以下 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:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在弹窗中确认权限无误后，单击申请开通完成操作。

配置事件并发布机器人

在应用能力 > 机器人页面开启机器人能力，并配置机器人名称。
在事件与回调页面，单击事件配置 > 订阅方式，选择使用长连接接收事件并保存。
单击添加事件，添加接收消息（im.message.receive_v1）。
前往版本管理与发布 > 创建版本，填写必要信息后单击保存。

填写凭证完成关联

回到无影云电脑控制台 Agent 管理中心。输入 Lark 应用的 App ID 和 App Secret，然后单击确认。

配对授权

在 Lark 中找到已绑定的机器人，向其发送任意一条消息触发配对。

机器人会回复一条消息，其中包含 Lark user ID 和 Pairing code（配对码），并提示使用命令 openclaw pairing approve lark <配对码> 完成审批。请记录该配对码，用于后续审批。
打开云电脑终端，执行以下命令批准本次配对：openclaw pairing approve lark <配对码>。
执行以下命令重启 OpenClaw 服务，使配对授权生效：openclaw gateway restart。

服务重启后，即可在 Lark 中与机器人正常对话，由 Agent 完成相关任务。