OpenClaw飞书集成成功的关键在于插件安装、权限配置与链路激活：必须执行openclaw plugins install @m1heng-clawd/feishu并确认状态为active，同时在飞书开放平台启用im:message.group_at_msg:readonly高级权限，且webhookUrl与server.port严格匹配公网HTTPS可达地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
能跑通，但关键卡点不在代码本身，而在飞书权限配置和 OpenClaw 的插件链路是否真正激活。OpenClaw 2026.x 版本已把飞书接入封装成插件，不装插件、不设 token、不启用事件订阅，哪怕代码全对也收不到一条消息。
openclaw plugins install @m1heng-clawd/feishu 必须成功执行
这是整个集成的启动开关。官方飞书插件不是可选组件，而是消息路由中枢——它负责把飞书发来的加密事件解签、转成 OpenClaw 内部格式，并触发模型调用。没装这个插件，openclaw config set channels.feishu.appId 配的全是空转。
- 执行后必须看到
Plugin @m1heng-clawd/feishu installed successfully，否则检查 npm 权限（Windows 下建议用管理员身份运行 Git Bash） - 插件安装路径默认在
%APPDATA%\npm\node_modules\openclaw\plugins\feishu，手动确认该目录存在且含index.js - 若提示
EACCES或permission denied，别硬改权限，直接重装：先npm uninstall -g openclaw，再清空%APPDATA%\npm\node_modules\openclaw，最后重新npm install -g openclaw@latest
飞书开放平台的 im:message.group_at_msg:readonly 权限不能漏
这是最常被跳过的一步。只开“接收消息”权限，机器人只能收到私聊；要响应群聊中 @机器人，必须单独勾选 im:message.group_at_msg:readonly。飞书后台不提示、不报错，但实际就是静默丢弃事件。
- 进入飞书开放平台 → 应用详情页 → 「权限管理」→ 「添加权限」→ 搜索关键词
group_at_msg→ 勾选并保存 - 该权限属于「高级权限」，需企业管理员审批（普通成员点“提交审批”后，等管理员点同意）
- 验证是否生效：在测试群发一条
@机器人 hello，然后立刻查 OpenClaw 日志：openclaw logs --tail 50，应出现类似feishu: received group_at event的记录
config.yaml 中 server.port 和 channels.feishu.webhookUrl 必须匹配公网可达地址
飞书回调时不会连你本地的 localhost:8080。如果你没配内网穿透或反向代理，webhook URL 就得指向一个真实可访问的域名/IP + 端口，且该端口必须和 config.yaml 里 server.port 一致，否则签名验证失败后飞书直接断连。
- 开发阶段可用
ngrok http 8080生成临时域名，然后把https://xxx.ngrok.io填进飞书后台的「事件订阅 URL」，同时确保config.yaml中server.port: 8080 - 填错会返回飞书错误码
40013（invalid url），但飞书控制台只显示“验证失败”，不说明原因 - 注意：飞书要求 webhook URL 必须是 HTTPS，HTTP 地址会被拒绝，ngrok 免费版自带 HTTPS
openclaw gateway start 后必须看到 feishu 插件状态为 active
启动服务不等于插件就绪。OpenClaw 启动时会加载所有已安装插件，但某个插件初始化失败（比如 App ID/Secret 格式错、网络不通），它会静默跳过，而 gateway 仍显示 running。
- 执行
openclaw plugins list，输出中feishu行的Status列必须是active，不是inactive或空白 - 如果状态异常，直接看插件日志：
openclaw logs --plugin feishu --tail 100，高频错误是invalid app_secret format（App Secret 含空格或换行）或tenant_access_token fetch failed（飞书应用未启用「机器人」能力） - 改完配置后别只 reload，必须重启：
openclaw gateway stop && openclaw gateway start，因为插件初始化只在启动时运行一次
飞书集成真正的难点从来不是写几行请求代码，而是让三个独立系统（飞书平台、OpenClaw 进程、你的本地网络）在认证、路由、权限上严丝合缝。任何一个环节的 token、URL、端口、权限项对不上，整条链路就断在无声处——日志不报错，消息不进来，你只能对着空聊天窗口干瞪眼。
