前置准备工作

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

您已经拥有一个飞书账号。
是否已经在 Lighthouse服务器实例 部署且配置好了OpenClaw，且 为2026.1.30或更高版本 。如果暂时还没有，建议：
- 如果您希望新购一台 Lighthouse 服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的 购买页 选购，或者前往腾讯云 OpenClaw专属活动 进行优惠下单。
- 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新： 如何更新服务器OpenClaw应用版本 。

接入飞书

注意：以下步骤针对已在腾讯云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是否已正确配置。

如果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": []
  }
}

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