OpenClaw 飞书机器人配置教程：聊天下达 AI 指令

七、第六步：配置事件订阅，实现飞书消息接收

1. 左侧菜单栏进入事件与回调，选择事件配置
2. 订阅方式修改为：使用长连接接收事件（推荐，无需配置公网域名，个人账号首选），点击保存
3. 点击添加事件，在搜索框输入接收消息，选择接收消息 v2.0（im.message.receive_v1）
4. 勾选事件后点击添加，完成消息订阅配置（飞书发送的消息将通过长连接推送给 OpenClaw）

八、第七步：发布应用，使所有配置生效

1. 左侧菜单栏进入版本管理与发布，点击创建版本
2. 填写版本信息：
   • 应用版本号：自定义（如：1.0.0，按常规版本号填写即可）
   • 更新说明：简要填写（如：OpenClaw 飞书机器人初始配置）
   • 移动端 / 桌面端默认能力：均选择机器人
3. 滑动至页面底部，点击保存，再点击确认发布
4. 注：个人未认证账号发布后免审核，立即生效；企业认证账号需进入飞书管理后台完成应用审核后生效

九、第八步：获取应用凭证，配置至 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 智能体发展趋势，整理成文档」
• 消息类：「帮我给飞书备注'同事 A'发送消息，内容是'工作汇报已发至你邮箱'」