OpenClaw 飞书机器人完整配置实操教程|长连接对接方案,聊天下发 AI 控制指令
适配版本:OpenClaw v2.7.9(小龙虾)
运行前置条件
本地部署 OpenClaw Windows 客户端,Win10、Win11 系统均可稳定运行;未完成部署的用户可先下载一键部署包完成环境搭建。
方案落地效果
整套配置流程完成后,可直接在飞书会话窗口向机器人发送自然语言指令,OpenClaw 会自动解析任务逻辑、远程操控本地电脑执行各类操作,依托飞书聊天渠道完成远程 AI 任务下发。
OpenClaw 一键部署包下载地址
Windows 系统部署包:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
Mac 系统部署包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
当前部署包对应 OpenClaw v2.7.9 版本,安装包整体大小 45.8MB。压缩包内置全套运行依赖组件,无需手动配置环境、输入命令行,解压后即可直接启动,本文全部配置操作均适配该安装包。
一、配置前期注意事项
- 准备可用飞书账号,个人账号、企业账号均支持对接;企业账号操作前需确认自身具备飞书应用开发权限。
- 全程保持 OpenClaw 程序正常运行,网关服务处于在线状态,配置阶段无需关闭程序。
- 飞书开放平台操作需完整走完权限导入、事件订阅全流程,缺少任意步骤都会造成机器人无法响应消息。
- 全部配置完成后需要重启 OpenClaw 程序,才能让飞书应用凭证正式生效。
二、步骤 1:访问飞书开放平台并登录开发者后台
打开飞书开放平台官方站点:https://open.feishu.cn 使用飞书账号扫码或密码登录,进入开发者后台;个人账号第一次登录无需额外资质认证,可直接开展应用创建操作。
三、步骤 2:创建企业自建应用
在开发者后台首页点击创建应用按钮 应用类型选择企业自建应用,仅当前账号所属主体可使用,无需平台上架审核,配置完成后即可快速启用。 跳转至应用创建页面,准备填写各项基础信息。
四、步骤 3:完善应用基础信息
按页面提示填写以下内容,全部填写完毕后点击创建按钮:
- 应用名称:自定义填写,例如 OpenClaw 智能机器人、小龙虾 AI 助手,建议设置辨识度较高的名称便于搜索调用。
- 应用描述:简要标注功能用途,例如对接 OpenClaw 智能体,支持飞书聊天下发电脑控制指令,文字长度控制在 120 字以内。
- 应用图标:自主上传图片素材,支持 JPEG、PNG、SVG、BMP 格式,单文件体积不超过 2MB,图片分辨率不低于 240*240px,可使用 OpenClaw 配套龙虾标识方便识别。
补充说明:应用基础信息创建完成后支持随时修改,创建成功后会自动跳转至应用配置主页面。
五、步骤 4:为应用新增机器人能力模块
进入应用配置主页,在左侧菜单栏找到添加应用能力入口并点击 在功能列表中选中机器人,点击右侧添加按钮完成开通 添加成功后左侧导航栏会出现机器人专属配置分类,代表该功能已启用。
六、步骤 5:批量导入机器人所需接口权限(核心关键环节)
OpenClaw 需要调用飞书消息、多维表格、在线文档等各类接口,需要提前开通对应权限,批量导入可以一次性完成授权,规避手动添加出现权限遗漏问题。
- 左侧菜单栏切换至权限管理,找到批量导入 / 导出权限功能并打开。
- 选择应用身份权限分类,将下方完整 JSON 内容粘贴至输入框,点击格式化 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": [] } }七、步骤 6:配置事件订阅,实现飞书消息实时接收
- 左侧菜单栏切换至事件与回调板块,打开事件配置页面。
- 订阅方式修改为使用长连接接收事件,该方案无需配置公网域名,个人开发场景优先选择,修改完成后点击保存。
- 点击添加事件,搜索框输入接收消息,选中接收消息 v2.0(im.message.receive_v1)。
- 勾选目标事件后点击添加,完成消息订阅配置;飞书内发送的对话消息会通过长连接实时推送至 OpenClaw 网关。
八、步骤 7:发布应用版本,让全部配置生效
- 左侧菜单栏进入版本管理与发布页面,点击创建版本。
- 填写版本相关信息:
- 应用版本号:自定义填写,例如 1.0.0,遵循常规版本命名规范即可。
- 更新说明:简单标注用途,例如 OpenClaw 飞书机器人初始化配置。
- 移动端、桌面端默认能力统一选择机器人。
- 滑动至页面底部,点击保存,再确认发布。
补充说明:未完成企业认证的个人账号发布后无需审核,配置即时生效;企业认证账号需要前往飞书管理后台完成应用审核才可正常使用。
九、步骤 8:提取应用凭证,录入 OpenClaw 完成渠道对接
- 左侧菜单栏打开凭证与基础信息页面,找到应用凭证区域。
- 完整复制 App ID 与 App Secret 两组密钥,复制过程避免带入多余空格、缺失字符,建议手动复制降低出错概率。
- 打开保持运行的 OpenClaw 主界面,点击右上角设置按钮,左侧导航栏选择聊天渠道。
- 在渠道列表找到 Feishu(飞书)分类,进入专属配置页面。
- 将复制的 App ID、App Secret 分别填入对应输入框,点击页面底部保存渠道配置。
- 保存后 OpenClaw 会自动重启网关,等待网关状态刷新为在线,代表渠道对接完成。
十、步骤 9:飞书客户端调用机器人实操
打开飞书 PC 端或手机端,顶部搜索框输入创建时填写的应用名称,点击进入机器人对话窗口。 发送测试指令验证连通性,例如 “你好”“帮我整理桌面全部文件”。 机器人正常回复、执行对应电脑操作即代表整套流程配置成功;若无响应,参考下方故障排查章节逐一核对。
十一、机器人无响应、指令执行失败故障排查清单
- 飞书应用未完成发布:返回飞书开放平台版本管理页面,确认版本已发布且审核流程全部通过;个人账号检查是否执行确认发布操作。
- 接口权限未全部开通:进入权限管理页面,核对批量导入的权限全部显示已开通,存在未开通项重新导入并提交申请。
- App ID、App Secret 复制存在误差:打开 OpenClaw 飞书配置页,对比密钥与飞书后台原始内容,排查多余空格、字符缺失、大小写错误。
- OpenClaw 未重启加载新配置:渠道参数保存后程序会自动重启网关,若未自动重启,手动点击右上角重启网关按钮。
- 长连接订阅配置失效:返回事件与回调页面,确认订阅方式为长连接,重新保存设置后再次测试消息发送。
- OpenClaw 程序部署异常:查看网关运行状态,若网关显示离线,重新启动 OpenClaw 一键启动程序恢复服务。
十二、OpenClaw 飞书机器人常用指令参考
配置连通后,直接在飞书对话窗口发送自然语言指令,AI 会自动操控本地电脑执行操作,常用场景示例如下:
- 办公文档类:帮我新建 Excel 表格,生成本周工作统计报表并保存至 D 盘。
- 文件管理类:整理 D 盘下载文件夹,按照图片、文档、安装包分类新建文件夹归档。
- 浏览器检索类:打开浏览器检索 AI 智能体落地实践方案,整理内容生成本地文档。
- 消息通知类:给飞书备注同事 A 发送消息,内容为工作报表已发送至对方邮箱。
补充部署提示
Windows 系统部署包:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
Mac 系统部署包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
未部署 OpenClaw 的使用者先下载安装包完成部署,再按照本文分步配置飞书渠道,整套操作耗时较短即可完成飞书与 OpenClaw 联动。 后续会持续更新 OpenClaw 对接钉钉、微信等其他协作渠道的配置文档,感兴趣可以收藏本文方便后续查阅。