飛書（Feishu）

透過 WebSocket 事件訂閱整合 OpenClaw 與飛書（Lark），無需公開 webhook URL。

飛書外掛程式讓 OpenClaw 能透過 WebSocket 事件訂閱與飛書（Lark）整合，無需公開 webhook URL 即可實現機器人連線。

安裝

使用以下指令安裝飛書外掛程式：

openclaw plugins install @openclaw/feishu

飛書應用程式建立

1. 在飛書開放平台建立企業自建應用
2. 透過批次匯入設定權限
3. 啟用機器人功能
4. 建立事件訂閱，設定 im.message.receive_v1 事件

OpenClaw 設定

使用者可透過互動式精靈或直接編輯設定檔來設定憑證（App ID 和 Secret），也支援環境變數。

{
  channels: {
    feishu: {
      enabled: true,
      appId: "<APP_ID>",
      appSecret: "<APP_SECRET>",
    },
  },
}

存取控制

私訊

• 配對模式（預設）— 需要使用者核准新的傳送者
• 允許清單模式 — 將存取限制在核准的使用者
• 開放模式 — 允許任何傳送者

群組聊天

• 開放模式（預設）— 允許所有群組成員存取
• 允許清單模式 — 限制為核准的群組
• 停用模式 — 完全封鎖群組存取

提及要求

群組可設定為需要機器人提及才回應，或設定為自動回應。可依群組自訂提及需求。

進階功能

多帳號支援

系統支援同時運行多個帳號/機器人。

訊息串流

透過互動卡片實現訊息串流功能。

多代理路由

根據 peer 類型和 ID 進行多代理路由。

媒體上傳/下載

支援媒體上傳/下載，並可設定大小限制。

個別群組自訂

可依群組自訂提及要求和其他設定。

疑難排解

常見問題

• 無法接收訊息： 檢查事件訂閱設定和 im.message.receive_v1 事件是否已啟用
• 群組聊天無回應： 驗證群組策略設定和提及要求
• 密碼暴露： 確保 App Secret 透過環境變數安全儲存
• 傳送失敗： 檢查應用程式權限和網路連線狀態