← 返回控制台

📱 集成飞书

本文介绍如何将虾窝 AI 智能体与飞书集成，实现在飞书群聊或单聊中与 AI 对话交互。

📋 环境准备

如果已经部署好 OpenClaw 并配置了 API Key，可跳过此部分，直接进入下方集成步骤。

购买轻量应用服务器

配置 OpenClaw

⚠️ 请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据，任何持有此链接的人都能直接绕过登录验证获得管理员权限。
一、控制台扫码接入（推荐）

适用于 OpenClaw 2026.3.28 镜像及以上版本。

1

打开扫码入口

登录轻量应用服务器控制台，找到目标服务器，进入应用详情页签。在「通道配置 > 飞书」区域，单击「扫码配置」。

2

扫码完成接入

等待命令执行完成（约 30 秒到 2 分钟），页面将显示一个二维码。使用飞书扫描该二维码完成接入，扫码后单击关闭。

3

验证

与机器人对话验证。首次对话一般需要等待 30 秒到 2 分钟，请耐心等待。

二、手动配置

适用于所有版本，推荐精度更高的配置方式。

1

创建飞书应用

访问 飞书开放平台，单击「创建企业自建应用」，填写应用名称和描述，选择应用图标，单击创建。

2

获取凭据

左侧导航栏「凭证与基础信息」，复制 App ID（格式如 cli_xxx）和 App Secret。

3

开通权限

在「权限管理」页面，点击「批量导入/导出权限」按钮，粘贴以下 JSON 配置，单击下一步确认并申请开通：

{ "scopes": { "tenant": [ "im:chat", "im:message", "im:message:send_as_bot", "im:resource", "im:message.p2p_msg:readonly", "im:message.group_msg", "im:message.group_at_msg:readonly", "im:chat.members:bot_access", "im:chat.access_event.bot_p2p_chat:read", "docs:document.content:read", "sheets:spreadsheet", "wiki:wiki:readonly", "contact:user.employee_id:readonly", "cardkit:card:write", "application:application:self_manage", "application:bot.menu:write", "event:ip_list", "aily:file:read", "aily:file:write" ], "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] } }
4

添加机器人能力

左侧导航栏「添加应用能力」→「按能力添加」，找到「机器人」卡片，单击配置。

5

配置事件订阅

左侧导航栏「事件与回调」→「事件配置」页签：

  • 订阅方式选择「使用长连接接收事件」，单击保存
  • 单击「添加事件」，搜索 im.message.receive_v1（接收消息），确认添加
6

提交审核发布

在「版本管理与发布」页面创建版本，填写版本号和更新说明，单击保存，提交审核并发布。

7

联系管理员配置

将 App ID 和 App Secret 发送给虾窝管理员，我们将为您完成配置并重启 Gateway。

三、旧版本配对码连接

适用于 OpenClaw 2026.3.13 之前版本，需使用配对码连接。

1

获取配对码

向机器人发送任意私聊消息，机器人会回复一个配对码。

2

批准配对

在 WebUI 页面输入命令：

openclaw pairing approve feishu 配对码

将「配对码」替换为上一步机器人回复的实际配对码。

3

备选方案：终端命令行

如出现「目前没有待处理的配对请求」报错，可通过终端配对：

# 查看待配对列表 openclaw pairing list feishu # 批准配对 openclaw pairing approve feishu 配对码

💡 常见问题

  • 首次对话需要等待 30 秒到 2 分钟，请耐心等待机器人初始化。
  • 如何在群聊中使用？ 在群设置 → 群机器人 → 添加机器人，搜索并添加您的应用。
  • 需要配置定时任务？ 可在对话中让 Agent 创建定时任务，系统会自动执行并发送结果。
  • 如何通过终端命令完成配对？ SSH 登录服务器后执行 openclaw pairing list feishu 查看配对码，再执行 openclaw pairing approve feishu 配对码 完成配对。
  • 如何配置定时任务输出到飞书机器人？ 可在群设置中添加自定义机器人获取 Webhook 地址，然后在对话中以格式「定时任务内容 + Webhook 地址」创建任务。
  • 如需修改或取消定时任务，可直接在对话中让 Agent 修改或取消。