最近看到一篇关于“OpenClaw 接入飞书”的实操贴，里面提到一个很现实的问题：不少旧教程已经跟不上新版 OpenClaw / 飞书开放平台的变化，照抄很容易卡在权限、事件订阅或配对上。
这篇文章把流程重新整理成一套“从 0 到能收消息”的最短路径，并补上几个高频踩坑点。为了避免版权风险，本文不搬运原帖截图，全部用文字步骤 + 自制流程图讲清楚。
你最终要达成什么效果？
- 飞书里能找到你的机器人
- 给机器人发消息，OpenClaw 能收到并处理（或至少能看到连接/日志正常）
- OpenClaw 和这个机器人完成配对（pairing）
准备清单
- 一个飞书账号（个人/企业均可，能进开发者后台）
- OpenClaw 已安装并能运行（建议先确认版本）
openclaw --version
整体流程（先看一眼全貌）
第 1 步：在飞书创建“企业自建应用” + 机器人
- 打开飞书官网，登录后进入 开发者后台
- 创建 企业自建应用（名称/描述按需填写）
- 在“应用能力”里 添加机器人（后续就是用它收消息）
第 2 步：把 IM 相关权限一次开够
权限是最容易“看着像通了，其实一直 403”的地方。实操建议：
- 在权限管理里搜索
im相关条目 - 把你要用到的 收发消息、会话相关权限统一开通
第 3 步：创建并发布一个应用版本（非常关键）
不少人忽略“发布版本”，结果就是机器人看着能用，但事件订阅/权限没有真正生效。
- 创建版本：填版本号 + 更新说明即可
- 保存后发布
第 4 步：在 OpenClaw 里添加飞书通道
如果你之前配置过其它渠道（Telegram/Slack），这一步类似：把飞书的 AppID / AppSecret 填进去，并选择对应区域（国内用户一般选中国）。
openclaw channels add
接着按提示输入：
- 账号名（给这个飞书连接起个名字，方便区分）
- 飞书区域（CN / Global）
- App ID 与 App Secret
第 5 步：重启 gateway，让配置生效
openclaw gateway restart
第 6 步：事件订阅（选择“接收消息”）
回到飞书开发者后台，找到“事件与回调/订阅”相关页面：
- 订阅方式选择 长连接（更适合本地部署）
- 添加事件时，搜索并勾选 接收消息（以及你确实需要的其它事件）
很多情况下，这一步做完后还需要你 再次创建并发布一个新版本，让新的订阅与权限真正上线。
第 7 步：完成配对（pairing approve）
最后一步是“把机器人和 OpenClaw 绑定起来”。常见做法是：
- 在飞书里找到你的机器人，给它发一条消息
- 机器人会返回一个配对码（pairing code）
- 在 OpenClaw 里批准配对
openclaw pairing approve feishu <PAIRING_CODE>
排错：最常见的 4 个问题
- 权限不足/403：大概率是 IM 权限没开全，或开了但没重新发布版本。
- 事件收不到：先检查事件订阅是否勾选“接收消息”，再检查是否发布版本、生效环境选对（CN/Global）。
- 改完配置仍然不生效：重启
openclaw gateway，再看日志是否有连接/鉴权错误。 - 同一个配置在不同机器表现不一致：优先核对 Node 版本、OpenClaw 版本、以及是否缺少依赖包。
来源与说明
本文基于公开贴的思路重新整理并补充排雷点，原始讨论链接如下（仅作引用与致谢）：
https://x.com/0xvalkyrie_ai/status/2020330035652227360
如果你在“创建版本/事件订阅/配对码”某一步卡住了，可以把报错信息（注意遮住密钥）贴在评论区，我可以帮你一起定位问题。
小广告一句：我会在 wuxing.name 持续整理 OpenClaw / 本地部署 / AI 工具链的踩坑笔记，想系统跟进可以收藏一下。
