先安装 OpenClaw 再配飞书
飞书接入本身并不复杂，复杂的是把安装、凭据、事件订阅和网关状态混在一起排错。先装好 OpenClaw，再接飞书会省很多时间。
OpenClaw 教程飞书接入Lark/Feishu
OpenClaw 飞书接入教程：从创建应用到机器人可对话
这页给搜索“OpenClaw 飞书接入教程”“OpenClaw 飞书机器人”“OpenClaw Lark 配置”的用户用。目标不是只告诉你一个命令，而是把官方文档里的关键动作重新排成更适合实操的顺序。
OpenClaw 官方 Feishu 文档目前的主路线很清楚：当前版本通常已经自带 Feishu 插件，你可以直接走 onboarding 或 channels add，然后回到飞书开放平台创建应用、配置权限、开启长连接事件订阅，再启动网关测试。
Feishu 插件默认随版本打包支持 Lark 全局环境默认 DM policy 为 pairing
飞书这条链路不需要公网 webhook
官方文档说明 Feishu 通过 WebSocket 事件订阅工作，这意味着你不一定要先暴露一个公网 webhook 地址。
真正容易漏的是权限和发布
很多“机器人不回消息”的情况，最后都不是 CLI 问题，而是飞书应用没开 bot 能力、没配齐权限、没发布或事件订阅没加对。
接入前先准备什么
按官方文档，最短前提就是 OpenClaw 已经能正常运行，且你有一个可以登录的 Feishu Open Platform 或 Lark Open Platform 账户。
- 确认 OpenClaw 已经安装好，至少能执行
openclaw gateway status和openclaw logs --follow。 - 准备 Feishu 或 Lark 开放平台账号；如果是国际环境，官方文档要求在配置里使用
domain: "lark"。 - 后续会用到 App ID 和 App Secret，所以飞书应用创建完成后先把这两个值保管好。
飞书接入的最短路径
如果你刚装好 OpenClaw，优先使用官方推荐的 onboarding 或 channels add 路线。
- 在 OpenClaw 侧执行
openclaw onboard，或在已经完成安装的前提下执行openclaw channels add。 - 去飞书开放平台创建企业应用，拿到
App ID和App Secret。 - 在 Permissions 里导入官方文档给出的权限集合，并开启 Bot 能力。
- 进入 Events & Callbacks，选择使用长连接接收事件，并添加
im.message.receive_v1事件。 - 完成发布后，启动网关
openclaw gateway，在飞书里给机器人发消息，再用openclaw pairing approve feishu <CODE>完成首次配对。
配置时最值得注意的几个点
官方文档里有几处很容易被忽略，但它们基本决定了飞书机器人会不会真的动起来。
- 当前版本通常已经自带 Feishu 插件；只有旧版本或自定义安装缺少 bundled plugin 时，才需要单独执行
openclaw plugins install @openclaw/feishu。 - 默认私聊访问模型是
dmPolicy: "pairing"，第一次陌生用户私聊时会先拿到配对码，这不是报错，是默认安全策略。 - 如果你在群聊里测试，默认行为通常要求 @ 提及机器人；另外要检查 groupPolicy 没被设成 disabled。
飞书端最常见的故障不是“代码错了”，而是应用未发布、权限不完整、事件订阅漏配或网关没启动。
飞书接入失败时先查哪里
官方文档已经把最有用的排查顺序给出来了，直接照着查比盲目重装更快。
- 检查应用是否已经发布并通过审批。
- 确认事件订阅里包含
im.message.receive_v1，并且长连接模式已启用。 - 回到终端看
openclaw gateway status和openclaw logs --follow。 - 如果怀疑密钥泄露，按官方文档先在飞书平台重置 App Secret，再更新 OpenClaw 配置并重启网关。