本文介绍将 OpenClaw服务与飞书集成,实现在飞书群聊或单聊中,通过自然语言直接与OpenClaw交互。
环境准备
配置消息渠道前,需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器,若已完成可跳过此步骤。
集成飞书
OpenClaw插件集成方式仅支持镜像版本为OpenClaw 2026.2.9及以上的实例。如需在旧版本中集成该消息渠道,请参考通过AppFlow集成消息渠道。您可在轻量应用服务器概览页的中查看当前实例的镜像版本。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配置定时任务。



