当前位置：首页 > news >正文

【企业办公增效】：OpenClaw 绑定飞书机器人分步教学（包含安装包）

news 2026/6/5 19:39:07

OpenClaw 绑定飞书详细教程｜长连接模式搭建飞书 AI 机器人

本文结合飞书开放平台配置规范与 OpenClaw v2.7.8 的渠道配置逻辑，梳理整套接入步骤，整体方案核心逻辑：在飞书开放平台搭建企业自建应用，获取 App ID、App Secret 两项凭证后填入 OpenClaw 即可完成对接，接入选用长连接接收事件，无需配置公网回调地址。

一、部署前置条件

本机已装好 OpenClaw v2.7.8，软件能够正常启动运行；
拥有可登录的飞书开放平台开发者账号；
具备可用的飞书企业 / 组织空间，企业账号发布应用需管理员审核。

软件资源：下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C压缩包大小45.8MB，内置全套运行依赖，解压即可部署使用。

二、飞书开放平台应用配置步骤

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

访问飞书开发者后台https://open.feishu.cn/app，点击开发者后台，选择创建企业自建应用，支持空白创建或者智能体模板创建两种方式。

步骤 2：完善应用基础信息

自定义机器人名称、应用描述，上传合规头像文件，头像格式支持 JPEG/PNG/SVG/BMP，文件体积控制在 2MB 以内，分辨率大于 240×240px，填写完毕点击创建。

步骤 3：为应用添加机器人能力

进入应用详情页，在左侧菜单栏打开【添加应用能力】，在能力列表找到机器人选项并完成添加。

步骤 4：进入事件与回调配置页面

侧边栏打开事件与回调板块，在事件配置栏目点击订阅方式后方编辑按钮。

步骤 5：选定长连接接收事件

订阅方式选择使用长连接接收事件，放弃服务器回调模式，该方式适配 OpenClaw 接入规则，保存当前配置。

步骤 6：添加消息接收事件

保存订阅规则后点击添加事件，检索关键词【接收】，勾选im.message.receive_v1（接收消息v2.0）并确认添加，该事件是机器人收发消息的必要配置。

步骤 7：开通事件配套权限

弹出权限推荐弹窗时一键确认开通，完成后核查事件绑定权限，所有权限状态必须显示已开通，缺失权限手动补充开启。

步骤 8：批量导入全量应用权限

打开权限管理页面，选择批量导入 / 导出权限，清空原有默认 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": [] } }

粘贴完毕点击下一步确认新增权限，权限的数据访问范围保持默认【与应用的可用范围一致】并确认。