OpenClaw 2.7.9 对接飞书教程，搭建飞书机器人实现远程操控电脑（含安装包）-深圳市維司達科技有限公司

OpenClaw 飞书机器人配置教程｜对接飞书实现远程下发 AI 指令

前言

本文讲解如何将OpenClaw 2.7.9（小龙虾）与飞书完成对接，搭建专属机器人。完成配置后，你可以直接在飞书聊天窗口发送自然语言指令，由 OpenClaw 自动拆解任务、操控电脑执行操作，轻松实现远程下达任务的需求。

前置要求：设备已部署 OpenClaw 2.7.9 Windows 客户端（Windows 10/11 均可），尚未部署的用户可先获取部署包完成安装。

部署包相关信息：安装包大小为 45.8MB，解压即可使用，内置完整运行依赖，无需额外配置运行环境，部署完成后再按照本文步骤配置飞书对接功能即可。

根据设备系统选择对应安装包：

安卓版本：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

苹果系统版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

一、配置前注意事项

准备飞书账号，个人账号、企业账号均可使用，企业账号需要提前开通应用开发权限。
保证 OpenClaw 2.7.9 正常运行，页面显示 Gateway 在线，配置全程不要关闭程序。
严格按照步骤操作飞书开放平台，权限导入、事件订阅为核心环节，缺失会导致机器人无法响应消息。
全部配置操作完成后，需要重启 OpenClaw，确保应用凭证正常生效。

二、第一步：登录飞书开放平台开发者后台

打开飞书开放平台官网：https://open.feishu.cn 通过扫码或者账号密码的方式登录账号，进入开发者后台。个人账号登录后无需额外认证，可直接开展后续操作。

三、第二步：创建企业自建应用

在开发者后台首页，点击创建应用按钮。
应用类型选择企业自建应用，该类型仅内部人员可使用，无需上架审核，配置后可快速生效。
进入应用创建页面，开始填写基础资料。

四、第三步：填写应用基础信息

按照页面要求完善以下内容，填写完毕后点击创建：

应用名称：可自定义，例如 OpenClaw 机器人、小龙虾 AI 等，建议设置容易识别的名称。
应用描述：简要介绍应用用途，例如用于对接 OpenClaw AI 智能体，在飞书内下发操作指令，内容字数控制在 120 字以内。
应用图标：支持 JPEG/PNG/SVG/BMP 格式，文件大小不超过 2MB，分辨率不低于 240*240px，可使用 OpenClaw 龙虾标识作为图标。

以上信息创建后支持二次修改，提交后自动进入应用配置主界面。

五、第四步：添加机器人应用能力

在应用配置页面左侧菜单栏，找到添加应用能力选项并点击。
在能力列表中选中机器人，点击右侧添加按钮。
添加成功后，左侧菜单栏会出现机器人相关配置栏目，代表该能力启用完成。

六、第五步：批量导入机器人权限（核心步骤）

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": [] } }

七、第六步：配置事件订阅，接收飞书消息

左侧菜单栏进入事件与回调，打开事件配置页面。
订阅方式选择使用长连接接收事件，该方式无需配置公网域名，个人用户优先选择，选择后点击保存。
点击添加事件，在搜索框检索「接收消息」，选中接收消息 v2.0（im.message.receive_v1）。
勾选对应事件并完成添加，配置完成后，飞书内发送的消息就可以正常推送给 OpenClaw。

八、第七步：发布应用，生效全部配置

左侧菜单栏进入版本管理与发布，点击创建版本。
填写版本相关信息：应用版本号可自定义，例如 1.0.0；更新说明简单备注即可，例如 OpenClaw 飞书机器人初始配置。
将移动端、桌面端默认能力均设置为机器人。
滑动至页面底部，先点击保存，再选择确认发布。

个人未认证账号发布后自动生效，企业认证账号需要前往飞书管理后台完成应用审核。

九、第八步：获取应用凭证并配置到 OpenClaw 2.7.9

回到应用配置页，点击左侧凭证与基础信息，找到应用凭证板块。
完整复制 App ID 和 App Secret，注意不要附带多余空格、字符。
打开正在运行的 OpenClaw 2.7.9 主界面，点击右上角设置，选择聊天渠道。
在渠道列表找到 Feishu（飞书）并进入配置页面，将复制的 App ID、App Secret 分别粘贴到对应输入框。
点击保存渠道配置，OpenClaw 会自动重启，等待页面右上角 Gateway 重新显示在线，代表配置完成。

十、第九步：飞书端使用机器人

打开飞书电脑端或移动端，在顶部搜索框输入你创建的应用名称。
进入机器人聊天窗口，发送测试指令，例如 “你好”“帮我整理桌面文件”。
机器人正常回复并执行任务，说明全部配置成功。

十一、常见问题排查

1. 机器人无任何响应

检查飞书应用状态：进入飞书开放平台，确认应用版本已成功发布，企业账号需确认审核已通过。
核对权限：进入权限管理页面，确认所有导入权限均显示已开通，权限失效则重新批量导入申请。

2. 凭证配置后无法连接

检查凭证内容：确认粘贴到 OpenClaw 中的 App ID、App Secret 和飞书平台一致，检查是否存在字符缺失、多余空格。
重启服务：配置凭证后若未自动重启，手动点击 OpenClaw 右上角重启 Gateway。

3. 事件接收异常

回到飞书「事件与回调」页面，确认订阅方式为长连接、消息事件已正常添加，重新保存配置后再次测试。

4. OpenClaw 服务离线

检查 OpenClaw 运行状态，若 Gateway 离线，重新启动 OpenClaw 2.7.9 一键启动程序。

十二、常用指令参考

配置完成后，可直接在飞书聊天窗口下发指令，远程操控电脑完成各类操作：

办公类：帮我打开 Excel，制作一份本周工作汇报表格，保存到 D 盘
文件类：整理 D 盘下载文件夹，按照文件类型新建文件夹分类存放
浏览器类：打开浏览器，搜索 AI 智能体相关资讯，整理为文档保存
消息类：帮我给飞书备注 “同事 A” 发送消息，内容为工作汇报已发送至邮箱