飞书

目标

  • 创建/配置飞书应用或机器人
  • 获取 App ID / App Secret，并完成权限配置
  • 完成事件订阅配置（WebSocket 长连接）

前置说明

  • OpenClaw 的飞书渠道通过 WebSocket 事件订阅接收消息，因此通常不需要暴露公网 webhook URL。
  • App Secret 属于敏感信息，请使用密钥管理工具或安全的环境变量注入方式保存与使用。

第 1 步：创建飞书应用（开放平台）

  1. 打开飞书开放平台并登录

    截图占位：开放平台首页 / 控制台入口

  2. 创建应用

    • 选择 Create enterprise app（创建企业自建应用）
    • 填写应用名称与描述
    • 选择应用图标

    截图占位：创建应用表单（名称/描述/图标）

第 2 步：复制凭证（App ID / App Secret）

在应用的 Credentials & Basic Info（凭证与基础信息）中复制：

  • App ID（常见格式：cli_xxx）
  • App Secret

截图占位：Credentials & Basic Info 页面（App ID / App Secret 位置）

第 3 步：配置权限（Permissions）

进入 Permissions（权限管理），使用 Batch import（批量导入）导入所需权限范围。

将以下内容粘贴到批量导入输入框中并提交：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

截图占位：Permissions 页面（Batch import 按钮与导入结果）

第 4 步：启用机器人能力（Bot）

在 App Capability > Bot 中：

  • 启用机器人能力
  • 设置机器人名称

截图占位：Bot 能力开关与机器人名称设置

第 5 步：配置事件订阅（WebSocket 长连接）

在 Event Subscription 中：

  • 选择 Use long connection to receive events（WebSocket）
  • 添加事件：im.message.receive_v1

截图占位：Event Subscription 页面（长连接选项与事件列表）

第 6 步：发布应用

在 Version Management & Release 中创建版本并发布：

  • 创建版本
  • 提交审核并发布
  • 等待管理员批准（企业应用场景可能自动批准，具体以企业策略为准）

截图占位：Version Management & Release 页面（创建版本/发布流程）

常见问题与补充

  • Lark（国际版）域名：租户位于国际版时，需要在飞书渠道配置中设置 domain: "lark"（或按账户配置 domain）。
  • Webhook 模式：只有在明确需要 webhook 时才使用；该模式通常还需要 Verification Token 与 Encrypt Key，并额外配置 webhookHost 等参数。

results matching ""

    No results matching ""