跳转至

飞书集成

本文档介绍如何将 OpenClaw 与飞书进行集成,实现通过飞书与 Openclaw 对话。

创建飞书应用

步骤 1:创建企业自建应用

  1. 登录 飞书开放平台

  2. 单击 创建企业自建应用 按钮。

    创建应用

步骤 2:配置应用信息

配置应用名称、描述及图标,单击 创建 按钮完成创建。

添加机器人

步骤 3:添加机器人能力

  1. 在左侧目录树选择 应用能力 -> 添加应用能力
  2. 选择 按能力添加 页签。
  3. 单击 机器人 能力卡片的 添加 按钮。

    权限管理入口

配置权限

导入权限配置

  1. 在左侧目录树选择 开发配置 -> 权限管理

  2. 单击 批量导入/导出权限 按钮。

    导入权限

  3. 导入 页签中,粘贴权限配置代码

  4. 单击 下一步,确认新增权限 按钮。

  5. 在弹窗中确认权限无误后,单击 申请开通 按钮。

    权限配置

权限配置代码

点击查看权限配置代码
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "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",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access",
      "base:app:copy",
      "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",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:write_only",
      "docs:document:export",
      "docs:document.media:upload",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar: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",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "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"
    ]
  }
}

相关权限的具体含义可查看 飞书 API 权限列表

发布应用

步骤 1:创建版本并发布

  1. 单击顶部的 创建版本 按钮。

    创建版本

  2. 按需配置应用版本号、默认能力及更新说明等信息。

    配置版本

  3. 单击页面底部的 保存 按钮创建版本。

    保存版本

  4. 单击页面右上角的 确认发布 按钮完成应用发布。

    发布应用

步骤 2:获取配置信息

  1. 在左侧目录树选择 基础信息 -> 凭证与基础信息

  2. 应用凭证 模块中,获取并记录 App IDApp Secret 信息。

    获取配置

配置事件订阅与回调长连接

注意 :对于未配置长连接的机器人应用,需要在获取 App IDApp Secret 后,启动 Openclaw 实例,才能保存事件与回调长连接配置。请参考Openclaw 快速入门文档启动 Openclaw 实例。

配置事件订阅

  1. 点击左侧事件与回调,配置 事件订阅 方式为 长连接

    事件订阅

  2. 添加接收消息事件(可自定义其他事件):

    添加事件

配置回调

  1. 点击 回调配置

  2. 配置方式选择 长连接

    回调订阅

  3. 添加回调。

    添加配置

发布版本

发布版本并等待审核通过。

发布版本

开始对话

在飞书中找到您的机器人,开始愉快地对话吧!

对话