OpenClaw 配置飞书机器人完整指南
用 openclaw channels add 对接飞书机器人，核心就五步：装插件、建应用、配通道、订事件、发应用。下面直接上实操细节。
一、前置准备
先搞定飞书那边的权限。访问飞书开放平台创建企业自建应用，名字随便起，比如'OpenClaw 助手'。重点是把「凭证与基础信息」里的 App ID 和 App Secret 记下来，后面填配置要用。别忘了在「应用能力」里勾选「机器人」，并在「权限管理」里加上必要的消息发送权限。
本地环境也得跟上，必须安装对应的飞书插件：
openclaw plugins install @m1heng-clawd/feishu
看到 plugin installed successfully 才算完事。如果官方源慢，也可以试试社区兼容版，但推荐先用官方的稳一点。
二、通道配置
插件装好后，就可以往 OpenClaw 里加飞书通道了。有三种方式，看你的习惯选一个。
最省事的是交互式向导，运行命令后跟着提示输就行，适合新手。如果你要写脚本批量部署，可以用非交互式命令直接把参数塞进去。当然，老手更喜欢直接改配置文件，手动编辑 channels.json 或类似文件，把刚才拿到的 App ID 和 Secret 填进去，这样版本控制也方便。
不管哪种方式，核心就是把凭证传对，让 OpenClaw 能连上飞书的接口。
三、事件订阅与发布
这一步最关键，很多报错都出在这儿。飞书要求应用必须先订阅感兴趣的事件才能收消息。在飞书后台找到「事件订阅」，把需要的业务事件勾上，比如「收到消息」、「群聊更新」之类的。
同时记得填回调地址（Callback URL），通常就是 OpenClaw 提供的接收端点。飞书会发验证请求过来，这时候 OpenClaw 得能正确响应签名校验，否则订阅会失败。配置完记得点保存，然后去「发布应用」状态里确认一下，没发布的话飞书那边是收不到推送的。
四、测试与验证
配置完别急着上线，先在群里测一下。给机器人发条消息，看看能不能触发 OpenClaw 的逻辑。如果没反应，先看日志有没有报错，特别是签名校验失败或者网络超时的问题。
如果是开发环境，可以开启调试模式，把飞书发来的原始 Payload 打印出来，对比一下格式对不对。有时候是时间戳不对导致签名失效，注意服务器时间同步。
五、常见问题排查
- Token 过期：App Secret 别泄露，定期轮换。
- 权限不足：检查机器人是否有发送消息的权限，尤其是群聊场景。
- 网络问题：确保 OpenClaw 所在机器能访问飞书公网 API，防火墙别拦着。
- 事件未生效：确认应用已发布，且事件列表已保存。
按这个流程走一遍，基本就能把飞书机器人跑通了。遇到具体报错再查文档，大部分情况都是配置细节没对上。
