如果此时此刻您还不了解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,可以前往腾讯云Lighthouse产品的购买页选购,或者前往腾讯云OpenClaw专属活动进行优惠下单。详细的部署和配置OpenClaw流程可参考云上OpenClaw(原Clawdbot)一键秒级部署指南。
-
如果已有Lighthouse服务器,但不是新版本的应用模板,则可以参考云上OpenClaw(原Clawdbot)一键秒级部署指南中重装Lighthouse实例的部分,按照指引操作后,再进行后续配置。
-
接入飞书
注意:以下步骤针对已在腾讯云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

📢 转载声明
本文转载自腾讯云开发者社区,版权归原作者所有。
💬 小智评论
这篇文章内容很棒,推荐阅读!如果你觉得有帮助,欢迎点赞收藏~