跳转到主要内容
将飞书 (Feishu) 或 Lark 连接到您的 Claw 实例。使用 WebSocket 模式 —— 无需公网回调 URL。

​
前提条件

​
配置指南

1

创建飞书应用

  1. 前往 飞书开放平台（或 Lark Developer）
  2. 点击 创建企业自建应用
  3. 输入应用名称和描述
  4. 点击 确定创建
2

添加机器人能力

  1. 在应用设置中，前往 添加应用能力 → 机器人
  2. 启用机器人能力
  3. 这允许您的应用接收和发送消息
3

获取凭据

  1. 前往 凭据与基础信息
  2. 复制 App ID（以 cli_ 开头）
  3. 复制 App Secret
4

配置事件订阅

  1. 前往 事件订阅
  2. 选择 WebSocket 模式（推荐 —— 无需公网 URL）
  3. 如果有提示，设置 Encrypt Key 和 Verification Token
当您在 LemonData 控制台中配置飞书时，Encrypt Key 和 Verification Token 会为您自动生成。将这些值复制到飞书开发者后台。
5

添加事件权限

  1. 在事件订阅下，添加以下事件：
    • im.message.receive_v1 —— 接收消息
  2. 前往 权限管理 并添加：
    • im:message —— 发送和接收消息
    • im:message.group_at_msg —— 接收群组 @消息
  3. 点击 保存
6

发布应用

  1. 前往 版本管理与发布 → 版本管理
  2. 创建新版本
  3. 提交审核（对于企业自建应用，通常是即时的）
  4. 审核通过后，应用即可上线
7

在 LemonData 控制台中配置

  1. 前往您的 Claw Dashboard
  2. 点击实例上的 设置图标
  3. 打开 IM Integrations 选项卡
  4. 展开 Feishu 部分
  5. 粘贴您的 App ID 和 App Secret
  6. 将自动生成的 Encrypt Key 和 Verification Token 复制回飞书开发者后台
  7. 点击 Save
8

开始聊天

  1. 在飞书中按名称搜索您的机器人
  2. 向它发送消息
  3. 第一个用户将 自动配对 为所有者 —— 无需代码！
  4. 开始与 AI 聊天！

​
群组设置

在控制台的 IM Integrations 选项卡中配置群聊行为：
设置选项描述
Group Policy开启 (默认) / 白名单 / 已禁用控制谁可以在群组中触发机器人
Require @mention开启 / 关闭机器人仅在被 @提及 时响应
Group IDs群聊 ID 列表限制在特定群组（为空 = 所有群组）
Group Allowed UsersOpen ID 列表仅这些用户可以触发机器人（白名单模式）

​
故障排除

  • 验证应用已发布并已审核通过
  • 检查是否已订阅 im.message.receive_v1 事件
  • 确保已选择 WebSocket 模式（而非 HTTP）
  • 验证飞书后台和 Claw 配置之间的 Encrypt Key 和 Verification Token 是否一致
  • 这通常意味着 App ID 或 App Secret 不正确
  • 请仔细检查控制台中的凭据