OpenClaw 飞书机器人完整配置实操教程长连接对接方案聊天下发 AI 控制指令适配版本OpenClaw v2.7.9小龙虾运行前置条件本地部署 OpenClaw Windows 客户端Win10、Win11 系统均可稳定运行未完成部署的用户可先下载一键部署包完成环境搭建。方案落地效果整套配置流程完成后可直接在飞书会话窗口向机器人发送自然语言指令OpenClaw 会自动解析任务逻辑、远程操控本地电脑执行各类操作依托飞书聊天渠道完成远程 AI 任务下发。OpenClaw 一键部署包下载地址Windows 系统部署包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CMac 系统部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C当前部署包对应 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.0im.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?promoCodeIV4E9B04A80CMac 系统部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C未部署 OpenClaw 的使用者先下载安装包完成部署再按照本文分步配置飞书渠道整套操作耗时较短即可完成飞书与 OpenClaw 联动。 后续会持续更新 OpenClaw 对接钉钉、微信等其他协作渠道的配置文档感兴趣可以收藏本文方便后续查阅。