前言

OpenClaw v2.4.1（小龙虾 AI）支持一键接入飞书，将本地 AI 能力延伸至飞书群聊与私聊，实现 AI 办公自动化。本文基于 Win10/Win11 系统，提供从飞书开放平台创建应用到 OpenClaw 配置、网关启动、机器人配对的全流程实操教程，新手可直接复刻，快速搭建飞书 AI 助手。

一、OpenClaw 飞书机器人核心优势

• 跨端协同：本地 AI 与飞书无缝打通，群聊 @机器人即可调用 AI 能力，无需切换工具。
• 零代码配置：可视化操作，无需开发基础，全程鼠标 + 终端简单指令即可完成。
• Win 全适配：完美兼容 Windows 10/11 64 位系统，部署稳定无兼容问题。
• 权限可控：支持私聊 / 群聊权限配置，可限制使用范围，保障企业信息安全。
• v2.4.1 专属优化：修复飞书长连接稳定性问题，提升消息响应速度，适配最新飞书开放平台接口。

二、配置前准备（Win10/Win11 通用）

1. 基础环境要求

• 操作系统：Windows 10（19041 及以上）/ Windows 11 64 位（32 位系统暂不支持）。
• 已完成 OpenClaw v2.4.1 本地部署，确保 Gateway 显示「在线」。
• 飞书企业账号（个人账号无法创建企业自建应用），具备飞书开放平台操作权限。
• 工具：终端（PowerShell/CMD）、文本编辑器（用于复制凭证）。

2. 关键注意事项

• 路径纯英文：OpenClaw 安装路径必须为纯英文，禁止包含中文、空格、特殊字符。
• 管理员权限：所有终端操作、网关启动均需以管理员身份运行，避免权限不足。
• 凭证妥善保存：飞书 App ID、App Secret、Verification Token 需复制保存，配置时直接粘贴。
• 长连接优先：飞书事件订阅必须选择「长连接（WebSocket）」模式，禁用 Webhook，避免连接不稳定。
• 发布必生效：飞书应用权限、事件配置修改后，必须发布新版本，否则配置不生效。

三、飞书开放平台配置（第一步：创建应用）

步骤 1：登录飞书开放平台

访问飞书开放平台官网（https://open.feishu.cn），使用企业飞书账号登录，进入「开发者后台」。

步骤 2：创建企业自建应用

1. 点击「创建应用」→ 选择「企业自建应用」。
2. 填写应用名称（如「OpenClaw AI 助手」）、描述，上传应用图标（推荐龙虾图标），点击「创建」。
3. 创建成功后，进入应用详情页，左侧菜单栏选择「凭证与基础信息」。
4. 复制App ID、App Secret、Verification Token，保存至文本文件，后续配置 OpenClaw 需使用。

步骤 3：添加机器人能力

1. 左侧菜单栏选择「应用能力」→ 点击「添加能力」。
2. 搜索并选择「机器人」→ 点击「确认添加」，完成机器人能力开通。

步骤 4：配置事件订阅（长连接模式）

1. 左侧菜单栏选择「事件与回调」→「事件订阅」。
2. 订阅方式：选择「使用长连接接收事件（WebSocket）」→ 点击「保存」。
3. 添加事件：点击「添加事件」→ 搜索「im.message.receive_v1」（接收消息）→ 勾选并确认添加。
4. 无需配置请求地址，长连接模式由 OpenClaw 主动连接飞书服务器。

步骤 5：开通必要权限（必须配置）

1. 左侧菜单栏选择「权限管理」→「开通权限」。
2. 搜索并勾选以下权限（缺一不可）：
   • im:message.p2p_msg:readonly（读取私聊消息）
   • im:message.group_at_msg:readonly（读取群 @消息）
   • contact:user.base:readonly（获取用户基础信息）
3. 点击「申请权限」→ 提交（企业自建应用可直接通过）。

步骤 6：发布飞书应用

1. 左侧菜单栏选择「版本管理与发布」→「创建新版本」。
2. 填写版本号（如 1.0.0）、更新说明，点击「保存」→「发布」。
3. 发布成功后，飞书应用配置完成，等待 OpenClaw 对接。

四、OpenClaw 飞书通道配置（第二步：本地对接）

步骤 1：下载 OpenClaw v2.4.1 官方部署包

确保使用最新 v2.4.1 版本，点击下方官方链接获取，安全无捆绑：👉 官方下载链接：OpenClaw v2.4.1 Windows 一键部署包已部署旧版本的用户，直接覆盖安装或更新至 v2.4.1。

步骤 2：启动 OpenClaw 终端配置

1. 以管理员身份打开 PowerShell/CMD，进入 OpenClaw 安装目录（如D:\OpenClaw）。
2. 执行命令启动配置向导：
3. 按向导提示操作：
   • 选择「Channels」（通信渠道）→「Link」（添加新渠道）。
   • 渠道类型选择「feishu」（飞书）。
   • 系统检测到飞书插件未安装，输入「y」确认安装，等待插件下载完成。

步骤 3：填写飞书应用凭证

插件安装完成后，按提示输入飞书应用凭证（直接粘贴之前保存的内容）：

1. 输入「App ID」→ 回车。
2. 输入「App Secret」→ 回车。
3. 输入「Verification Token」→ 回车。
4. 「Endpoint type」选择「im」（实时通讯）→ 回车。
5. 「Environment」选择「国内」→ 回车。
6. 「Allow group chat」选择「open」（允许群聊使用）→ 回车。
7. 「Allow private chat」新手可先选择「close」（关闭私聊，后续可修改）→ 回车。
8. 最后选择「finished」完成配置，提示「Feishu channel configured successfully」表示成功。

步骤 4：重启 OpenClaw 网关

配置完成后，必须重启网关使飞书通道生效，执行命令：

等待网关重启完成，终端显示「Gateway started successfully」，飞书长连接建立成功。

五、机器人配对与使用（第三步：激活验证）

步骤 1：将机器人加入飞书群聊

1. 打开飞书客户端，进入目标群聊 → 点击右上角「...」→「群机器人」→「添加机器人」。
2. 搜索之前创建的应用名称（如「OpenClaw AI 助手」）→ 点击「添加」，完成机器人入群。

步骤 2：首次配对（激活机器人）

1. 在群聊中 @机器人，发送任意消息（如「你好」）。
2. 机器人会自动回复配对提示，包含「Feishu user id」和「Pairing code」（8 位字符）。
3. 回到 OpenClaw 终端，执行配对批准命令（将 XXXX 替换为实际配对码）：
4. 终端提示「Pairing approved」，表示配对成功，机器人激活完成。

步骤 3：飞书机器人使用示例

配对成功后，即可在飞书群聊中 @机器人，发送自然语言指令，体验 AI 能力：

• @OpenClaw AI 助手 帮我整理群内文件，按文档、图片分类。
• @OpenClaw AI 助手 提取这份 PDF 的核心内容，生成摘要。
• @OpenClaw AI 助手 批量重命名群内所有图片，格式为「日期 + 序号」。

六、高频报错排查（Win10/Win11 实测有效）

报错 1：飞书机器人无响应，Gateway 显示「Feishu offline」

• 原因：长连接未建立、凭证填写错误、飞书应用未发布。
• 解决：核对 App ID/Secret/Token 是否正确；重新发布飞书应用；执行openclaw gateway restart重启网关。

报错 2：配对时提示「Pairing failed」

• 原因：配对码错误、网关未在线、飞书应用权限不足。
• 解决：复制完整配对码；确保 Gateway 在线；重新开通飞书权限并发布。

报错 3：飞书提示「机器人无权限回复」

• 原因：群聊 / 私聊权限配置为「close」，或未开通消息权限。
• 解决：执行openclaw config重新配置飞书渠道，开启群聊权限；检查飞书权限是否完整。

报错 4：终端执行命令提示「不是内部或外部命令」

• 原因：未以管理员身份启动终端，或未进入 OpenClaw 安装目录。
• 解决：以管理员身份打开终端，cd进入 OpenClaw 安装路径，重新执行命令。

七、总结

OpenClaw v2.4.1 飞书机器人配置流程清晰，Win10/Win11 系统通用，无需开发基础即可完成。核心步骤为「飞书开放平台创建应用→OpenClaw 配置飞书通道→重启网关→机器人配对」，严格遵循「长连接模式、权限完整、发布生效、管理员启动」四大原则，即可快速实现本地 AI 与飞书的无缝协同，提升办公效率。

需要配置飞书机器人的朋友，直接通过下方官方链接获取 OpenClaw v2.4.1 部署包，跟着教程操作，快速拥有专属飞书 AI 助手：👉 官方下载链接（再次强调）：OpenClaw v2.4.1 Windows 一键部署包