OpenClaw 接入飞书机器人配置指南
使用 openclaw channels add 配置飞书机器人涉及插件安装、应用创建、通道设置等核心环节。以下是经过验证的配置流程，按步骤操作即可打通消息推送。
前置准备
1. 创建飞书企业自建应用
首先需要在飞书开放平台完成基础应用搭建：
- 访问飞书开放平台创建企业自建应用，名称建议设为 "OpenClaw 助手" 以便识别。
- 在「凭证与基础信息」中记录 App ID（cli_开头）和 App Secret，后续配置必须用到。
- 进入「应用能力」→「添加应用能力」，选择并启用「机器人」。
- 在「权限管理」中按需勾选必要权限，确保机器人有发送消息的 scope。
2. 安装飞书插件
本地环境需先加载对应的飞书支持模块。推荐使用官方维护的插件包：
openclaw plugins install @m1heng-clawd/feishu
执行后若看到 plugin ... installed successfully 提示，说明环境已就绪。如果该插件不可用，可尝试社区兼容版本 @openclaw/feishu。
通道配置
接下来通过 CLI 命令建立连接，这里提供三种常用方式，根据场景选择即可。
交互式向导配置
直接运行 openclaw channels add 命令，系统会引导你依次输入 App ID、Secret 及 Token。这种方式适合初次配置，不容易输错参数。
非交互式命令配置
适合脚本化部署或 CI/CD 流程，直接在命令行传入参数：
openclaw channels add --type feishu --app-id xxx --secret xxx
注意参数顺序，具体 flag 含义可参考帮助文档 --help。
手动编辑配置文件
对于高级用户，也可以直接修改本地配置文件，将凭证写入 JSON 或 YAML 文件中。这种方式灵活性高，但需确保文件权限安全，避免泄露密钥。
事件订阅与发布
配置完成后，关键一步是处理事件回调。飞书机器人需要接收服务器回调来确认身份，同时 OpenClaw 也需要监听特定事件触发自动化任务。
- URL 验证：确保你的服务能响应飞书的校验请求，通常包含一个随机 token。
- 事件订阅：在飞书后台订阅所需的事件类型（如群聊消息、私信），并在 OpenClaw 端映射到对应的事件处理器。
- 发布应用：最后记得在飞书开放平台点击「发布应用」，否则测试账号可能无法调用接口。
测试与验证
配置完毕别急着上线，先跑个简单测试：
- 在飞书群里 @机器人，发送一条测试指令。
- 观察 OpenClaw 日志输出，确认是否收到 webhook 请求。
- 检查返回状态码，200 表示成功，4xx/5xx 需排查签名或网络问题。
如果日志里出现签名验证失败，通常是 App Secret 填错了或者时区不一致导致时间戳校验不通过。
常见问题排查
- Token 无效：检查是否使用了旧版 Token，重新获取一次。
- 权限不足：确认飞书应用是否添加了足够的 Scope，特别是读取成员信息的权限。
- 插件未加载：尝试重启 OpenClaw 服务，确保插件被正确注册。
按照以上步骤，基本能解决 90% 以上的集成问题。遇到特殊报错时，建议优先查阅飞书官方 API 文档，再结合 OpenClaw 的日志定位根因。
