飞书机器人接入 OpenClaw 完整落地部署指南(含安装包)
OpenClaw 2.7.9 对接飞书机器人完整配置教程
本文讲解借助长连接模式打通 OpenClaw 与飞书的操作流程,配置完成后,可在飞书私聊、群组内发送指令,调用本地 AI 实现电脑自动化操作。整体流程分为飞书平台创建应用、权限配置、密钥填写三大环节。
OpenClaw 安装包:OpenClaw Windows 一键部署包 v2.7.9,压缩包大小 45.8MB。
前置准备
- 本地已完成 OpenClaw 2.7.9 部署,Gateway 服务处于在线状态
- 拥有可用飞书企业或组织空间,能够登录飞书开放开发者后台
- 企业环境需具备管理员权限,用于应用版本审核;个人空间可直接发布,无需审核
一、飞书开放平台创建自建应用
打开飞书开发者后台:https://open.feishu.cn/app,进入页面后选择创建企业自建应用。自定义应用名称、机器人简介与应用图标,确认信息后完成应用创建。
二、添加机器人基础能力
在应用主页左侧点击添加应用能力,在功能列表中选中机器人组件并完成添加,该组件是实现消息收发的基础条件。
三、事件配置:选用长连接接收事件
进入【事件与回调】- 事件配置页面,订阅方式选择使用长连接接收事件,该方式无需配置公网回调地址,设置完成后保存。
点击添加事件,搜索并勾选im.message.receive_v1(接收消息),按照弹窗指引开通事件配套权限,保证单聊、群内 @等相关权限全部启用。
四、批量导入全套权限 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: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": [] } }五、应用版本发布
进入版本管理与发布页面,新建版本并自定义版本号,例如 1.0.0。移动端、桌面端默认勾选机器人能力,填写版本备注后保存。 个人飞书空间可直接确认发布;企业主体则需要等待管理员审核通过后方可生效。
六、提取密钥填入 OpenClaw
返回应用基础信息页面,复制App ID、App Secret两组密钥。 打开 OpenClaw,点击右上角设置,进入聊天配置,找到 Feishu/Lark 选项。 粘贴已复制的两组密钥,开启渠道开关,保存所有配置项。
七、接入自检清单
- 飞书应用已成功添加机器人能力
- 事件订阅选择长连接模式,已添加 im.message.receive_v1 事件
- 事件权限、批量导入的全套权限均已正常开通
- 应用版本完成发布并生效
- AppID 与 App Secret 填写无误,OpenClaw 内聊天渠道配置已保存
八、常见问题排查
- 机器人收不到消息:检查应用是否正常发布、事件订阅是否为长连接,确认密钥无多余空格,修改配置后重启 Gateway 服务。
- 仅支持单聊、无法在群聊使用:补充群组相关权限,重新发布应用版本。
- 无需额外填写公网地址:本方案基于飞书长连接协议实现,省去 webhook 域名配置步骤。
安装包下载地址
安卓版本:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
