OpenClaw 飞书接入一定要手动装插件吗？

不一定。官方文档说明当前版本通常已经随 OpenClaw release 打包了 Feishu 插件，只有旧版本或自定义安装缺少 bundled plugin 时才需要手动安装。

为什么飞书机器人发了消息没有反应？

优先检查应用是否已发布、权限是否导入完整、事件订阅是否包含 im.message.receive_v1，以及网关是否真的在运行。

Lark 国际版怎么处理？

官方文档要求在使用 Lark 全局环境时走 open.larksuite.com，并在 Feishu 配置中设置 domain 为 lark。

OpenClaw 教程飞书接入Lark/Feishu

OpenClaw 飞书接入教程：从创建应用到机器人可对话

这页给搜索“OpenClaw 飞书接入教程”“OpenClaw 飞书机器人”“OpenClaw Lark 配置”的用户用。目标不是只告诉你一个命令，而是把官方文档里的关键动作重新排成更适合实操的顺序。

OpenClaw 官方 Feishu 文档目前的主路线很清楚：当前版本通常已经自带 Feishu 插件，你可以直接走 onboarding 或 channels add，然后回到飞书开放平台创建应用、配置权限、开启长连接事件订阅，再启动网关测试。

Feishu 插件默认随版本打包支持 Lark 全局环境默认 DM policy 为 pairing

先看 Windows 安装继续看 Telegram 接入

先安装 OpenClaw 再配飞书

飞书接入本身并不复杂，复杂的是把安装、凭据、事件订阅和网关状态混在一起排错。先装好 OpenClaw，再接飞书会省很多时间。

飞书这条链路不需要公网 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 配置并重启网关。

OpenClaw 官方 Feishu 文档 OpenClaw Windows 安装教程 OpenClaw 飞书报错排查

专题地图SEO / GEO

继续深入的主题入口

如果你是从搜索进入本站，可以先用下面这些专题判断下一步要看安装、排错、工具接入、提示词还是长期学习路线。

OpenClaw Windows 安装教程

适合先完成本地环境、依赖检查和首次运行，减少安装报错带来的试错时间。