飞书聊天下发电脑指令 OpenClaw 机器人部署指南(含安装包)
2026/7/9 17:54:56 网站建设 项目流程

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 对接钉钉、微信等其他协作渠道的配置文档,感兴趣可以收藏本文方便后续查阅。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询