夜雨聆风OpenClaw 绑定飞书教程｜飞书机器人一键接入配置指南 ✨
【点击最上方官网链接下载最新安装包】
OpenClaw 连接飞书图文教程，结合飞书开放平台操作流程与 OpenClaw 配置方式整理，适用于先在飞书开放平台创建企业自建应用，再将 App ID 与 App Secret 填入 OpenClaw的完整接入流程。
核心说明：OpenClaw 飞书渠道仅需填写 App ID 与 App Secret 两项参数；飞书侧建议选择长连接接收事件，完成应用创建、机器人能力添加、事件订阅、权限开通、版本发布五大核心环节即可。
🔧 前置准备
已安装并正常启动 OpenClaw Windows 2.6.6 版本 已登录飞书开放平台，可进入开发者后台 拥有可用的飞书组织 / 企业空间 企业账号发布应用需完成管理员审核
🚀 步骤 1：打开飞书开放平台并创建企业自建应用
访问飞书开放平台：https://open.feishu.cn/app 点击右上角「开发者后台」 选择「创建企业自建应用」，支持空白创建或智能体模板创建
🚀 步骤 2：填写应用基础信息
设置应用名称、描述、机器人名称与描述 上传应用图标（JPEG/PNG/SVG/BMP，2MB 内，≥240×240px） 确认信息后点击「创建」
🚀 步骤 3：添加机器人应用能力
进入应用后台，点击左侧「添加应用能力」 在能力列表中找到「机器人」并点击「添加」
🚀 步骤 4：配置事件与回调
左侧菜单进入「事件与回调」 点击事件配置区域订阅方式右侧「编辑」
🚀 步骤 5：选择长连接接收事件
选择「使用长连接接收事件」（无需配置公网回调地址） 确认后点击「保存」
🚀 步骤 6：添加接收消息事件
在「已添加事件」区域点击「添加事件」 搜索并勾选 接收消息 v2.0（im.message.receive_v1） 点击「添加」完成事件订阅
🚀 步骤 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": []}}
点击「下一步，确认新增权限」
🚀 步骤 9：确认数据访问范围
出现数据范围配置时，选择「与应用的可用范围一致」 点击「确认」完成权限配置
🚀 步骤 10：创建并发布应用版本
点击顶部「创建版本」或左侧「版本管理与发布」 设置版本号（如 1.0.0），移动端与桌面端默认能力选择「机器人」 填写更新说明，下拉点击「保存」 保存后点击「确认发布」，个人用户免审上线，企业用户需管理员审核
🚀 步骤 11：复制飞书应用凭证
左侧进入「凭证与基础信息」 复制 App ID 与 App Secret
🚀 步骤 12：OpenClaw 配置飞书渠道
打开 OpenClaw 2.6.6，点击右上角「设置」→「聊天配置」 找到「Feishu/Lark（飞书）」配置项 粘贴复制的 App ID 与 App Secret 开启右侧开关，点击「保存渠道配置」
📋 接入完成自检清单
飞书应用已添加机器人能力 事件与回调使用长连接接收事件 已添加 im.message.receive_v1 接收消息事件 所有关联权限状态为已开通 已导入完整权限 JSON 并发布版本 App ID 与 App Secret 正确填入 OpenClaw 已保存渠道配置并重启 Gateway
❓ 常见问题解答
1. OpenClaw 配置后飞书机器人无响应
检查飞书应用是否发布成功 确认事件为 im.message.receive_v1 订阅方式为长连接接收事件 重启 OpenClaw Gateway 服务 核对 App ID/App Secret 无多余空格
2. 为何无需配置公网回调地址
本次接入采用飞书长连接模式，OpenClaw 仅需 App ID 与 App Secret，无需配置 webhook URL。
3. 权限是否必须全部导入
基础消息收发可仅开通必要权限；需使用文档、多维表格等能力，建议导入完整权限 JSON。
🔗 相关资源
OpenClaw 下载地址：https://xiake.yun/api/download/package/12?promoCode=IVBE1F235167飞书开放平台开发者后台：https://open.feishu.cn/app
