跳轉到內容
最近更新

OpenClaw 飛書 / Lark 接入指南

當你需要把 OpenClaw 放進飛書或 Lark 團隊環境時，這份指南就是更合適的起點。和 Telegram 相比，飛書路徑更依賴應用權限、插件兼容性和連接模式，因此更適合組織內部工作流，而不是隨手驗證。

為什麼飛書 / Lark 的接入方式不同

  • 你需要的是企業自建應用，而不僅是一個機器人 token
  • 權限、事件訂閱和連接模式與運行時設定同樣重要
  • 一般建議先用 WebSocket 模式跑通，再考慮 Webhook 模式

Step 1：創建企業自建應用

  • 在 Open Platform 創建應用並拿到 App ID / App Secret
  • 開啟消息事件、機器人能力等必要權限

Step 2：安裝飛書插件

Command
openclaw plugins install @m1heng-clawd/feishu

Step 3：設定 WebSocket 模式

Command
openclaw config set channels.feishu.appId "YOUR_APP_ID"openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocket

Step 4：重啟 gateway

Command
openclaw gateway restart

Step 5：在聊天裡驗證

  • 把機器人加入群聊或私聊
  • 發送 @機器人 現在幾點？

常見飛書 / Lark 問題

  • 個人賬號限制 -> 優先使用企業管理員賬號
  • 插件不兼容 -> 更新 OpenClaw 或手動安裝插件
  • 收不到事件 -> 檢查權限、密鑰與 WebSocket 連接狀態
  • 運行時或中繼問題 -> 對照 /docs/troubleshooting 和 /docs/advanced-config

Webhook 模式（需要公網 HTTPS）

如果你需要事件訂閱 Webhook 模式，請繼續查看 /docs/feishu-webhook-tunnel。

相關鏈接