)
OpenClaw 飞书机器人配置教程对接飞书实现远程下发 AI 指令前言本文讲解如何将OpenClaw 2.7.9小龙虾与飞书完成对接搭建专属机器人。完成配置后你可以直接在飞书聊天窗口发送自然语言指令由 OpenClaw 自动拆解任务、操控电脑执行操作轻松实现远程下达任务的需求。前置要求设备已部署 OpenClaw 2.7.9 Windows 客户端Windows 10/11 均可尚未部署的用户可先获取部署包完成安装。部署包相关信息安装包大小为 45.8MB解压即可使用内置完整运行依赖无需额外配置运行环境部署完成后再按照本文步骤配置飞书对接功能即可。根据设备系统选择对应安装包安卓版本https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C一、配置前注意事项准备飞书账号个人账号、企业账号均可使用企业账号需要提前开通应用开发权限。保证 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.0im.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” 发送消息内容为工作汇报已发送至邮箱根据设备系统选择对应安装包安卓版本https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C