在开始之前,请确保本地已安装 OpenClaw 且底层大模型配置完毕。若未熟悉基础环境,建议先查阅相关入门文档。
一、初始化 OpenClaw Channel
打开终端,运行以下命令进入配置模式:
openclaw config

等待安装完成。系统会提示输入飞书的 App ID 和 App Secret,此时可先跳过,后续步骤获取后再填入。
二、配置飞书机器人并获取凭证
飞书机器人的详细创建流程较长,官方文档中有完整指引,此处主要聚焦于与 OpenClaw 的对接细节。 飞书官方文档
关键注意点:
-
事件订阅配置 配置事件长连接时,需要在 OpenClaw 上安装飞书 SDK(如果第一步没执行,长连接可能会失败)。更重要的是,务必在飞书后台添加以下事件订阅,否则机器人将无法接收消息。这是常被忽略的关键步骤:
im.chat.member.bot.deleted_v1 im.chat.member.user.added_v1 im.message.message_read_v1 im.message.receive_v1
-
获取 App ID 与 Secret 找到应用详情页中的 App ID 和 App Secret,稍后配置 OpenClaw channel 时会用到。

三、完成配对连接
-
打开飞书,搜索并添加该机器人。

-
与机器人发起私聊对话,屏幕会出现 Pairing code(配对码),复制该代码。

-
回到终端执行配对命令:
openclaw pairing approve feishu <配对码> --notify飞书机器人将弹出确认提示。

至此,OpenClaw 与飞书机器人的连接已完成,可以正常进行对话交互了。


