OpenClaw小龙虾AI接入飞书机器人完整教程｜长连接配置零公网小白图文实操
适用场景：OpenClaw本地AI智能体绑定飞书机器人、企业内部AI办公协作、飞书远程下发电脑自动化指令
核心接入逻辑：飞书开放平台创建企业自建机器人 → 开通机器人能力+事件订阅+批量权限导入 → 发布应用版本 → 获取App ID、App Secret → 填入OpenClaw飞书渠道即可完成联动
关键优势：采用飞书官方长连接接收事件模式，无需公网服务器、无需配置回调地址，本地即可稳定对接，新手零难度一次配置成功
文章标签：#OpenClaw #小龙虾AI #OpenClaw飞书接入 #飞书机器人配置 #本地AI智能体 #AI办公自动化 #飞书企业自建应用
一、前言
OpenClaw小龙虾AI智能体除了本地直接对话使用以外，还支持多办公聊天渠道联动，其中飞书企业机器人对接是企业办公、团队协作、远程下达自动化指令最常用的配置方式。
很多小伙伴对接飞书时容易卡在回调地址配置、权限开通、事件订阅、应用发布等环节，本次教程适配最新飞书开放平台后台界面，全程图文对照操作，采用长连接接收事件方案，不用搭建公网、不用额外部署服务器，只需要填写两个核心参数即可完成打通。
配置完成后，直接在飞书私聊或群聊给机器人发消息，就能远程调用OpenClaw本地AI能力，自动操控电脑、整理文件、处理表格、执行各类办公自动化任务。
一键部署包下方图片地址栏获取
二、前置准备（配置前必核对）
开始配置前，提前确认好以下基础条件，避免配置到一半报错失败：
- ✅ OpenClaw Windows客户端已正常安装部署，Gateway服务保持在线稳定运行；
- ✅ 拥有飞书账号，可正常登录飞书开放平台开发者后台；
- ✅ 已有可用飞书企业组织或个人企业空间，支持创建企业自建应用；
- ✅ 企业账号配置完成发布版本时，如需审核，提前联系企业管理员协助通过即可。
🔗 飞书开放平台开发者后台入口：https://open.feishu.cn/app
三、步骤1：进入飞书开放平台，创建企业自建应用
1、打开上方飞书开放平台官方地址，完成账号扫码或密码登录；
2、进入首页后，点击页面右上角开发者后台；
3、在应用创建页面，选择创建企业自建应用，进入应用配置流程。
四、步骤2：填写飞书机器人基础信息并创建应用
在创建应用弹窗中，按需自定义填写机器人基础资料：
- 应用名称：自定义填写，例如OpenClaw智能助手、小龙虾办公机器人；
- 应用描述：简单备注用途，用于企业内部AI自动化协作办公即可；
- 应用头像：使用默认头像或自行上传自定义图标均可。
信息确认无误后，点击创建，完成飞书机器人应用基础搭建。
五、步骤3：为应用添加机器人核心应用能力
应用创建完成后，默认不具备机器人对话能力，需要手动添加对应功能权限：
1、左侧菜单栏找到添加应用能力并点击进入；
2、在能力列表中找到机器人选项；
3、点击右侧添加，确认机器人能力开通，左侧菜单出现机器人配置项即为添加成功。
六、步骤4：进入事件与回调配置页面
机器人添加完成后，核心配置重点在事件接收方式，左侧导航栏点击事件与回调；
进入事件配置区域，找到订阅方式一栏，点击右侧编辑按钮，准备修改事件接收模式。
七、步骤5：选择长连接接收事件（无需公网关键设置）
这一步是对接OpenClaw的核心关键，一定不要选择开发者服务器回调模式：
直接选择使用长连接接收事件，全程无需填写公网IP、无需配置外网回调地址，适配OpenClaw本地运行对接需求；
选择完成后点击保存，事件基础接收模式配置生效。
八、步骤6：添加消息接收核心事件
订阅方式保存完毕后，在已添加事件区域，点击右侧添加事件，新增机器人收消息必备事件。
九、步骤7：添加im.message.receive_v1接收消息事件
1、在事件搜索框中搜索关键词「接收」；
2、勾选接收消息，对应事件名称为im.message.receive_v1；
3、点击添加完成事件配置。
该事件是飞书机器人接收用户消息、转发给OpenClaw的核心必备事件，缺少此事件机器人无法正常收发消息联动。
十、步骤8：一键确认开通事件关联推荐权限
添加接收消息事件后，平台会自动弹出推荐开通权限弹窗，直接点击确认开通权限即可，无需手动逐项勾选。
十一、步骤9：核验所有依赖权限均为已开通状态
回到事件列表页面，展开接收消息事件下方的权限说明，逐一检查每一项权限状态；
确保所有权限全部显示已开通，如有未开通项，点击权限名称补充开通，避免后续消息接收异常。
十二、步骤10：进入权限管理，准备批量导入权限
左侧菜单栏打开权限管理板块；
点击页面中的批量导入/导出权限，进入权限批量配置页面，一次性补齐OpenClaw所需全部接口权限。
十三、步骤11：粘贴完整权限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：确认批量新增权限配置
JSON代码粘贴无误后，点击下一步，确认新增权限，等待系统批量加载所有权限配置。
十五、步骤13：数据范围保持默认直接确认
部分权限会弹出数据范围配置提示，无需手动修改，保持默认与应用的可用范围一致，直接点击确认即可。
十六、步骤14：进入版本管理与发布页面
权限和事件全部配置完成后，必须发布应用版本所有配置才会生效；
页面顶部有创建版本按钮直接点击，没有则从左侧版本管理与发布进入配置。
十七、步骤15：填写版本号与更新说明
版本信息按需简单填写即可：
- 版本号：填写1.0.0或1.0.1即可；
- 移动端、桌面端默认能力：保持机器人不变；
- 更新说明：填写更新事件订阅及权限配置。
十八、步骤16：保存应用版本配置
页面下拉至底部，点击保存，当前版本配置信息保存完成。
十九、步骤17：确认发布飞书应用
保存完成后点击确认发布；
个人企业空间一般可直接免审发布，企业正式账号需管理员审核通过后生效。
二十、步骤18：复制App ID和App Secret关键凭证
左侧点击凭证与基础信息页面，复制两组核心参数妥善保存：
- App ID
- App Secret
OpenClaw飞书渠道对接仅需这两个参数即可。
二十一、步骤19：OpenClaw进入飞书渠道配置页
打开OpenClaw客户端，点击右上角设置，进入聊天配置；
找到Feishu/Lark飞书配置卡片，把刚才复制的App ID、App Secret对应粘贴填入输入框。
二十二、步骤20：开启渠道开关并保存配置
打开飞书渠道右侧启用开关，点击右上角保存渠道配置；
页面显示已配置状态，代表OpenClaw与飞书机器人接入全部完成，直接发消息即可测试联动回复。
二十三、接入完成自检清单（核对无误再测试）
- ✅ 飞书应用已成功添加机器人应用能力；
- ✅ 事件订阅选择长连接接收事件模式；
- ✅ 已添加im.message.receive_v1接收消息核心事件；
- ✅ 所有事件关联权限全部开通完成；
- ✅ 批量权限JSON已完整导入配置；
- ✅ 应用版本已保存并发布成功；
- ✅ App ID和App Secret已正确粘贴无多余空格；
- ✅ OpenClaw已保存飞书渠道配置并启用开关。
二十四、常见问题快速排查
Q1：参数填完机器人不回复消息？
检查飞书应用是否发布成功、事件订阅是否为长连接、事件是否添加正确、OpenClaw Gateway是否在线，必要时重启Gateway服务重试。
Q2：为什么不用填写公网回调地址？
本教程采用飞书长连接事件接收模式，适配OpenClaw本地运行架构，无需公网、无需服务器，仅需两个密钥即可对接。
Q3：权限必须全部导入吗？
仅基础聊天可只开必要权限，如需后续联动文档、表格、知识库、云空间等自动化功能，建议直接导入完整权限一步到位。
