飞书接入

重要

无影OpenClaw镜像最新版本为:个人版——OpenClaw-SE-0307/企业版——3月7日更新版本,本文档基于此版本编制

通过飞书应用与机器人,实现用户通过飞书与机器人对话,驱动OpenClaw完成相关任务。接入主要包含以下步骤:

  • 创建应用并与云电脑系统OpenClaw进行安全凭证对接

  • 配置飞书应用及机器人

  • 获取飞书机器人的配对码,并在openclaw中批准代码

参考资料:OpenClaw飞书通道接入的官方文档

一、 创建飞书应用并对接安全凭证

  1. 访问 飞书开放平台,点击右上角开发者后台。

  1. 点击创建企业自建应用,填写必要信息。

  1. 在应用的凭证与基础信息页面,复制App ID(格式如 cli_xxx)和App Secret

  1. 返回云电脑,将复制的 App IDApp Secret 分别填入 应用 ID(APPID)APP SECRET 。填写完毕后点击保存配置

二、配置飞书应用及机器人

2.1 配置应用权限

  1. 点击权限管理>开通权限,单击“批量导入/导出权限”按钮。

  1. 粘贴以下 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"]
  }
}

  1. 在弹窗中确认权限无误后,单击申请开通按钮,完成操作。

2.2 启用机器人能力

  1. 应用能力 > 机器人页面开启机器人能力,并配置机器人名称

2.3 配置事件订阅

重要

在配置事件订阅前,请务必确保完成了第一步中飞书通道的配置

  1. 事件与回调页面,点击事件配置>订阅方式,选择使用 长连接 接收事件并保存,

  1. 点击添加事件,添加im.message.receive_v1

2.4 发布应用

  1. 前往版本管理与发布>创建版本,填写必要信息后点击保存。

三、配对授权

  1. 在飞书中找到创建的机器人,发送一条消息,记录消息中的配对码

  1. 打开云电脑Termial,运行如下代码以批准配对
openclaw pairing approve feishu <配对码>

  1. 重启OpenClaw服务
openclaw gateway restart