前言

OpenClaw（小龙虾 AI）支持与飞书机器人深度集成，配置完成后，可直接在飞书聊天窗口向机器人发送自然语言指令，由 OpenClaw 自动拆解任务、远程操控电脑执行操作，实现 “飞书聊天下达 AI 指令，远程控机一步到位” 的高效办公体验。本文提供 Windows 平台完整配置教程，从飞书开放平台创建应用到 OpenClaw 本地配置，全程步骤清晰、避坑点明确，新手也能快速完成配置。

一、配置前准备（必做，保障配置顺利）

1. 基础环境要求

• 本地环境：已完成 OpenClaw Windows 部署，且 Gateway 处于在线状态（主界面右上角显示 “Gateway 在线”）
• 飞书账号：个人 / 企业账号均可，企业账号需具备应用创建与发布权限
• 系统工具：Windows 10/11 64 位，已安装 PowerShell（Win+R 输入 powershell 可快速打开）

2. 关键注意事项

• 飞书应用创建后，App ID 与 App Secret 需妥善保存，不可泄露，配置时需准确填写
• 配置全程 OpenClaw 需保持运行，不可关闭主程序，避免通信中断
• 飞书应用权限需完整配置，缺少核心权限会导致机器人无法接收 / 发送消息
• 事件订阅需选择长连接模式，保障飞书与 OpenClaw 持续稳定通信

二、飞书开放平台应用创建与配置（核心步骤）

步骤 1：进入飞书开放平台创建应用

1. 打开浏览器，访问飞书开放平台：open.feishu.cn，登录飞书账号
2. 点击右上角「开发者后台」→「创建应用」→ 选择「企业自建应用」
3. 填写应用信息：
   • 应用名称：自定义（如 “OpenClaw AI 助手”）
   • 应用描述：填写 “OpenClaw 飞书机器人，远程 AI 控机助手”
   • 应用图标：上传 OpenClaw 龙虾图标（便于飞书内识别）
4. 点击「创建」，完成应用创建，进入应用详情页

步骤 2：获取应用凭证（关键信息）

1. 在应用详情页，找到「凭证与基础信息」模块
2. 复制「App ID」（格式为 cli_开头）与「App Secret」，保存至本地文档（后续配置需多次使用）
   • 注意：App Secret 需点击「显示」后复制，仅首次显示或重置后可见，务必及时记录

步骤 3：开启机器人能力

1. 点击左侧「能力管理」→「添加能力」
2. 在能力列表中搜索「机器人」，选择「机器人」能力并点击「开启」
3. 开启后保持默认设置，无需额外配置基础参数

步骤 4：配置应用核心权限（避坑重点）

1. 点击左侧「权限管理」→「添加权限」，搜索并勾选以下核心权限（缺一不可）：
   • 即时通讯权限：im:message:send（发送消息）、im:message:read（读取消息）、im:message.p2p_msg:readonly（单聊消息读取）、im:message:send_as_bot（机器人发消息）
   • 文件权限：aily:file:read、aily:file:write（文件读写，支持远程文件操作）
2. 勾选完成后，点击「批量保存」，完成权限配置

步骤 5：配置事件订阅（保障通信）

1. 点击左侧「事件配置」→「事件与回调」
2. 接收模式选择「长连接」（关键，保障持续通信），点击「保存」
3. 点击「添加事件」，搜索并勾选「im.message.receive_v1」（接收消息事件，必需）
4. 保存事件配置，完成飞书侧所有设置

步骤 6：发布飞书应用

1. 点击左侧「版本管理与发布」→「创建版本」
2. 填写版本说明（如 “V1.0，OpenClaw 飞书机器人初始版本”），点击「确定」
3. 点击「发布」，提交审核（个人账号通常秒过，企业账号需管理员审核）
4. 审核通过后，飞书客户端会收到应用发布通知

三、OpenClaw 本地飞书机器人配置（一键对接）

步骤 1：安装飞书插件（推荐命令行）

1. 打开 PowerShell（Win+R 输入 powershell，以管理员身份运行）
2. 复制以下命令，粘贴执行，安装 OpenClaw 飞书插件：
3. 等待安装完成，出现 “插件安装成功” 提示即可

步骤 2：配置飞书渠道信息

1. 打开 OpenClaw 主界面，点击左侧「集成管理」→「渠道配置」→「添加渠道」
2. 渠道类型选择「飞书（Feishu）」，进入配置页面
3. 填写飞书应用凭证：
   • App ID：粘贴步骤 2 中复制的飞书 App ID
   • App Secret：粘贴步骤 2 中复制的飞书 App Secret
4. 其他配置：
   • 连接模式：选择「websocket」（长连接，稳定优先）
   • 群聊策略：选择「open」（允许所有群聊使用）
   • 单聊策略：选择「pairing」（仅配对用户可使用）
5. 点击「保存配置」，完成 OpenClaw 侧设置

步骤 3：重启 Gateway 服务（生效关键）

1. 回到 OpenClaw 主界面，点击右上角「重启 Gateway」
2. 等待 Gateway 重启完成，主界面右上角重新显示「Gateway 在线」，配置正式生效

四、飞书机器人使用与远程控机测试

步骤 1：添加机器人到飞书

1. 打开飞书客户端，搜索步骤 1 中创建的应用名称（如 “OpenClaw AI 助手”）
2. 点击「添加」，将机器人添加为联系人，或邀请至指定飞书群组

步骤 2：远程控机测试（验证成功）

1. 在飞书聊天窗口，向机器人发送测试指令（如 “帮我查询电脑状态”“打开记事本”）
2. 若机器人正常回复并执行操作（如返回电脑内存 / CPU 占用、自动打开记事本），则配置成功
3. 常用远程控机指令示例：
   • 文件整理：“帮我整理下载文件夹，按文件类型分类”
   • 程序控制：“关闭当前浏览器”“打开微信”
   • 系统查询：“查询电脑剩余存储空间”“查看网络连接状态”

五、常见问题排查（实测有效）

问题 1：机器人无法接收消息

• 原因：飞书应用权限缺失、事件订阅未配置、Gateway 未重启
• 解决：重新检查并添加所有核心权限；确认事件订阅选择长连接并添加im.message.receive_v1；重启 OpenClaw Gateway 服务

问题 2：机器人发送消息失败

• 原因：缺少im:message:send/im:message:send_as_bot权限、App Secret 填写错误
• 解决：在飞书开放平台补全发送消息权限；核对并重新填写 App ID 与 App Secret，重启 Gateway

问题 3：远程控机指令无响应

• 原因：OpenClaw 飞书插件未安装、连接模式错误、网络异常
• 解决：重新执行插件安装命令；确认渠道配置连接模式为 websocket；检查本地网络，确保飞书与 OpenClaw 网络互通

问题 4：飞书应用发布失败

• 原因：企业账号无发布权限、权限配置不完整
• 解决：联系企业管理员获取发布权限；重新核对并补全所有核心权限，再次提交发布

六、总结

本文完整覆盖 OpenClaw 飞书机器人从飞书开放平台创建、权限配置到 OpenClaw 本地对接、远程控机测试的全流程，核心步骤清晰、避坑点明确，配置完成后即可实现 “飞书聊天即指令，远程 AI 控机一步到位” 的高效办公体验。严格遵循凭证保存、权限配置、长连接设置与 Gateway 重启等关键操作，即可一次成功配置，随时随地通过飞书操控本地电脑，释放 AI 办公生产力。

还未部署 OpenClaw 的用户，可通过下方官方链接获取 Windows 一键部署包，先完成本地部署再进行飞书配置：👉 官方下载链接：OpenClaw Windows 一键部署包（纯净版）

已完成部署的用户，直接按照本文步骤配置飞书机器人，开启远程 AI 控机之旅：👉 官方下载链接（再次强调）：OpenClaw Windows 一键部署包（纯净版）