前置准备工作

在正式开始为OpenClaw(原Clawdbot，中文名俗称“龙虾”)配置接入飞书机器人之前，请您依次检查如下事项是否准备完成：

• 您已经拥有一个飞书账号。
• 是否已经在轻量应用服务器Lighthouse实例中部署了OpenClaw，如果暂时还没有，建议：
  • 如果您希望新购一台Lighthouse服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的购买页选购，或者前往腾讯云OpenClaw专属活动进行优惠下单。详细的部署和配置OpenClaw流程可参考云上OpenClaw(原Clawdbot)一键秒级部署指南。
  • 如果您使用OpenClaw应用模板创建Lighthouse服务器的时间早于2026年2月11日，建议参考教程更新版本：如何更新服务器OpenClaw应用版本。

云上OpenClaw接入飞书场景推荐使用国内的服务器和模型服务。

接入飞书

接入方式一（快捷配置）：

进入腾讯云控制台

进入腾讯云控制台，选中对应的已部署OpenClaw的Lighthouse服务器实例，点击服务器卡片进入“管理实例”页；

进入应用管理

进入腾讯轻量云Lighthouse应用管理页的配置面板；

模型配置

为OpenClaw配置模型API Key可以在轻量应用服务器Lighthouse产品控制台的应用管理页面进行操作。详情可参考云上OpenClaw(原Clawdbot)一键秒级部署指南-配置模型API Key，此处不再赘述。

选择飞书通道

在通道（Channels）的下拉列表中选择“飞书”；

选择“快捷配置”后，点击“前往授权”按钮；

扫码配置

使用飞书App扫描弹出的配置二维码；

扫码后，在飞书App内选择“继续授权登录”；

完成登录后，返回腾讯轻量云Lighthouse应用管理页面，点击弹窗中的“我已完成扫码”；

随后飞书机器人将自动进行配置，等待弹出“飞书机器人授权配置成功”后，则代表快捷配置已完成；

解决办法

情况1:您不是管理员

请在飞书内部联系您所属组织/公司的管理员进行审核；

情况2:您是管理员

请进入 飞书企业管理后台；

点击 工作台-应用审核，在右侧应用列表点击“审核”，进行审核操作；

进入审批页面，点击右上角“通过”即可；

如果您想后续免审发布机器人，可点击“设置审核规则”；

进入审核规则页面，开启默认规则即可开启“全员免审”（蓝色为开启状态）；

与飞书机器人对话

进入飞书应用的搜索栏，输入机器人名称，找到自动创建的机器人；点击该机器人，即可进行对话。

（更多与飞书机器人的交互教程请看下文章节-与飞书机器人进行交互）

接入方式二（手动配置）：

创建飞书企业自建应用

首先，您需要使用您的飞书账号登录飞书开放平台。登录成功后，点击创建企业自建应用。

填写应用名称（如 “OpenClaw助手”）、应用描述，选择应用图标，点击创建按钮，进入应用管理页面。

添加机器人

在前一步所创建应用的管理页面，左侧导航栏中找到并点击添加应用能力，在弹出的列表中选择机器人，点击添加。

提示：添加机器人之后，可以暂不发布，待其他配置完成后一并发布。

查询AppID和AppSecret

在左侧导航栏找到 “凭据与基础信息” ，点击进入。在页面中找到 “App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到个人记事本或备忘录中（注意数据安全，勿泄露），后续步骤中需要使用。

接下来需要为已经完成部署的OpenClaw配置模型和通道（即OpenClaw channel，如飞书）。

进入腾讯云控制台

进入腾讯云控制台，选中对应的已部署OpenClaw的Lighthouse服务器实例，点击服务器卡片进入“管理实例”页面。

进入应用管理

进入腾讯轻量云Lighthouse应用管理页的配置面板；

模型配置（必需步骤）

为OpenClaw配置模型API Key可以在Lighthouse服务器的应用管理页面进行操作。详情可参考云上OpenClaw(原Clawdbot)一键秒级部署指南-配置模型APIKey，此处不再赘述。

【实用技巧】验证模型配置是否生效

如果您担心模型配置未生效，可以登录轻量应用服务器并通过OpenClaw TUI工具进行验证。具体步骤可以参考教程“云上OpenClaw(原Clawdbot)一键秒级部署指南-使用TUI与OpenClaw进行交互”。

通道配置（配置飞书机器人App ID和App Secret）

进入“应用管理”页签，在“通道配置”输入框，选择“飞书”，输入前面步骤中查询到的飞书机器人的App ID和App Secret，并点击应用并确定执行操作，等待几十秒后页面提示“保存成功”即完成配置，确保你的飞书通道显示“使用中”。

提示：点击“应用”按钮完成通道配置之后，应用管理页面中仅展示“使用中”状态，并不会展示已配置的APP ID和App Secret。

飞书机器人相关配置

事件配置

在飞书应用管理页，左侧导航栏找到 “事件与回调” ，点击进入页面。在“事件配置”页签中选择 “长连接接收事件”，点击保存。

此时如果事件配置保存成功，可直接前往后续的“添加事件”步骤。

（可选）如果检查前面步骤中的机器人App ID和App Secret均已经正确配置，但点击保存后仍然报错“应用未建立长连接”，可以参考以下步骤来建立长连接：在轻量应用服务器应用管理页面，找到OpenClaw状态显示，点击“重启”按钮，重启网关服务，再返回飞书开放平台，点击保存事件配置，完成建立长连接。

添加事件

点击“事件配置”页面中的 “添加事件”，在弹出的列表中，搜索并添加 “接收消息”，点击 “确认添加”，按照指引确认开通权限。

（推荐）若您期望将飞书机器人添加进聊天群组中使用，可以参考前述步骤继续添加更多群组相关权限，主要包括“消息已读”、“机器人进群”、“机器人被移出群”。否则，请跳过本步骤。

完成添加后，可以在当前页面的列表中查看到已添加的事件。

回调配置

在“事件与回调-回调配置”页面中，订阅方式选择 “使用长连接接收回调”，点击保存，无需填写其他地址，配置自动生效。

权限配置

在飞书应用管理页，左侧导航栏找到 “权限管理” ，点击进入页面。点击页面中的 “批量导入权限” 按钮，弹出权限导入窗口。

复制以下代码，替换前面弹窗中原有的JSON内容，点击下一步，确认新增权限，继续申请开通，确认后等待权限导入完成。

{
  "scopes": {
    "tenant": [
      
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",

      
      "contact:user.base:readonly",
      "im:message.group_msg",
      "im:message:readonly",
      "im:message:update",
      "im:message:recall",
      "im:message.reactions:read",

   
      "docx:document:readonly",
      "drive:drive:readonly",
      "wiki:wiki:readonly",
      "bitable:app:readonly",
      "task:task:read",

      "contact:contact.base:readonly",
      "docx:document",
      "docx:document.block:convert",
      "drive:drive",
      "wiki:wiki",
      "bitable:app",
      "task:task:write"
    ],
    "user": []
  }}

权限导入完成后，可以在权限列表中查看已成功导入的权限。

提示：后续使用飞书机器人过程中也可以按需调整权限设置。

创建版本并发布

在飞书应用管理页，左侧导航栏找到 “版本管理与发布” ，点击进入页面。点击右上角的创建版本。

填写应用版本号（此处以1.0.0为例，您可以自行定义版本号）和更新说明，点击保存并确认发布。

待飞书管理员通过发布审核。审核发布成功后，可以在“版本管理与发布”页面，查看到已经发布的版本号和状态。

如果创建版本后，提示：企业管理员正在审核应用发布申请。请查看下方解决办法

情况1:您不是管理员

请在飞书内部联系您所属组织/公司的管理员进行审核；

情况2:您是管理员

请进入 飞书企业管理后台；

点击 工作台-应用审核，在右侧应用列表点击“审核”，进行审核操作；

进入审批页面，点击右上角“通过”即可；

如果您想后续免审发布机器人，可点击“设置审核规则”；

进入审核规则页面，开启默认规则即可开启“全员免审”（蓝色为开启状态）；

与飞书机器人进行交互

完成前面的步骤之后，您可以与飞书机器人进行单独聊天，或者将飞书机器人添加进群聊。

单独聊天

以电脑版飞书软件为例（手机端飞书的操作类似），登录飞书后，点击搜索框。

在搜索框中输入前面步骤中创建并发布的飞书机器人的应用名称，输入回车进行搜索。

单击搜索到的机器人，进入私聊页面，即可开始与已经接入OpenClaw的飞书机器人进行对话。

（如对话时未出现可直接跳过本步骤）首次对话会如果提示如下图所示的配对（Paring）请求，可以复制机器人回复的最后一行命令行。

接下来返回轻量应用服务器控制台，选中前面步骤中完成OpenClaw配置的服务器，点击登录，使用OrcaTerm终端免密登录服务器。在终端中粘贴上一步中复制的命令行，点击回车执行命令。命令完成执行后会提示配对成功。

接下来继续尝试与该机器人进行对话，如果机器人以AI的方式进行回复，即说明配对成功。

群聊添加飞书机器人

对于群组聊天的场景，可以点击飞书搜索框上方的加号，选择创建群组，并完成创建。

进入新创建的群组，点击右上角的设置。

在设置中选择“群机器人”，点击添加机器人。

在上方搜索框搜索您创建的机器人的应用名称。

选择您之前创建的机器人后，点击添加即可将飞书机器人加入群聊，示例如下所示。

到这里就初步完成了配置，在手机版飞书和电脑版飞书上均可以开始与已经接入OpenClaw的飞书机器人进行聊天。

注意：机器人只能被添加进同一企业下的群聊，外部群无法添加机器人。

支持的消息类型

基于前述步骤将OpenClaw接入飞书后，飞书机器人除了能够进行接收、回复基础的文本信息外，还支持更多消息类型，详情如下表所示：

飞书机器人可以接收图片、文件、音频、视频，示例如下：

提示：此处飞书仅作为发送/接收信息的通道，实际能否完成任务会受到模型能力限制。例如您需要为OpenClaw配置支持理解分析图片的模型，才能让OpenClaw通过飞书接收图片并且进行分析。

飞书机器人可以回复图片、文件、音频，示例如下：

提示：飞书仅作为发送/接收信息的通道，实际能否完成任务会受到模型能力限制。例如您需要为OpenClaw配置支持生成图片的模型，才能让OpenClaw生成图片并通过飞书发送图片。

飞书机器人可以主动发动消息（如定时发送提醒），示例如下：

提示：此处飞书仅作为发送/接收信息的通道，实际能否完成任务会受到模型能力限制。

文档工具：读取、创建、用 Markdown 写入飞书文档（表格因 API 限制不支持）。

知识库工具：浏览、列出空间、获取节点详情、搜索/创建/移动/重命名节点。

云盘工具：展示文件夹、获取文件信息、创建文件夹、移动/删除文件。

更多教程

更多云上OpenClaw实践教程，如一键部署OpenClaw、接入企微/钉钉/飞书/Discord/WhatsApp/Telegram、安装并使用OpenClaw Skills等，欢迎查看云上OpenClaw(原Clawdbot)最全实践教程合辑。

加入交流群

欢迎扫码加入OpenClaw交流群，和大家共同解锁、交流、探讨OpenClaw的各类实用、有趣玩法。

有奖征文

🦞 有奖征文 | OpenClaw 云端创意实践赛火热进行中！🔥

🤖接进聊天工具？ 🧠 变成情绪助理 / 工作分身？ 🎮 搞个离谱但好玩的自动化工具？

只要是基于Lighthouse的OpenClaw创意场景，都能投稿！

🏆马歇尔黑金音响、庆余年联名键盘、王者荣耀耳机...... 超丰厚奖池等你来赢！提交符合要求的参赛文章，即可获得保底奖品腾讯定制萌鹅便利贴2件套

👉2026.1.26 腾讯云OpenClaw发布后，所有基于腾讯云Lighthouse的OpenClaw场景玩法类文章或教程，均可添加本次比赛指定标签参与投稿。

活动详情速戳：https://cloud.tencent.com/developer/article/2627198