飛書/Lark 接入 - Elastic Desktop Service

本文介紹如何通過飛書或 Lark 接入 Agent。飛書提供極速配對（掃碼即用，無需建應用）和關聯已有機器人兩種方式；Lark 僅支援關聯已有機器人。

前提條件

已在 AI 管理中心建立 Agent。

通道配置

前往AI 管理中心。
在左側導覽列，選擇您的 Agent 類型，例如 JVS Computer。
單擊通道配置。
單擊目標 Agent 操作列中的查看/配置通道。
在飛書卡片上，單擊立即配置。
說明
- 對於中國大陸以外地區的 OpenClaw 和 JVS Computer，飛書卡片會顯示為飛書/Lark。您可以在通道類型下拉式功能表中選擇飛書或 Lark。
- 對於中國大陸地區和其他 Agent 類型，僅支援飛書。

飛書

選擇以下任一方式完成飛書機器人接入：

極速配對

說明

極速配對不支援 OpenClaw 類型 Agent，請改用關聯已有機器人方式。
要求雲電腦鏡像版本滿足：Linux 3.0.10 及以上。如需更新，可重啟雲電腦。

單擊立即發送。系統會向授權使用者下發包含訪問連結的簡訊或郵件。
授權使用者通過簡訊或郵件中的 URL 訪問綁定頁面擷取二維碼（您也可在控制台直接擷取該 URL）。
使用飛書掃描二維碼，完成機器人綁定。

說明

如已綁定其他機器人，掃碼後將被替換。

關聯已有機器人

說明

本方式要求您所在的飛書企業已具備開發人員許可權。如所在企業暫無該許可權，請聯絡企業管理員開通。

建立飛書應用

訪問飛書開放平台，點擊右上方開發人員後台。
點擊建立企業自建應用，填寫必要資訊。
在應用的憑證與基礎資訊頁面，複製App ID（格式如cli_xxx）和App Secret。

配置應用許可權

在飛書開放平台的應用詳情頁，單擊許可權管理 > 開通許可權，然後單擊大量匯入/匯出許可權。

粘貼以下 JSON 配置一鍵匯入要求的權限，單擊下一步，確認新增許可權。

{
  "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:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在彈窗中確認許可權無誤後，單擊申請開通完成操作。

配置事件並發布機器人

在應用能力 > 機器人頁面開啟機器人能力，並配置機器人名稱。
在事件與回調頁面，單擊事件配置 > 訂閱者式，選擇使用長串連接收事件並儲存。
單擊添加事件，添加接收訊息（im.message.receive_v1）。
前往版本管理與發布 > 建立版本，填寫必要資訊後單擊儲存。

填寫憑證完成關聯

回到無影雲電腦控制台 AI 管理中心。輸入飛書應用的 App ID 和 App Secret，然後單擊確認。

配對授權

在飛書中找到已綁定的機器人，向其發送任意一條訊息觸發配對。

機器人會回複一條訊息，其中包含 Feishu user ID 和 Pairing code（配對碼），並提示使用命令 openclaw pairing approve feishu <配對碼> 完成審批。請記錄該配對碼，用於後續審批。
開啟雲電腦終端，執行以下命令批准本次配對：openclaw pairing approve feishu <配對碼>。
執行以下命令重啟 OpenClaw 服務，使配對授權生效：openclaw gateway restart。

服務重啟後，即可在飛書中與機器人正常對話，由 Agent 完成相關任務。

Lark

說明

Lark 通道僅適用於中國大陸以外地區的 OpenClaw 和 JVS Computer。
本方式要求您所在的 Lark 組織已具備開發人員許可權。如所在組織暫無該許可權，請聯絡組織管理員開通。

建立 Lark 應用

訪問Lark 開放平台，點擊右上方開發人員後台。
點擊建立企業自建應用，填寫必要資訊。
在應用的憑證與基礎資訊頁面，複製App ID（格式如cli_xxx）和App Secret。

配置應用許可權

在 Lark 開放平台的應用詳情頁，單擊許可權管理 > 開通許可權，然後單擊大量匯入/匯出許可權。

粘貼以下 JSON 配置一鍵匯入要求的權限，單擊下一步，確認新增許可權。

{
  "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:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在彈窗中確認許可權無誤後，單擊申請開通完成操作。

配置事件並發布機器人

在應用能力 > 機器人頁面開啟機器人能力，並配置機器人名稱。
在事件與回調頁面，單擊事件配置 > 訂閱者式，選擇使用長串連接收事件並儲存。
單擊添加事件，添加接收訊息（im.message.receive_v1）。
前往版本管理與發布 > 建立版本，填寫必要資訊後單擊儲存。

填寫憑證完成關聯

回到無影雲電腦控制台 AI 管理中心。輸入 Lark 應用的 App ID 和 App Secret，然後單擊確認。

配對授權

在 Lark 中找到已綁定的機器人，向其發送任意一條訊息觸發配對。

機器人會回複一條訊息，其中包含 Lark user ID 和 Pairing code（配對碼），並提示使用命令 openclaw pairing approve lark <配對碼> 完成審批。請記錄該配對碼，用於後續審批。
開啟雲電腦終端，執行以下命令批准本次配對：openclaw pairing approve lark <配對碼>。
執行以下命令重啟 OpenClaw 服務，使配對授權生效：openclaw gateway restart。

服務重啟後，即可在 Lark 中與機器人正常對話，由 Agent 完成相關任務。