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

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

• 是否已经在Lighthouse服务器实例部署且配置好了OpenClaw，且为2026.1.30或更高版本。如果暂时还没有，建议：

  • 如果您希望新购一台Lighthouse服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的购买页选购，或者前往腾讯云OpenClaw专属活动进行优惠下单。

  • 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新：如何更新服务器OpenClaw应用版本。

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

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

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

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

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

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

接下来需要为已经完成部署的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是否已正确配置。

如果App ID和App Secret均正确配置但仍报错，请按以下步骤建立长连接：

登录服务器

运行停止网关的命令

openclaw gateway stop

再运行启动网关的命令，即可建立长连接。（返回飞书开发者后台保存事件配置即可）

openclaw gateway --port 18789 --verbose --token 123

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

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

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

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

复制以下代码，替换前面弹窗中原有的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": []
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

图片和文件上传（出站）：

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

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

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

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

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

• 是否已经在Lighthouse服务器实例部署且配置好了OpenClaw，且为2026.1.30或更高版本。如果暂时还没有，建议：

  • 如果您希望新购一台Lighthouse服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的购买页选购，或者前往腾讯云OpenClaw专属活动进行优惠下单。

  • 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新：如何更新服务器OpenClaw应用版本。

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

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

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

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

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

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

接下来需要为已经完成部署的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是否已正确配置。

如果App ID和App Secret均正确配置但仍报错，请按以下步骤建立长连接：

登录服务器

运行停止网关的命令

openclaw gateway stop

再运行启动网关的命令，即可建立长连接。（返回飞书开发者后台保存事件配置即可）

openclaw gateway --port 18789 --verbose --token 123

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

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

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

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

复制以下代码，替换前面弹窗中原有的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": []
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

图片和文件上传（出站）：

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

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

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