小智资讯百科 OpenClaw 🔥玩转OpenClaw|云上OpenClaw(Clawdbot)快速接入飞书指南

🔥玩转OpenClaw|云上OpenClaw(Clawdbot)快速接入飞书指南

如果此时此刻您还不了解OpenClaw(Clawdbot),或是了解但还没有开始部署OpenClaw(Clawdbot),建议您先参考云上OpenClaw(原Clawdbot)一键秒级部署指南来完成OpenClaw接入飞书之前的部署操作。本文主要介绍如何在腾讯云轻量应用服务器中部署完成OpenClaw后,配置接入飞书机器人。📢「重要」2026.2.3更新通知: Lighthouse服务器最新版OpenClaw镜像已更新飞书插件与配置面板!!! 当前已支持:入站媒体支持;图片和文件上传;读取、创建、用Markdown写入飞书文档;列出文件夹、获取文件信息、创建文件夹、移动/删除文件;在消息中@某人,机器人的回复会自动@该用户;权限错误提示;浏览wiki等实用功能。 如果您希望体验新版功能,可以重装系统更新至最新镜像“OpenClaw2026.1.30”!!! 新版需要开通额外飞书权限,详情见下文“权限配置”部分。

重装系统(更新镜像)指引

如果您无需保留轻量应用服务器中的原有数据和配置,可以通过重装系统的方式快速切换到新版。

首先进入轻量云Lighthouse产品控制台,找到自己账号下需要重装的OpenClaw实例,在实例页面内点击“…”或“更多”按钮,找到并点击重装系统

在重装系统的页面,选择“使用应用模板 > AI智能体 > OpenClaw(Clawdbot)”,登录凭证直接选择重装后设置

注意:重装系统会清空服务器内原有数据,因此在备份选项处,建议优先选择备份后重装,后续您可以使用快照回退至之前的服务器状态。

点击页面内的确定按钮,等待重装完成后,继续进行后续步骤即可。

前置准备工作

在正式开始为OpenClaw(Clawdbot)配置接入飞书机器人之前,请您依次检查如下事项是否准备完成:

  • 您已经拥有一个飞书账号。

  • 是否已经在轻量应用服务器Lighthouse服务器中完成了OpenClaw部署,且为2026.1.30及更高版本。如果暂时还没有,建议:

接入飞书

注意:以下步骤针对已在腾讯云Lighthouse服务器中部署OpenClaw,从零开始配置接入飞书的情况,如果有部分步骤已完成,可酌情跳过。

创建飞书企业自建应用

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

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

添加机器人

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

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

查询AppID和AppSecret

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

为OpenClaw配置模型和Channel

接下来需要为已经完成部署的OpenClaw配置模型和Channel(如飞书)。

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

模型配置

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

Channel配置(配置飞书机器人App ID和App Secret)

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

提示:OpenClaw支持同一台服务器配置多个Channel,例如支持同时接入QQ机器人和飞书机器人。因此,如果当前正在配置的服务器之前已经接入了其他Channel,也可以继续添加Channel。

提示:点击“应用”按钮完成Channel配置之后,此处的应用管理页面中并不会展示已配置的APP ID和App Secret。

飞书机器人相关配置

事件配置

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

⚠️注意:如果这一步报错提示“未建立长连接”,请检查自己的App ID和App Secret是否已正确配置。

点击该页面中的 “添加事件”,在弹出的列表中,勾选 “接收消息”、“消息已读”、“机器人进群”、“机器人被移出群”,点击 “确认添加”,按照指引确认开通权限。

完成事件配置后,可以在当前页面中查看到已添加事件。

回调配置

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

权限配置

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

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

2026.2.3更新权限列表,请复制下方最新代码重新添加权限

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:readonly",
      "drive:drive",
      "drive:drive:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:update",
      "im:resource",
      "wiki:wiki",
      "wiki:wiki:readonly"
    ],
    "user": []
  }
}

权限列表中出现以下已导入的权限,即为配置完成。

创建版本并发布

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

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

发布成功后,可以在“版本管理与发布”页面,查看到已经发布的版本号和状态。

如何将机器人添加进飞书群聊/私聊

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

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

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

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

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

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

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

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

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

更多实用技巧

入站媒体支持:飞书机器人可以看到图片(受模型限制,建议选取支持读取图片的多模态大模型)、读取文件(PDF、Excel 等)、处理富文本中的嵌入图片。

图片和文件上传(出站):

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

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

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

更多教程

更多云上OpenClaw实践教程,如一键部署以及接入企微、钉钉、飞书、Discord、WhatsApp、Telegram等,欢迎查看云上OpenClaw(原Clawdbot)最全实践教程合辑

加入交流群

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

有奖征文

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

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

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

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

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

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


📢 转载声明

本文转载自腾讯云开发者社区,版权归原作者所有。


💬 小智评论

这篇文章内容很棒,推荐阅读!如果你觉得有帮助,欢迎点赞收藏~

上一篇
下一篇

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

返回顶部