Skip to content

飞书机器人接入

准备工作

请开启SCNet OpenClaw服务,确保OpenClaw处于“运行中”状态:

alt text

第一步:创建飞书应用

打开飞书开放平台

访问 飞书开放平台,使用飞书账号登录。

创建应用

  1. 点击 创建企业自建应用
  2. 填写应用名称和描述
  3. 选择应用图标

alt text

获取应用凭证与回调加密策略凭证

在应用的 凭证与基础信息 页面,复制:

  • App ID(格式如 cli_xxx
  • App Secret

❗ 重要:请妥善保管 App Secret,不要分享给他人。

alt text

在事件与回调页面,点击加密策略,保存Verification Token与Encrypt Key

Encrypt Key需要自行设置

alt text

配置应用权限

在 权限管理 页面,点击 批量导入 按钮,粘贴以下 JSON 配置一键导入所需权限:

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:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

注意:im:message.group_msg 权限(获取群组中所有消息,属于敏感权限)允许机器人接收群组中所有消息(不仅仅是 @机器人的)。如果您需要配置 requireMention: false 让机器人无需 @ 也能响应,则必须添加此权限。

alt text

启用机器人能力(可选)

在 应用能力 > 机器人 页面:

  1. 开启机器人能力,配置完成后,会默认开启
  2. 配置机器人名称

alt text


第二步:配置Openclaw feishu channel

配置feishu channels

在超算互联网Openclaw页面,点击代理,选择Raw,在右边的json配置中找到channels配置,修改feishu下的以下五项:

  1. enabled修改为true
  2. appId修改为第一步应用凭证的appId
  3. appSecret修改为第一步应用凭证的Secret
  4. verificationToken修改为第一步回调加密策略的凭证的Verification Token
  5. encryptKey修改为第一步回调加密策略凭证的Encrypt Key

alt text

配置plugins entries

plugins-entries,配置feishu的enabled为true,最后点击save保存,等待服务重启完成,右上角健康状况正常。

alt text


第三步:配置飞书事件订阅

配置事件订阅

注:该步需要校验飞书机器人与openclaw的连接关系,因此必须先配置完成openclaw feishu channel,才能进行事件配置

回到飞书开放平台的机器人页面,点击事件与回调,订阅方式选择,”将事件发送至 开发者服务器"

alt text

请求地址为已启动的OpenClaw服务公网域名+ /feishu/events,域名地址如下:

alt text

拼接示例:https://c-2033480479177613313.ksai.scnet.cn:58043/feishu/events

点击保存后,飞书机器人将校验与openclaw的连接可用性,若连接可用则可正常保存

添加事件

为当前事件订阅添加事件,选择消息与群组,事件中必须包含 im.message.receive_v1,其他均可选:

alt text

  1. 在 版本管理与发布 页面创建版本
  2. 提交审核并发布
  3. 等待管理员审批(企业自建应用通常自动通过)

第三步:发布&使用

在飞书开放平台,点击创建版本,发布最新版本,等待管理员审批(企业自建应用通常自动通过)

alt text

应用发布完成后,即可在飞书使用,如下图所示:

alt text