2026年[特殊字符] OpenClaw 接入飞书完整指南（CMD版）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本文基于真实安装经验整理，全程只用到 PowerShell / CMD 命令行，不需要 Web 控制台。

前置条件：

OpenClaw 已安装完成，能通过 openclaw chat 正常使用（参考上份指南）
必须有飞书账号（个人/企业均可，企业账号需有开发者权限）

⚠️ 不需要公网 IP，全程使用飞书自带的 WebSocket 长连接模式

1. 登录并创建应用

访问飞书开放平台，使用飞书账号登录 [6†L8-L11][8†L7-L9]。

点击右上角「开发者后台」→「创建企业自建应用」，填写：

应用名称：OpenClaw助手（可自定义）
应用图标：任意上传一张图片

点击「创建」保存

2. 添加机器人能力

进入应用详情页 → 左侧「添加应用能力」→ 找到并添加「机器人」。

3. 批量导入权限（关键步骤）

左侧「权限管理」→「批量导入/导出权限」→ 选择「应用身份权限」，粘贴以下 JSON：

{ "scopes": { "tenant": [ "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot", "im:resource", "contact:user.base:readonly" ] } }

点击「格式化」→「下一步」→「申请开通」。

💡 个人账号免审核，立即生效；企业账号需管理员审核

4. 获取 App ID 和 App Secret

左侧「凭证与基础信息」→ 在「应用凭证」区域：

App ID：格式 cli_xxxxx，直接复制
App Secret：点击「显示」，复制完整内容

⚠️ App Secret 相当于应用的密码，请妥善保管。

全程在 PowerShell（管理员）中进行

1. 逐条执行配置命令

openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.appId "cli_你的AppID" openclaw config set channels.feishu.appSecret "你的AppSecret" openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.dmPolicy pairing openclaw config set channels.feishu.groupPolicy allowlist openclaw config set channels.feishu.requireMention true

每条命令执行后显示 Updated... 表示成功。

💡 dmPolicy pairing 表示私聊需要配对才能使用，后续会进行设备配对。

2. 配置保存到配置文件

这些命令会自动写入 %USERPROFILE%.openclawopenclaw.json。

3. 重启 Gateway

openclaw gateway restart

Windows下如果 restart 报错，手动操作：

在运行 openclaw gateway 的窗口按 Ctrl+C
重新运行 openclaw gateway

注意保持 Gateway 窗口一直打开，不要关闭。

1. 配置事件订阅

左侧「事件与回调」→ 订阅方式选择「使用长连接接收事件」→ 点击右上角「保存」。

⚠️ 选择「使用长连接接收事件」，不是 Webhook！这是内网用户无需公网 IP 的关键。

2. 添加接收消息事件

点击「添加事件」→ 搜索 im.message.receive_v1 → 勾选「接收消息 v2.0」→ 点击「确认添加」。

3. 发布应用使配置生效

左侧「版本管理与发布」→「创建版本」

应用版本号：1.0.0
更新说明：OpenClaw 机器人初始配置
移动端/桌面端默认能力：均选择「机器人」

点击「保存」→「确认发布」。

1. 在飞书中找到机器人

打开飞书 PC 端或手机端 → 搜索你创建的应用名称（如 OpenClaw助手）。

2. 发送消息获取配对码

向机器人发送任意消息（如 你好）→ 机器人会回复一个 6 位数字配对码（如）。

💡 配对码由飞书机器人自动生成，不需要提前配置。

3. 在终端批准配对

openclaw pairing approve feishu

（把换成你实际收到的配对码）

4. 验证是否成功

再次给机器人发送 你好，如果能正常回复，就成功了！

配对成功后不需要重启，立即生效。

现象原因解决方法飞书收不到消息应用未发布/权限未开通确认应用状态为「已发布」，检查权限和事件机器人不回复设备未配对发送消息获取配对码，执行

openclaw pairing approve feishu 
    <配对码>

群聊不回复默认需要 @提及发送 @机器人你好 试试，或在配置中修改 requireMention false [12†L24-L25] 发布后仍无响应缓存未刷新等待几分钟，或在飞书管理后台重新测试 Gateway 连接异常服务未运行运行 openclaw gateway 确保服务在线

快速诊断：

openclaw status –all # 检查整体状态 openclaw pairing list feishu # 查看待配对请求 openclaw logs –follow # 查看实时日志

机器人默认加入群聊后，需要 @机器人 才会回复。如果想让它自动响应所有消息，可以修改配置：

openclaw config set channels.feishu.requireMention false openclaw gateway restart

此时机器人在群里看到任何消息都会回复，注意可能会造成刷屏 [12†L13-L15]。

项目状态飞书机器人创建 ✅ 完成权限配置 ✅ 完成（含 im:message 等）长连接订阅 ✅ 完成 CMD 配置凭证 ✅ 完成设备配对 ✅ 完成可以开始使用 ✅ 是

现在你可以在飞书里直接给机器人发指令了，比如 帮我整理桌面文件、列出C盘下的PDF。配对不同担心，一次成功以后就稳定了——你的龙虾终于愿意用你习惯的方式和你说话了。🦞

43 个网页