OpenClaw 集成飞书机器人配置指南

OpenClaw 集成飞书机器人配置指南

使用 openclaw channels add 配置飞书机器人主要涉及插件安装、应用创建、通道配置、事件订阅及发布五个环节。下面直接给出可执行的详细流程。

一、前置准备

1. 安装飞书插件 这是必要步骤，推荐使用官方维护的插件。

   openclaw plugins install @m1heng-clawd/feishu
   

   安装成功后会显示 plugin installed successfully 提示。

2. 飞书开放平台创建应用 访问飞书开放平台创建企业自建应用，记录凭证信息。

   • 进入「凭证与基础信息」，获取 App ID 和 App Secret。
   • 在「应用能力」中添加并启用「机器人」。
   • 在「权限管理」中按需添加必要权限。

二、通道配置

通过命令行工具进行通道绑定，支持交互式向导和非交互式命令两种方式。

方法 1：交互式向导（推荐） 运行以下命令，按提示输入刚才获取的凭证信息即可自动完成配置。

openclaw channels add feishu

方法 2：非交互式命令 适合脚本化操作，直接在命令中传入参数。

openclaw channels add feishu --app-id xxx --secret xxx

三、事件订阅与发布

配置完成后，别忘了回到飞书后台完成最后一步。

• 确保应用状态已切换为「已发布」，否则无法接收消息。
• 在「事件订阅」中勾选需要监听的事件类型，保存后等待生效。

四、测试与验证

配置完毕后可尝试发送一条测试消息。如果机器人正常回复，说明链路打通。若未收到响应，请检查日志中的错误码。

五、常见问题排查

• 凭证无效：通常是因为 App Secret 填写错误或应用未发布。
• 权限不足：确认是否添加了足够的机器人权限。
• 网络问题：确保服务器能访问飞书开放平台域名。