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