2026 最新|OpenClaw 飞书渠道配置全流程:企业自建应用 + 长连接事件 + 权限一键导入
文章标签:#OpenClaw #小龙虾 AI #本地 AI #飞书机器人 #AI 办公自动化 #Windows 一键部署
前言
本文基于飞书开放平台官方页面、配套截图素材,以及 OpenClaw Windows 现有飞书配置方式整理,适用于先在飞书开放平台创建企业自建应用,再将 App ID 和 App Secret 填入 OpenClaw的标准接入流程。小龙虾一键部署包下图:

核心结论:OpenClaw 当前飞书渠道仅需填写App ID、App Secret两个参数;飞书侧推荐使用长连接接收事件,并完成应用创建、机器人能力、事件订阅、权限开通、版本发布 5 个核心环节,即可实现稳定对接。
前置准备
已安装并可正常启动 OpenClaw Windows 客户端
已登录飞书开放平台,可进入开发者后台
准备可用的飞书组织 / 企业空间
企业账号发布版本时,需完成企业管理员审核
图文配置步骤
步骤 1:打开飞书开放平台,创建企业自建应用
访问飞书开放平台:https://open.feishu.cn/app

进入页面后,点击右上角「开发者后台」,选择创建企业自建应用。
步骤 2:填写应用信息并创建
设置应用名称、描述、头像(默认 / 自定义均可),完成后点击「创建」。

步骤 3:添加机器人应用能力
进入应用管理页,点击左侧「添加应用能力」,在列表中找到机器人并点击「添加」。

步骤 4:进入事件与回调配置
左侧菜单栏选择「事件与回调」,在事件配置区域,点击订阅方式右侧的编辑按钮。

步骤 5:选择长连接接收事件并保存
请勿选择「将事件发送至开发者服务器」,OpenClaw 飞书接入无需配置公网回调地址。
选择使用长连接接收事件,完成后点击保存。

步骤 6:添加消息接收事件
保存订阅方式后,在「已添加事件」区域点击添加事件。

步骤 7:配置接收消息核心事件
在弹窗中搜索「接收」,勾选接收消息(im.message.receive_v1),点击「添加」。
该事件为飞书机器人接收消息核心配置,未配置将导致 OpenClaw 无法接收飞书消息。

步骤 8:开通关联权限
飞书弹出「推荐开通以下权限」提示时,直接点击确认开通权限。

步骤 9:检查权限开通状态
返回事件列表,展开事件下方权限说明,确保所有权限均为已开通状态;存在未开通权限时,点击权限名称完成补开。

步骤 10:进入权限管理批量导入
左侧打开「权限管理」,点击批量导入 / 导出权限。

步骤 11:粘贴完整权限 JSON
清空导入窗口默认内容,将以下完整权限 JSON 整段粘贴:
json
{
"scopes": {
"tenant": [
"aily:message:read",
"aily:message:write",
"base:app:copy",
"base:app:create",
"base:app:read",
"base:app:update",
"base:collaborator:create",
"base:collaborator:delete",
"base:collaborator:read",
"base:dashboard:copy",
"base:dashboard:read",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:form:read",
"base:form:update",
"base:record:create",
"base:record:delete",
"base:record:read",
"base:record:retrieve",
"base:record:update",
"base:role:create",
"base:role:delete",
"base:role:read",
"base:role:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"bitable:app",
"bitable:app:readonly",
"board:whiteboard:node:create",
"board:whiteboard:node:delete",
"board:whiteboard:node:read",
"board:whiteboard:node:update",
"cardkit:card:write",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"contact:user.employee_number:read",
"contact:user.id:readonly",
"docs:doc",
"docs:doc:readonly",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.comment:write_only",
"docs:document.content:read",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document.subscription",
"docs:document.subscription:read",
"docs:document:copy",
"docs:document:export",
"docs:document:import",
"docs:event.document_deleted:read",
"docs:event.document_edited:read",
"docs:event.document_opened:read",
"docs:event:subscribe",
"docs:permission.member",
"docs:permission.member:auth",
"docs:permission.member:create",
"docs:permission.member:delete",
"docs:permission.member:readonly",
"docs:permission.member:retrieve",
"docs:permission.member:transfer",
"docs:permission.member:update",
"docs:permission.setting",
"docs:permission.setting:read",
"docs:permission.setting:readonly",
"docs:permission.setting:write_only",
"docx:document",
"docx:document.block:convert",
"docx:document:create",
"docx:document:readonly",
"drive:drive",
"drive:drive.metadata:readonly",
"drive:drive.search:readonly",
"drive:drive:readonly",
"drive:drive:version",
"drive:drive:version:readonly",
"drive:export:readonly",
"drive:file",
"drive:file.like:readonly",
"drive:file.meta.sec_label.read_only",
"drive:file:download",
"drive:file:readonly",
"drive:file:upload",
"drive:file:view_record:readonly",
"event:ip_list",
"im:app_feed_card:write",
"im:chat",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg",
"im:message:send_as_bot",
"im:message:readonly",
"im:message:update",
"sheets:spreadsheet",
"sheets:spreadsheet:create",
"sheets:spreadsheet:read",
"space:folder:create",
"wiki:node:create",
"wiki:node:read",
"wiki:node:update",
"wiki:space:read"
],
"user": []
}
}

步骤 12:确认新增权限
粘贴完成后,点击下一步,确认新增权限。

步骤 13:配置数据范围(保持默认)
部分权限需确认可访问数据范围,保持默认与应用的可用范围一致,点击「确认」。

步骤 14:进入版本管理与发布
权限与事件配置完成后,需发布版本使配置生效;可点击顶部「创建版本」,或左侧进入「版本管理与发布」。

步骤 15:填写版本信息
设置版本号(如 1.0.0、1.0.1),移动端 / 桌面端默认能力保持机器人,填写更新说明(如:更新事件订阅、开通完整权限)。

步骤 16:保存版本信息
下拉页面至底部,点击「保存」。

步骤 17:完成应用发布
保存后点击确认发布;个人用户可直接发布,企业用户需等待管理员审核通过。

步骤 18:复制 App ID 与 App Secret
返回左侧「凭证与基础信息」,复制App ID、App Secret两个参数。

步骤 19:填入 OpenClaw 飞书配置
打开 OpenClaw,点击右上角「设置」→「聊天配置」,找到 Feishu/Lark(飞书)配置卡片,填入复制的 App ID、App Secret。

步骤 20:启用并保存渠道配置
打开飞书渠道开关,点击右上角保存渠道配置,完成接入。

接入完成自检清单
飞书应用已添加「机器人」能力
事件与回调使用「长连接接收事件」
已添加 im.message.receive_v1 接收消息事件
所有事件关联权限均为已开通状态
完整权限 JSON 已导入并生效
应用版本已保存并发布
App ID、App Secret 正确填入 OpenClaw
OpenClaw 已完成渠道配置保存
常见问题解答
1. OpenClaw 配置完成,飞书机器人无响应
检查飞书应用是否发布成功
确认事件订阅为 im.message.receive_v1
核对订阅方式为长连接接收事件
保存配置后重启 OpenClaw Gateway 服务
检查 App Secret 是否存在多余空格或参数错误
2. 为何无需配置公网回调地址
当前 OpenClaw 飞书接入采用飞书官方长连接模式,仅需 App ID 与 App Secret,无需手动配置 Webhook URL。
3. 权限是否必须完整导入
仅实现消息收发可开通基础权限;如需使用文档、云空间、多维表格、知识库等扩展能力,建议导入完整权限 JSON。
参考链接
飞书开放平台开发者后台:https://open.feishu.cn/app
小龙虾一键部署包下图:
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)