OpenClaw 集成飞书机器人配置指南
使用 openclaw channels add 配置飞书机器人主要涉及插件安装、应用创建、通道配置、事件订阅及发布五个环节。下面直接给出可执行的详细流程。
一、前置准备
-
安装飞书插件 这是必要步骤，推荐使用官方维护的插件。
openclaw plugins install @m1heng-clawd/feishu安装成功后会显示
plugin installed successfully提示。 -
飞书开放平台创建应用 访问飞书开放平台创建企业自建应用，记录凭证信息。
- 进入「凭证与基础信息」，获取 App ID 和 App Secret。
- 在「应用能力」中添加并启用「机器人」。
- 在「权限管理」中按需添加必要权限。
二、通道配置
通过命令行工具进行通道绑定，支持交互式向导和非交互式命令两种方式。
方法 1：交互式向导（推荐） 运行以下命令，按提示输入刚才获取的凭证信息即可自动完成配置。
openclaw channels add feishu
方法 2：非交互式命令 适合脚本化操作，直接在命令中传入参数。
openclaw channels add feishu --app-id xxx --secret xxx
三、事件订阅与发布
配置完成后，别忘了回到飞书后台完成最后一步。
- 确保应用状态已切换为「已发布」，否则无法接收消息。
- 在「事件订阅」中勾选需要监听的事件类型，保存后等待生效。
四、测试与验证
配置完毕后可尝试发送一条测试消息。如果机器人正常回复，说明链路打通。若未收到响应，请检查日志中的错误码。
五、常见问题排查
- 凭证无效：通常是因为 App Secret 填写错误或应用未发布。
- 权限不足：确认是否添加了足够的机器人权限。
- 网络问题：确保服务器能访问飞书开放平台域名。
