[小龙虾 OpenClaw] 飞书连接指南


1.打开飞书开放平台

访问飞书开放平台https://open.feishu.cn/app),使用飞书账号登录。

2.创建应用

点击“创建企业自建应用”,填写应用名称和描述,选择应用图标。

3.获取应用凭证

在应用的“凭证与基础信息”页面,复制:
App ID(格式如cli_xxx)、App Secret
❗重要:请妥善保管 App Secret,不要分享给他人。

4.配置应用权限

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

            
{
  "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"
    ]
  }
}
              
        

5.启用机器人能力

在 添加应用能力 > 机器人 页面:
开启机器人能力,配置机器人名称。

6.发布应用

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

7.配置事件订阅

在“事件订阅”页面:
【注意:应用版本是否发布成功,不成功无法选择“使用长连接接收事件”】
(1)选择“使用长连接接收事件”(WebSocket 模式)。

(2)添加事件:im.message.receive_v1(接收消息)
【注意:如果网关未启动或渠道未添加,长连接设置将保存失败】

8.再次发布应用

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

9.开始使用

通讯录页面飞书搜索,群聊天页面添加群成员,搜索Bot名称即可。