OpenClaw 接入飞书机器人完整教程｜腾讯云 Lighthouse 一键部署

前置准备工作

1. 您已拥有正常使用的飞书账号。
2. 已在腾讯云轻量应用服务器 Lighthouse 中完成 OpenClaw 部署：
   • 新购服务器：可前往腾讯云 Lighthouse 购买页，或 OpenClaw 专属优惠活动页面选购，详细流程参考《云上 OpenClaw（原 Clawdbot）一键秒级部署指南》。
   • 版本更新：若您的 OpenClaw 应用模板创建时间早于 2026 年 2 月 11 日，请先更新版本，参考《如何更新服务器 OpenClaw 应用版本》。
3. OpenClaw 接入飞书推荐使用国内服务器 + 国内模型服务，保证响应速度与稳定性。

一、创建飞书企业自建应用

1. 使用飞书账号登录飞书开放平台。
2. 点击创建企业自建应用。
3. 填写应用名称（如 OpenClaw 助手）、应用描述、上传图标，点击创建。
4. 进入应用管理页面。

二、为应用添加机器人能力

1. 在飞书应用管理页面左侧导航，点击添加应用能力。
2. 选择机器人 → 点击添加。
3. 添加完成后暂不发布，等待全部配置完成后统一发布。

三、获取 AppID 与 AppSecret

1. 左侧导航进入凭据与基础信息。
2. 复制以下两个关键参数并妥善保存：
   • App ID
   • App Secret
3. 后续将用于 OpenClaw 通道对接。

四、为 OpenClaw 配置飞书机器人通道

1. 进入服务器管理后台

1. 登录腾讯云控制台。
2. 进入已部署 OpenClaw 的 Lighthouse 实例。
3. 打开应用管理页面。

2. 模型配置

3. 飞书通道配置

1. 在通道配置中选择飞书。
2. 填入飞书应用的：
   • App ID
   • App Secret
3. 点击添加并应用 → 确认。
4. 等待提示保存成功，状态显示使用中即完成。

OpenClaw 支持多通道同时运行：QQ、企业微信、飞书可一起接入。

五、飞书机器人后台完整配置

1. 事件配置

1. 进入飞书开放平台 → 事件与回调。
2. 选择长连接接收事件 → 点击保存。

• 检查 AppID、AppSecret 是否正确填写
• 进入 Lighthouse 应用管理 → 重启 OpenClaw 网关
• 重新保存事件配置

2. 添加事件

• 接收消息

  （可选）群聊场景建议添加：

• 消息已读
• 机器人进群
• 机器人被移出群

3. 回调配置

1. 进入事件与回调 → 回调配置。
2. 订阅方式选择：使用长连接接收回调。
3. 点击保存，无需填写地址。

六、批量导入飞书机器人权限

1. 进入权限管理。
2. 点击批量导入权限。
3. 替换为以下 JSON 配置，点击下一步并确认开通：

json

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

七、创建版本并发布应用

1. 进入版本管理与发布。
2. 点击右上角创建版本。
3. 填写版本号（如 1.0.0）和更新说明。
4. 保存并提交发布。
5. 等待飞书管理员审核通过。

八、与飞书机器人开始对话

1. 单独聊天

1. 打开飞书客户端。
2. 搜索机器人名称。
3. 进入聊天窗口，直接对话。

• 复制机器人返回的命令
• 使用 OrcaTerm 免密登录 Lighthouse 服务器
• 粘贴命令并执行
• 提示配对成功即可正常使用

2. 群聊添加机器人

1. 进入群组 → 设置 → 群机器人。
2. 点击添加机器人。
3. 搜索并选择已创建的 OpenClaw 机器人。
4. 添加完成即可在群内 @AI 机器人对话。

九、OpenClaw + 飞书机器人支持消息类型

十、高级工具能力（OpenClaw 专属）

• 文档工具：读取、创建、写入飞书文档（Markdown 支持）
• 知识库工具：浏览 Wiki、搜索 / 创建 / 移动 / 重命名节点
• 云空间工具：展示文件夹、获取文件信息、移动 / 删除文件

飞书仅为消息通道，图片理解、文件解析等能力需配置对应多模态模型。

常见问题解决

1. 提示 “应用未建立长连接”
   • 检查 AppID、AppSecret 是否正确
   • 重启 OpenClaw 网关服务
2. 机器人不回复
   • 确认应用已发布
   • 确认事件与权限已配置
   • 检查模型 API Key 是否有效
3. 无法加入群聊
   • 仅支持同一企业内部群
   • 检查是否已开通群聊相关事件