OpenClaw 飞书机器人配置教程｜对接飞书，聊天下达 AI 指令
适配版本：OpenClaw v2.6.2
前置要求：已部署 OpenClaw Windows 端（Win10/Win11），未部署可先下载一键部署包安装核心效果：飞书聊天窗口直接发指令，OpenClaw 自动拆解任务、操控电脑，实现远程 AI 任务执行
OpenClaw Windows 一键部署包下载地址：
https://openclaw.ikidi.top/api/download/package/22?promoCode=IVE9EB160CC6
免配置、免命令行、解压即用，内置全部运行依赖，部署完成后再进行飞书配置
一、配置前必看
- 需飞书账号（个人 / 企业均可），企业账号需具备应用开发权限
- OpenClaw 保持正常运行（Gateway 在线），配置过程无需关闭
- 权限导入、事件订阅必须完整操作，缺一不可，否则机器人无响应
- 配置完成后重启 OpenClaw，确保凭证生效
二、第一步：登录飞书开放平台开发者后台
- 打开飞书开放平台：https://open.feishu.cn/
- 扫码 / 密码登录，进入开发者后台
三、第二步：创建企业自建应用
- 后台首页点击「创建应用」
- 应用类型选择「企业自建应用」
- 进入应用创建页面
四、第三步：填写应用基础信息
- 应用名称：自定义（如：OpenClaw 机器人）
- 应用描述：简要说明（≤120 字）
- 应用图标：JPEG/PNG/SVG/BMP，2MB 内，≥240*240px填写完成点击「创建」
五、第四步：添加「机器人」应用能力
- 应用配置页点击左侧「添加应用能力」
- 选择「机器人」，点击「添加」
- 左侧出现机器人配置项，即添加成功
六、第五步：批量导入核心权限（关键）
- 进入「权限管理」→「批量导入 / 导出权限」
- 选择「应用身份权限」，粘贴下方 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.0（im.message.receive_v1）」并添加
八、第七步：发布应用
- 进入「版本管理与发布」→「创建版本」
- 填写版本号、更新说明，移动端 / 桌面端默认能力选择「机器人」
- 点击「保存」→「确认发布」（个人账号免审核，企业账号需完成应用审核）
九、第八步：获取凭证并配置到 OpenClaw
- 进入「凭证与基础信息」，复制 App ID、App Secret
- 打开 OpenClaw → 右上角「设置」→「聊天渠道」→ 选择 Feishu（飞书）
- 粘贴凭证，点击「保存渠道配置」，OpenClaw 自动重启
十、第九步：飞书端使用机器人
- 飞书搜索应用名称，进入聊天窗口
- 发送测试指令，正常响应即配置成功
十一、常见问题排查
- 应用未发布：返回飞书开放平台完成发布与审核
- 权限未开通：重新导入 JSON 并申请权限
- 凭证错误：核对 App ID、App Secret，去除空格
- 未重启：手动重启 OpenClaw Gateway
- 长连接失效：重新保存事件订阅配置
- OpenClaw 离线：重新运行启动程序
十二、常用指令示例
- 办公：帮我打开 Excel，制作本周工作汇报表格，保存到 D 盘
- 文件：整理 D 盘下载文件夹，按文件类型分类
- 浏览器：打开浏览器，搜索 2026 年 AI 智能体发展趋势并整理成文档
- 消息：帮我给飞书备注 “同事 A” 发消息：工作汇报已发至你邮箱
再次附上下载地址：
https://openclaw.ikidi.top/api/download/package/22?promoCode=IVE9EB160CC6
