飞书接入

更新时间:
复制为 MD 格式

本文介绍如何通过飞书应用与机器人接入OpenClaw,实现用户与机器人对话,驱动OpenClaw完成相关任务。

方案概述

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

  • 创建飞书应用并与云电脑OpenClaw进行安全凭证对接。

  • 配置飞书应用及机器人。

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

创建飞书应用并进行安全凭证对接

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

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

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

  4. 返回云电脑OpenClaw Config页面选择通道设置

  5. 开启飞书卡片右侧开关,将复制的 App ID 和 App Secret 分别填入 应用 ID(APPID) 及 APP SECRET 。

  6. 填写完毕后点击右上角保存

配置飞书应用及机器人

配置应用权限

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

  2. 粘贴以下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"]
      }
    }
  3. 在弹窗中确认权限无误后,单击申请开通按钮,完成操作。

配置事件并发布

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

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

    重要

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

  3. 点击添加事件,添加接收消息(im.message.receive_v1)。

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

配对授权

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

    image

  2. 打开云电脑终端,执行以下命令批准配对:openclaw pairing approve feishu <配对码>

  3. 执行以下命令重启OpenClaw服务:openclaw gateway restart