本文介绍将 OpenClaw服务与飞书集成,实现在飞书群聊或单聊中,通过自然语言直接与OpenClaw交互。
环境准备
配置消息渠道前,需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器,若已完成可跳过此步骤。
集成飞书
OpenClaw插件集成方式仅支持镜像版本为OpenClaw 2026.2.9及以上的实例。如需在旧版本中集成该消息渠道,请参考通过AppFlow集成消息渠道。您可在轻量应用服务器概览页的中查看当前实例的镜像版本。
控制台扫码接入
只支持 OpenClaw 2026.3.28 镜像及以上版本,其他版本使用手动配置接入。
-
登录轻量应用服务器控制台,找到目标 OpenClaw 服务器,进入应用详情页签。
-
在通道配置区域的飞书部分,单击扫码配置。
-
等待命令执行完成后,页面将显示一个二维码。使用飞书扫描该二维码完成接入。
生成二维码一般需要30秒到2分钟,请耐心等待。
-
扫码完成后,单击关闭。
-
与机器人对话验证。
首次对话一般需要等待30秒到2分钟,请耐心等待。
手动配置
1. 创建飞书应用
-
访问飞书开放平台,单击创建企业自建应用,填写应用名称和描述,选择应用图标,单击创建。
-
左侧导航栏单击凭证与基础信息 页面,复制App ID(格式如
cli_xxx)和App Secret。 -
左侧导航栏单击 权限管理 页面,点击批量导入/导出权限 按钮,粘贴以下 JSON 配置,单击下一步,确认新增权限,单击申请开通。
-
左侧导航栏中单击, 选择按能力添加页签,找到机器人卡片,单击配置。

-
配置事件订阅。
-
在轻量应用服务器控制台,进入目标实例详情页,在区域,填入之前获取的App ID和App Secret,并单击应用。
-
在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存。
-
在事件配置页面,单击添加事件,搜索事件
im.message.receive_v1(接收消息),单击确认添加。
-
-
在 版本管理与发布 页面创建版本,填写应用版本号和更新说明,单击保存,提交审核并发布。
2. 配置机器人
可以创建群聊或在已有群聊中添加机器人,在飞书群中@机器人进行对话,或通过搜索的方式与机器人私聊进行测试。
若需在外部群中使用机器人,可参考配置文档机器人支持外部群和外部用户单聊。
-
按照添加路径添加机器人: 。
-
单击机器人头像,单击发送消息,可向机器人私发一条消息,@机器人可在群中向机器人发送消息。
OpenClaw 2026.3.13 版本之前,需使用配对码连接机器人,可参考如下步骤配置。
常见问题
如何通过终端命令将OpenClaw与飞书配对?
-
登录服务器。
-
登录轻量应用服务器控制台。
-
在服务器列表中,找到目标服务器卡片,单击卡片中的远程连接。在弹出的连接窗口中,在Workbench 一键连接区域单击立即登录。
-
-
获取配对码。
在终端执行以下命令,找到待配对的飞书机器人配对码,复制查询结果中的配对码。
openclaw pairing list feishu
-
完成配对。
在终端执行以下命令,批准配对请求。将命令中的YXXX替换为上一步获取的实际配对码。
openclaw pairing approve feishu YXXX
如何配置OpenClaw定时执行任务并输出内容到飞书机器人?
可以通过与OpenClaw对话创建定时任务。
-
获取群机器人的Webhook地址:
-
单击群。

-
单击添加机器人,选择自定义机器人。填写机器人名称和描述,单击添加,复制Webhook地址。
-
-
在OpenClaw对话中创建相应任务,格式为定时任务内容+群机器人的Webhook地址,以查询实时天气为例创建定时任务。
-
验证消息发送。可在对话中让Agent立即发送消息,测试该定时任务。在机器人所在的群聊查看是否执行定时任务。
如要修改或者取消定时任务,可直接在对话中让Agent修改或取消定时任务。
如需使用AppFlow配置定时任务,请参考如何使用AppFlow配置定时任务。

