使用条件：需在 Windows 10/11 系统上完成 OpenClaw 客户端部署（提供一键安装包）
open claw安装包：https://openclaw.ikidi.top/api/download/package/22?promoCode=IVB807603D98
核心功能：配置成功后，用户可在飞书聊天窗口输入自然语言指令，OpenClaw 将自动解析任务并执行电脑操作，实现通过飞书远程操控 AI 任务
一、配置前必看
1.使用飞书账号登录（个人/企业账号均可），企业账号需具备应用开发权限
2.确保 OpenClaw 持续运行（Gateway 在线），配置过程中请勿关闭
3.严格按照飞书开放平台指引操作，必须完成权限导入和事件订阅，否则机器人将无法响应
4.配置完成后请重启 OpenClaw，以使凭证生效
二、第一步：进入飞书开放平台并登录开发者后台
1. 打开飞书开放平台官方地址：https://open.feishu.cn
2. 使用飞书账号扫码 / 密码登录，进入开发者后台（首次登录无需额外认证，个人账号可直接使用）
三、第二步：创建企业自建应用
1. 在开发者后台首页，点击创建应用按钮
2. 应用类型选择企业自建应用（仅本企业 / 个人可使用，无需上架审核，快速生效）
3. 进入应用创建页面，准备填写基础信息
四、第三步：填写应用基础信息
按要求填写以下信息，填写完成后点击创建：
· 应用名称：自定义（如：OpenClaw 机器人、小龙虾 AI、虾壳云），建议便于识别
· 应用描述：简要说明（如：OpenClaw AI 智能体，飞书聊天下达指令），字数≤120
· 应用图标：自定义上传（JPEG/PNG/SVG/BMP 格式，2MB 以内，分辨率≥240*240px），可使用 OpenClaw 龙虾 Logo，便于飞书内识别✅ 注：信息可后续修改，创建后进入应用配置主界面
五、第四步：为应用添加「机器人」能力
1. 进入应用配置页，左侧菜单栏找到添加应用能力选项并点击
2. 在能力列表中选择机器人，点击右侧添加按钮
3. 添加完成后，左侧菜单栏会出现「机器人」相关配置项，说明能力添加成功
六、第五步：批量导入机器人核心权限（关键步骤）
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": [] }}
七、第六步：配置事件订阅，实现飞书消息接收
1. 左侧菜单栏进入事件与回调，选择事件配置
2. 订阅方式修改为：使用长连接接收事件（推荐，无需配置公网域名，个人账号首选），点击保存
3. 点击添加事件，在搜索框输入接收消息，选择接收消息 v2.0（im.message.receive_v1）
4. 勾选事件后点击添加，完成消息订阅配置（飞书发送的消息将通过长连接推送给 OpenClaw）
八、第七步：发布应用，使所有配置生效
1. 左侧菜单栏进入版本管理与发布，点击创建版本
2. 填写版本信息：
o 应用版本号：自定义（如：1.0.0，按常规版本号填写即可）
o 更新说明：简要填写（如：OpenClaw 飞书机器人初始配置）
o 移动端 / 桌面端默认能力：均选择机器人
1. 滑动至页面底部，点击保存，再点击确认发布✅ 注：个人未认证账号发布后免审核，立即生效；企业认证账号需进入飞书管理后台完成应用审核后生效
九、第八步：获取应用凭证，配置至 OpenClaw
1. 左侧菜单栏进入凭证与基础信息，找到应用凭证板块
2. 复制App ID和App Secret（需完整复制，不含空格，建议手动复制避免粘贴错误）
3. 打开已运行的 OpenClaw 主界面，点击右上角设置，选择左侧聊天渠道
4. 在渠道列表中找到Feishu（飞书），点击进入配置页
5. 将复制的App ID和App Secret分别粘贴至对应输入框
6. 点击页面底部保存渠道配置，OpenClaw 将自动重启，等待 Gateway 重新在线即配置完成
十、第九步：飞书端使用 OpenClaw 机器人（最终步骤）
1. 打开飞书 PC / 手机端，在顶部搜索栏输入你创建的应用名称（如：OpenClaw 机器人）
2. 点击进入机器人聊天窗口，发送任意测试指令（如：“你好”、“帮我整理桌面文件”）
3. 若机器人正常回复 / 执行指令，说明配置成功；若无响应，按下方问题排查检查
十一、常见问题排查（机器人无响应 / 指令执行失败）
1. 飞书应用未发布：返回飞书开放平台，确认版本已发布且审核通过（个人账号检查是否点击 “确认发布”）
2. 权限未开通：进入权限管理，检查是否所有权限均显示 “已开通”，未开通则重新批量导入并申请
3. App ID/Secret 复制错误：检查 OpenClaw 飞书配置页的凭证是否与飞书开放平台一致，有无多字 / 少字 / 空格
4. OpenClaw 未重启：配置完成后需确保 OpenClaw 自动重启，若未重启，手动点击右上角重启Gateway
5. 长连接未生效：返回飞书事件与回调，确认订阅方式为 “长连接”，重新保存后再测试
6. OpenClaw 未正常部署：检查 Gateway 是否显示 “在线”，若离线，重新运行 OpenClaw 一键启动程序
十二、附：OpenClaw 飞书机器人常用指令示例
配置成功后，可在飞书聊天窗口直接发送以下指令，AI 自动操控电脑完成：
· 办公类：「帮我打开 Excel，制作一份本周工作汇报表格，保存到 D 盘」
· 文件类：「整理 D 盘下载文件夹，按文件类型分类创建文件夹」
· 浏览器类：「打开浏览器，搜索 2026 年 AI 智能体发展趋势，整理成文档」
再次附上open claw一键部署安装包：
https://openclaw.ikidi.top/api/download/package/22?promoCode=IVB807603D98
