)
OpenClaw 2.7.9 飞书机器人配置教程对接飞书实现聊天下发 AI 任务指令前言本文完整梳理从飞书开放平台创建机器人应用到本地 OpenClaw 客户端完成渠道配置的全流程。整套方案采用飞书长连接事件接收模式无需部署公网域名与 Webhook 服务仅录入 App ID、App Secret 两组凭证即可完成消息互通。 部署完成后用户能够在飞书私聊、群聊窗口发送自然语言指令OpenClaw 智能体自动解析任务并操控本地电脑执行对应操作打通线上办公聊天与本地自动化执行链路。前置环境准备本地已下载并正常运行 OpenClaw Windows 2.7.9 版本安装包大小 45.8MBWindows 客户端下载地址https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统客户端下载地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80COpenClaw 客户端顶部 Gateway 服务保持在线状态渠道配置操作期间不要关闭程序持有可用飞书账号个人、企业组织账号均可使用企业账号操作前确认自身拥有应用开发权限配套访问地址飞书开放平台 https://open.feishu.cn配置前核心说明飞书后台权限导入、事件订阅两项操作不可省略缺失任意一项都会导致机器人无法接收消息全套参数配置完成后需要等待 OpenClaw 自动重启 Gateway所有凭证与渠道设置才会正式生效个人飞书账号创建应用发布后无需额外审核企业组织账号提交发布后需要管理员完成审批流程。完整分步配置流程第一步登录飞书开放平台进入开发者后台打开飞书开放平台官网地址使用飞书账号扫码或密码完成登录跳转至开发者后台页面。个人账号登录无需额外认证可直接进入应用创建页面。第二步创建企业自建类型应用在开发者后台首页点击创建应用按钮应用类型选择企业自建应用该类型仅当前账号所属组织内部可调用上线流程简单、配置快速生效。选中后进入应用信息填写页面。第三步完善应用基础信息完成创建按需填写三项基础内容确认无误后点击创建按钮应用名称自定义设置例如 OpenClaw 智能助手、虾壳云 AI 协作工具建议名称辨识度更高应用描述填写功能说明控制字数在 120 字以内示例依托 OpenClaw 智能体在飞书聊天窗口下发本地电脑操作指令应用图标支持上传自定义图片格式兼容 JPEG/PNG/SVG/BMP文件体积不超过 2MB分辨率最低 240*240px也可沿用默认图标素材。 补充说明应用名称、描述、图标后续均可进入应用后台修改无需重新创建。第四步为应用新增机器人运行能力进入应用管理主页面左侧菜单栏找到「添加应用能力」选项并点击在能力列表检索「机器人」点击对应添加按钮。添加成功后左侧导航栏会展示机器人相关配置分类代表能力开通完成。第五步批量导入全套接口权限核心关键步骤OpenClaw 需要调用飞书消息、文档、多维表格、云盘、通讯录等多类接口手动逐个开通权限容易出现遗漏推荐使用批量导入功能一次性完成权限申请左侧菜单栏切换至权限管理页面点击批量导入 / 导出权限功能选择应用身份为租户权限清空输入框原有内容完整粘贴下方 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: [] } }第六步配置长连接事件订阅实现消息推送左侧导航栏进入事件与回调配置页面找到订阅方式设置项将订阅模式修改为使用长连接接收事件保存当前配置该方案无需公网服务器适配本地客户端运行场景点击添加事件按钮搜索关键词「接收消息」选中事件im.message.receive_v1完成添加该事件是飞书向 OpenClaw 推送聊天消息的核心依赖缺少后机器人无法获取用户发送的指令内容。第七步创建并发布应用版本使全部配置生效飞书后台所有权限、事件设置仅在版本发布后才会正式启用操作步骤如下左侧打开版本管理与发布页面点击创建版本填写版本相关信息自定义版本号如 1.0.0更新说明填写配置用途移动端、桌面端默认能力统一选择机器人滑动页面至底部点击保存版本确认信息无误后点击确认发布 补充说明个人账号发布后立即生效企业账号提交后等待组织管理员完成审核。第八步复制应用凭证录入 OpenClaw 渠道配置左侧切换至凭证与基础信息页面找到应用凭证板块完整复制 App ID 与 App Secret 两组内容注意 App Secret 属于私密密钥复制完成后妥善保存不要对外分享、截图打开本地 OpenClaw 2.7.9 客户端点击右上角设置切换至聊天渠道分类在渠道列表找到 Feishu飞书配置卡片将复制的两组凭证分别填入对应输入框确认渠道启用开关处于打开状态点击页面底部保存渠道配置客户端会自动重启 Gateway等待服务恢复在线即完成参数绑定。第九步飞书端调用机器人执行 AI 任务功能验证打开飞书 PC 端或移动端顶部搜索栏输入之前创建的应用名称进入机器人单聊窗口发送测试语句验证连通性例如 “你好”、“帮我整理桌面全部文件”若机器人正常回复并执行本地电脑操作代表整套对接流程部署成功无响应可查看下方故障排查章节逐项核对。机器人无响应、指令执行失败排查清单飞书应用未完成发布返回飞书版本管理页面确认版本状态为已上线企业账号核对管理员审核是否通过权限未全部开通进入权限管理页面检查批量导入的权限是否全部显示已开通未生效则重新导入申请凭证复制存在异常核对 OpenClaw 渠道内 App ID、App Secret检查前后是否附带空格、换行、缺失字符OpenClaw 网关未重启保存渠道配置后等待自动重启若未自动重启手动点击右上角 Gateway 重启按钮事件订阅模式错误回到事件与回调页面确认订阅方式为长连接重新保存配置后复测OpenClaw 客户端运行异常查看顶部 Gateway 状态若显示离线重新启动客户端程序。飞书机器人常用 AI 指令参考配置完成后可直接在飞书聊天窗口发送自然语言指令AI 智能体自动操控本地电脑完成对应任务办公类指令帮我打开 Excel新建一份本周工作汇报表格并保存至 D 盘文件夹文件管理类指令整理 D 盘下载目录按照图片、文档、安装包分类新建文件夹归档浏览器检索类指令启动浏览器检索 2026 年 AI 智能体行业发展内容整理成本地文档保存飞书消息类指令给飞书备注为同事 A 的联系人发送消息内容为工作汇报文件已发送至邮箱配套参考链接飞书开放平台官网https://open.feishu.cn