前置准备
在开始之前,请确保本地已安装 OpenClaw 并完成了大模型的基础配置。如果尚未搭建环境,建议先查阅相关文档完成基础部署。
1. 初始化 OpenClaw 频道
打开终端执行以下命令进入配置模式:
openclaw config
系统会提示进行安装,期间可能需要等待片刻。安装完成后,界面会要求填写飞书的 App ID 和 App Secret。此时可以先跳过,后续步骤获取到凭证后再回来填写。


2. 获取飞书应用凭证
你需要先在飞书开发者后台创建一个机器人应用。官方文档提供了详细的创建流程,可以参考 飞书官方文档。
重点在于获取 App ID 和 App Secret,这两个值稍后会在 OpenClaw 中用到。

3. 配置事件订阅(关键步骤)
很多教程容易忽略这一步,导致机器人无法响应消息。在配置事件长连接时,必须确保 OpenClaw 端安装了飞书 SDK,并且订阅了必要的事件权限。
请将以下事件 Scope 添加到配置中,否则聊天将无反应:
im.chat.member.bot.deleted_v1
im.chat.member.user.added_v1
im.message.message_read_v1
im.message.receive_v1
4. 完成配对与对话
最后一步是建立连接。打开飞书客户端,找到刚才创建的机器人,尝试发送一条消息。机器人会弹出一个 Pairing Code(配对码),复制该代码。
回到终端执行以下命令进行授权:
openclaw pairing approve feishu <配对码> --notify

执行成功后,飞书机器人会弹出确认信息,此时即可正常进行对话测试。



