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

OpenClaw 绑定飞书详细教程长连接模式搭建飞书 AI 机器人本文结合飞书开放平台配置规范与 OpenClaw v2.7.8 的渠道配置逻辑梳理整套接入步骤整体方案核心逻辑在飞书开放平台搭建企业自建应用获取 App ID、App Secret 两项凭证后填入 OpenClaw 即可完成对接接入选用长连接接收事件无需配置公网回调地址。一、部署前置条件本机已装好 OpenClaw v2.7.8软件能够正常启动运行拥有可登录的飞书开放平台开发者账号具备可用的飞书企业 / 组织空间企业账号发布应用需管理员审核。软件资源 下载地址https://xiake.yun/api/download/package/17?promoCodeIV4E9B04A80C压缩包大小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: [] } }粘贴完毕点击下一步确认新增权限权限的数据访问范围保持默认【与应用的可用范围一致】并确认。步骤 9创建并发布应用版本进入版本管理与发布页面新建版本自定义版本号如 1.0.0移动端、桌面端默认能力均选择机器人更新备注填写更新事件订阅更新权限保存版本信息后提交发布。个人用户一般免审核直接上线企业主体需要管理员审批。步骤 10提取应用密钥信息回到【凭证与基础信息】栏目复制 App ID 与 App Secret两项参数后续填入 OpenClaw 配置页。三、OpenClaw 软件端配置打开 OpenClaw v2.7.8 客户端点击右上角设置进入聊天配置分类找到 Feishu/Lark飞书配置项将复制的 App ID、App Secret 依次填入对应输入框打开渠道启用开关点击保存渠道配置即完成飞书机器人全流程绑定。四、接入自检清单飞书应用已成功添加机器人能力事件订阅选用长连接接收事件消息接收事件 im.message.receive_v1 添加完成配套权限全部开通全量权限导入完毕应用版本已发布上线密钥参数准确录入 OpenClaw 并保存配置五、常见问题汇总填入参数后机器人无应答 核查应用是否发布成功、事件类型与订阅方式无误参数无多余空格配置保存后可重启 Gateway 服务。无需填写外网回调地址原因 本方案采用飞书官方长连接协议依托 SDK 链路通讯省去公网域名与 webhook 配置。权限是否必须全量导入 仅实现收发消息可只开通事件必需权限需要联动飞书文档、多维表格、云盘等功能建议完整导入权限 JSON。安装包下载https://xiake.yun/api/download/package/17?promoCodeIV4E9B04A80C