OpenClaw 接入飞书机器人配置全流程
使用 openclaw channels add 对接飞书机器人，核心在于打通插件、应用凭证与通道配置。整个过程可以归纳为插件安装、应用创建、通道设置、事件订阅及发布验证五个环节。下面直接切入实操细节。
一、前置准备
在动手配置之前，得先在飞书开放平台把基础环境搭好。
- 创建企业自建应用 访问飞书开放平台（https://open.feishu.cn/app），新建一个应用。名称随便起，比如'OpenClaw 助手'，描述里写清楚用途就行。
- 获取凭证信息 进入「凭证与基础信息」页面，记下 App ID（类似 cli_xxxxx）和 App Secret。这两个是后续连接的关键，别弄混了。
- 启用能力与权限 在「应用能力」里勾选并添加「机器人」能力。接着去「权限管理」，把必要的权限加进去，确保机器人能收发消息。
二、安装飞书插件
这是最关键的一步，没有插件 OpenClaw 没法识别飞书协议。直接在终端执行安装命令：
openclaw plugins install @m1heng-clawd/feishu
*注：官方推荐该插件，如果版本有变动，也可以尝试 @openclaw/feishu。
安装成功后会看到 ✓ plugin installed successfully 提示，这时候本地环境才算就绪。
三、通道配置（openclaw channels add）
插件装好后，接下来就是建立连接。这里有三种方式，看你的习惯来选。
方法 1：交互式向导配置（推荐）
适合初次上手，跟着 CLI 的提示一步步走就行。系统会自动引导你输入 App ID、Secret 以及 Webhook 地址，过程中会有校验，出错也能实时反馈。
方法 2：非交互式命令配置（适合脚本）
如果你要批量部署或者写自动化脚本，可以直接带上参数运行命令，避免人工交互。这种方式效率高，但需要你对参数结构比较熟悉。
方法 3：手动编辑配置文件
高级用户可以直接修改本地的通道配置文件，填入 JSON 格式的凭证信息。这灵活性最大，但要注意格式不能错，否则启动时会报错。
四、事件订阅与发布
通道建好不代表万事大吉，还得告诉飞书你想接收哪些消息。这一步通常在发布应用时完成，记得在后台开启对应的消息推送开关。如果是自定义事件，需要在代码里注册监听器，确保 OpenClaw 能捕获到飞书发来的回调请求。
五、测试与验证
配置完别急着上线，先测一下通不通。
- 在飞书群里@机器人，看有没有响应。
- 检查 OpenClaw 日志，确认收到了 webhook 请求且签名验证通过。
- 如果没反应，重点排查 App Secret 是否填对，以及服务器能否公网访问飞书的回调地址。
六、常见问题排查
遇到连接失败或鉴权错误，通常就几个原因：
- 凭证过期：App Secret 被重置过，记得同步更新。
- 网络限制：确保运行 OpenClaw 的环境能访问外网。
- 权限不足：检查飞书后台是否给了机器人足够的消息发送权限。
按这个流程走下来，基本就能搞定飞书机器人的集成工作了。
