# 腾讯云 OpenClaw（Clawdbot）集成飞书教程 By [BlockBoy](https://paragraph.com/@blockboy), 2026-02-05 openclaw, 飞书 --- 前置准备工作 ====== 在正式开始为OpenClaw(Clawdbot)配置接入飞书机器人之前，请您依次检查如下事项是否准备完成： * 您已经拥有一个飞书账号。 * 是否已经在**Lighthouse服务器实例**部署且配置好了OpenClaw，且**为2026.1.30或更高版本**。如果暂时还没有，建议： * 如果您希望新购一台[**Lighthouse**](https://curl.qcloud.com/1rYcutiv)服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的[**购买页**](https://curl.qcloud.com/1rYcutiv)选购，或者前往腾讯云[**OpenClaw专属活动**](https://curl.qcloud.com/1rYcutiv)进行优惠下单。 * 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新：[**如何更新服务器OpenClaw应用版本**](https://cloud.tencent.com/developer/article/2627964)。 接入飞书 ==== 注意：以下步骤针对已在腾讯云Lighthouse服务器中部署OpenClaw，从零开始配置接入飞书的情况，如果有部分步骤已完成，可酌情跳过。 **创建飞书企业自建应用** -------------- 首先，您需要使用您的飞书账号登录[**飞书开放平台**](https://cloud.tencent.com/developer/tools/blog-entry?target=https%3A%2F%2Fopen.feishu.cn%2Fapp%3Flang%3Dzh-CN&objectId=2626151&objectType=1&contentType=rich)。登录成功后，点击**创建企业自建应用**。 ![](https://storage.googleapis.com/papyrus_images/c9b08b36ca1895200b25dfbace98dddd29b451135647414eb2fc0a0d47a54bf4.png) 填写**应用名称**（如 “OpenClaw助手”）、**应用描述**，选择**应用图标**，点击**创建**按钮，进入应用管理页面。 ![](https://storage.googleapis.com/papyrus_images/4ce801b5cccf8f024af203dd226398d87945a7adc87f553423c24f166e9f00d6.png) **添加机器人** --------- 在前一步所创建应用的管理页面，左侧导航栏中找到并点击**添加应用能力**，在弹出的列表中选择**机器人**，点击**添加**。 ![](https://storage.googleapis.com/papyrus_images/26e3cdb99945f14c16f85286008e1f6e762287cd9e76f230f5d5acb2e664c2d2.png) > **“**提示：添加机器人之后，可以暂不发布，待其他配置完成后一并发布。 **查询AppID和AppSecret** --------------------- 在左侧导航栏找到 “凭据与基础信息” ，点击进入。在页面中找到 “App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到个人记事本或备忘录中（注意数据安全，勿泄露），后续步骤中需要使用。 ![](https://storage.googleapis.com/papyrus_images/42001d503fed64878d7e1a499199ddfc7869c21f128a3b066eeccaadd044c84a.png) **为OpenClaw配置模型和Channel** ------------------------- 接下来需要为已经完成部署的OpenClaw配置模型和Channel（如飞书）。 进入腾讯云[**控制台**](https://console.cloud.tencent.com/lighthouse)，选中对应的已部署OpenClaw的Lighthouse服务器，点击服务器卡片进入“管理实例”页面。 ![](https://storage.googleapis.com/papyrus_images/846c997526a30b4724dfac0ff5c2a631350c4670aaa845df57d832a12e69ed48.png) **模型配置** 为OpenClaw配置模型API Key可以在Lighthouse服务器的应用管理页面进行操作。详情可参考[**云上OpenClaw(原Clawdbot)一键秒级部署指南**](https://cloud.tencent.com/developer/article/2624003)\-配置模型APIKey，此处不再赘述。 **Channel配置（配置飞书机器人App ID和App Secret）** 进入“应用管理”页签，在“Channel配置”输入框，选择“飞书”，输入前面步骤中查询到的飞书机器人的App ID和App Secret，并点击**应用**并确定执行操作，等待几十秒后页面提示“保存成功”即完成配置,确保你的飞书channel显示“使用中”。 提示：OpenClaw支持同一台服务器配置多个Channel，例如支持同时接入QQ机器人和飞书机器人。因此，如果当前正在配置的服务器之前已经接入了其他Channel，也可以继续添加Channel。 ![](https://storage.googleapis.com/papyrus_images/533803de3784aa92ae96d5858bd72138491b1660d385bc9003c2fd5d03c34e44.png) > **“**提示：点击“应用”按钮完成Channel配置之后，此处的应用管理页面中并不会展示已配置的APP ID和App Secret。 **飞书机器人相关配置** ------------- ### **事件配置** 在飞书应用管理页，左侧导航栏找到 “事件与回调” ，点击进入页面。在“事件配置”页签中选择 “长连接接收事件”，点击**保存**。 ⚠注意：如果这一步报错提示“未建立长连接”，请检查自己的App ID和App Secret是否已正确配置。 如果App ID和App Secret均正确配置但仍报错，请按以下步骤建立长连接： 登录服务器 ![](https://storage.googleapis.com/papyrus_images/5939aa4b8824f75650b648eaa58d2983665a9cadc812162039f81789a2dd8c99.png) 运行停止网关的命令 openclaw gateway stop ![](https://storage.googleapis.com/papyrus_images/abfb056501289c43caa903f29f7e5260beb31457dccf03b23274e7430efd85df.png) 再运行启动网关的命令，即可建立长连接。（返回飞书开发者后台保存事件配置即可） openclaw gateway --port 18789 --verbose --token 123 ![](https://storage.googleapis.com/papyrus_images/af2adc597aa06ddcbc5fe0bf8a64df6343ed27dc8b85b6d086c254c4ef0a4e6d.png) 点击该页面中的 “添加事件”，在弹出的列表中，勾选 “接收消息”、“消息已读”、“机器人进群”、“机器人被移出群”，点击 “确认添加”，按照指引确认开通权限。 ![](https://storage.googleapis.com/papyrus_images/9e9786503066e46a9f4a181e717ecb144f6f77bfbd9a01bd7700b921dc05510e.png) 完成事件配置后，可以在当前页面中查看到已添加事件。 ### **回调配置** 在“事件与回调-回调配置”页面中，订阅方式选择 “使用长连接”，点击**保存**，无需填写其他地址，配置自动生效。 ![](https://storage.googleapis.com/papyrus_images/52a7fb55e23d951ee5d626328fce5d542f65838814db43f76ebcff1b493fe606.png) ### **权限配置** 在飞书应用管理页，左侧导航栏找到 “权限管理” ，点击进入页面。点击页面中的 “批量导入权限” 按钮，弹出权限导入窗口。 ![](https://storage.googleapis.com/papyrus_images/b1c9ce3e37f65aa9ba1a50a53676a9c700c9c07f8e92fac3193a04f246734d56.png) ![](https://storage.googleapis.com/papyrus_images/cad4b08b4ff038ce23e0d163b85dc52d4b33585c7f70a7865dbe07cd5029bd43.png) 复制以下代码，替换前面弹窗中原有的JSON内容，点击**下一步，确认新增权限**，继续**申请开通**，确认后等待权限导入完成。 更新权限列表，请复制下方最新代码重新添加权限 { "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": [] } } 权限列表中出现以下已导入的权限，即为配置完成。 ![](https://storage.googleapis.com/papyrus_images/49b7a70f54ea23f5710da429ed62fabff1e73ee914e9b2261de4136bed5e37a9.png) ![](https://storage.googleapis.com/papyrus_images/1f053e7b2c4747ac4d0be6df49e7a1ec1f466a85224a263754a168dce61e3acb.png) **创建版本并发布** ----------- 在飞书应用管理页，左侧导航栏找到 “版本管理与发布” ，点击进入页面。点击右上角的**创建版本**。 ![](https://storage.googleapis.com/papyrus_images/ada781a426cea0478f51831c8fbfc5bfc1d30f6be2489215013a4fb90643e4da.png) 填写**应用版本号**（此处以1.0.0为例，您可以自行定义版本号）和**更新说明**，点击**保存**并确认发布。 ![](https://storage.googleapis.com/papyrus_images/5e2d5104c8aad25c9e979e6acaa36d55cf26d95753d5d61aebee487d17328a84.png) 发布成功后，可以在“版本管理与发布”页面，查看到已经发布的版本号和状态。 ![](https://storage.googleapis.com/papyrus_images/246b78f8d825191da8bdcd9b3dff36f6bacc2c8e65e15d83aa52f6a86eef29a6.png) **如何将机器人添加进飞书群聊/私聊** -------------------- 以电脑版飞书软件为例（手机端飞书的操作类似），登录飞书后，点击搜索框。 ![](https://storage.googleapis.com/papyrus_images/308f49e5d3b68579fb849268bf0cc0aaffdb59e3b02e7ccead024fb019f7c190.png) 在搜索框中输入前面步骤中创建并发布的飞书机器人的应用名称，输入回车进行搜索。 ![](https://storage.googleapis.com/papyrus_images/3774b9c5d90f83cd0a2f2355b237369d2d4d8fa79923977f9bb1048edecc49d1.png) ![](https://storage.googleapis.com/papyrus_images/7385380ed47cbd15015dd745bfab2897578048ab56ece42efbf3ba513b5c190c.png) 单击搜索到的机器人，进入私聊页面，即可开始与已经接入OpenClaw的飞书机器人进行对话。 ![](https://storage.googleapis.com/papyrus_images/97e369f169f68568f9417f034c5d26fd246ad1f815488c81003ad9a583a17843.png) 对于群组聊天的场景，可以点击飞书搜索框上方的加号，选择**创建群组**，并完成创建。 ![](https://storage.googleapis.com/papyrus_images/ac1f251eae0b718957c0e50c2b8ce00ccf706eb61a54e6bd468483b0f4969c62.jpg) ![](https://storage.googleapis.com/papyrus_images/4ac6f10556ba9775f97fcb8663c4d062c44c72b9dde5d6648a3349e90cb6413b.png) 进入新创建的群组，点击右上角的**设置**。 ![](https://storage.googleapis.com/papyrus_images/abac06da79ed5cbe3e0ebc51f8bbb458cba048de33655f56f58b4ea248e58b73.png) 在设置中选择“群机器人”，点击“添加机器人”。 ![](https://storage.googleapis.com/papyrus_images/0a855c33a1af61e64f5cda0e2e60bb8dce43ab770c812e98f8d2824bd8518b05.png) 在上方搜索框搜索您创建的机器人的应用名称。 ![](https://storage.googleapis.com/papyrus_images/427b3ee4e1d183897c6ac5c2ba200e210f613e6b88ede800956b8890f2a7a648.png) 选择您之前创建的机器人后，点击**添加**即可将飞书机器人加入群聊，示例如下所示。 ![](https://storage.googleapis.com/papyrus_images/170408d344ffd103473f36200ac982491c44371437431474bfd4f8e5fc1f6392.png) 到这里就初步完成了配置，在手机版飞书和电脑版飞书上均可以开始与已经接入OpenClaw的飞书机器人进行聊天。 ![](https://storage.googleapis.com/papyrus_images/f4aa8bb3d74ec9241b875a6bd895edb3e61e78c50c32ebbbe7450d34decfaaf1.png) **更多实用技巧** ---------- **入站媒体支持**：飞书机器人可以看到图片（受模型限制，建议选取支持读取图片的多模态大模型）、读取文件（PDF、Excel 等）、处理富文本中的嵌入图片。 ![](https://storage.googleapis.com/papyrus_images/49b0674dbcb3483ed0a7900093a6eee49904f1ea5660b9f4d5879d1b65886f01.png) **图片和文件上传**（出站）： ![](https://storage.googleapis.com/papyrus_images/de0da3cfe82aded55bfdf16c1b9ae35c54ba49cc328afd97be703962ab8296e8.png) **文档工具**：读取、创建、用 Markdown 写入飞书文档（表格因 API 限制不支持）。 ![](https://storage.googleapis.com/papyrus_images/6d7c798bb237b95a94cbc942c93cb11d9070731f64db590c9170137207d2271c.png) **知识库工具**：浏览知识库、列出空间、获取节点详情、搜索、创建/移动/重命名节点。 ![](https://storage.googleapis.com/papyrus_images/d2b9e2bdc041ca00e2d5ff41f303c80ca1018db2ffdc809d726796b3c9a8fa29.png) **云空间工具**：展示文件夹、获取文件信息、创建文件夹、移动/删除文件。 ![](https://storage.googleapis.com/papyrus_images/16a0e4a8fea25e435f4e95ad7dc1552335d3222a92e315dcdc05f20ed69a9077.png) --- *Originally published on [BlockBoy](https://paragraph.com/@blockboy/%E8%85%BE%E8%AE%AF%E4%BA%91openclawclawdbot%E9%9B%86%E6%88%90%E9%A3%9E%E4%B9%A6%E6%95%99%E7%A8%8B-1)*