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。压缩包内置全套运行依赖组件，无需手动配置环境、输入命令行，解压后即可直接启动，本文全部配置操作均适配该安装包。

一、配置前期注意事项

1. 准备可用飞书账号，个人账号、企业账号均支持对接；企业账号操作前需确认自身具备飞书应用开发权限。
2. 全程保持 OpenClaw 程序正常运行，网关服务处于在线状态，配置阶段无需关闭程序。
3. 飞书开放平台操作需完整走完权限导入、事件订阅全流程，缺少任意步骤都会造成机器人无法响应消息。
4. 全部配置完成后需要重启 OpenClaw 程序，才能让飞书应用凭证正式生效。

二、步骤 1：访问飞书开放平台并登录开发者后台

打开飞书开放平台官方站点：https://open.feishu.cn 使用飞书账号扫码或密码登录，进入开发者后台；个人账号第一次登录无需额外资质认证，可直接开展应用创建操作。

三、步骤 2：创建企业自建应用

在开发者后台首页点击创建应用按钮 应用类型选择企业自建应用，仅当前账号所属主体可使用，无需平台上架审核，配置完成后即可快速启用。 跳转至应用创建页面，准备填写各项基础信息。

四、步骤 3：完善应用基础信息

按页面提示填写以下内容，全部填写完毕后点击创建按钮：

1. 应用名称：自定义填写，例如 OpenClaw 智能机器人、小龙虾 AI 助手，建议设置辨识度较高的名称便于搜索调用。
2. 应用描述：简要标注功能用途，例如对接 OpenClaw 智能体，支持飞书聊天下发电脑控制指令，文字长度控制在 120 字以内。
3. 应用图标：自主上传图片素材，支持 JPEG、PNG、SVG、BMP 格式，单文件体积不超过 2MB，图片分辨率不低于 240*240px，可使用 OpenClaw 配套龙虾标识方便识别。

补充说明：应用基础信息创建完成后支持随时修改，创建成功后会自动跳转至应用配置主页面。

五、步骤 4：为应用新增机器人能力模块

进入应用配置主页，在左侧菜单栏找到添加应用能力入口并点击 在功能列表中选中机器人，点击右侧添加按钮完成开通 添加成功后左侧导航栏会出现机器人专属配置分类，代表该功能已启用。

六、步骤 5：批量导入机器人所需接口权限（核心关键环节）

OpenClaw 需要调用飞书消息、多维表格、在线文档等各类接口，需要提前开通对应权限，批量导入可以一次性完成授权，规避手动添加出现权限遗漏问题。

1. 左侧菜单栏切换至权限管理，找到批量导入 / 导出权限功能并打开。
2. 选择应用身份权限分类，将下方完整 JSON 内容粘贴至输入框，点击格式化 JSON 消除格式报错。
3. 点击下一步确认新增权限，提交申请开通；个人账号提交后即时生效，企业账号需要管理员完成审核流程。

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：配置事件订阅，实现飞书消息实时接收

1. 左侧菜单栏切换至事件与回调板块，打开事件配置页面。
2. 订阅方式修改为使用长连接接收事件，该方案无需配置公网域名，个人开发场景优先选择，修改完成后点击保存。
3. 点击添加事件，搜索框输入接收消息，选中接收消息 v2.0（im.message.receive_v1）。
4. 勾选目标事件后点击添加，完成消息订阅配置；飞书内发送的对话消息会通过长连接实时推送至 OpenClaw 网关。

八、步骤 7：发布应用版本，让全部配置生效

1. 左侧菜单栏进入版本管理与发布页面，点击创建版本。
2. 填写版本相关信息：
   • 应用版本号：自定义填写，例如 1.0.0，遵循常规版本命名规范即可。
   • 更新说明：简单标注用途，例如 OpenClaw 飞书机器人初始化配置。
   • 移动端、桌面端默认能力统一选择机器人。
3. 滑动至页面底部，点击保存，再确认发布。

补充说明：未完成企业认证的个人账号发布后无需审核，配置即时生效；企业认证账号需要前往飞书管理后台完成应用审核才可正常使用。

九、步骤 8：提取应用凭证，录入 OpenClaw 完成渠道对接

1. 左侧菜单栏打开凭证与基础信息页面，找到应用凭证区域。
2. 完整复制 App ID 与 App Secret 两组密钥，复制过程避免带入多余空格、缺失字符，建议手动复制降低出错概率。
3. 打开保持运行的 OpenClaw 主界面，点击右上角设置按钮，左侧导航栏选择聊天渠道。
4. 在渠道列表找到 Feishu（飞书）分类，进入专属配置页面。
5. 将复制的 App ID、App Secret 分别填入对应输入框，点击页面底部保存渠道配置。
6. 保存后 OpenClaw 会自动重启网关，等待网关状态刷新为在线，代表渠道对接完成。

十、步骤 9：飞书客户端调用机器人实操

打开飞书 PC 端或手机端，顶部搜索框输入创建时填写的应用名称，点击进入机器人对话窗口。 发送测试指令验证连通性，例如 “你好”“帮我整理桌面全部文件”。 机器人正常回复、执行对应电脑操作即代表整套流程配置成功；若无响应，参考下方故障排查章节逐一核对。

十一、机器人无响应、指令执行失败故障排查清单

1. 飞书应用未完成发布：返回飞书开放平台版本管理页面，确认版本已发布且审核流程全部通过；个人账号检查是否执行确认发布操作。
2. 接口权限未全部开通：进入权限管理页面，核对批量导入的权限全部显示已开通，存在未开通项重新导入并提交申请。
3. App ID、App Secret 复制存在误差：打开 OpenClaw 飞书配置页，对比密钥与飞书后台原始内容，排查多余空格、字符缺失、大小写错误。
4. OpenClaw 未重启加载新配置：渠道参数保存后程序会自动重启网关，若未自动重启，手动点击右上角重启网关按钮。
5. 长连接订阅配置失效：返回事件与回调页面，确认订阅方式为长连接，重新保存设置后再次测试消息发送。
6. OpenClaw 程序部署异常：查看网关运行状态，若网关显示离线，重新启动 OpenClaw 一键启动程序恢复服务。

十二、OpenClaw 飞书机器人常用指令参考

配置连通后，直接在飞书对话窗口发送自然语言指令，AI 会自动操控本地电脑执行操作，常用场景示例如下：

1. 办公文档类：帮我新建 Excel 表格，生成本周工作统计报表并保存至 D 盘。
2. 文件管理类：整理 D 盘下载文件夹，按照图片、文档、安装包分类新建文件夹归档。
3. 浏览器检索类：打开浏览器检索 AI 智能体落地实践方案，整理内容生成本地文档。
4. 消息通知类：给飞书备注同事 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 对接钉钉、微信等其他协作渠道的配置文档，感兴趣可以收藏本文方便后续查阅。