為什麼選擇飛書？
飛書，國際上稱為 Lark，是字節跳動的企業協作平台——在中國科技公司、新創企業中廣泛使用，在東南亞也越來越普及。隨著 OpenClaw v2026.2.2 的發布，飛書成為該平台第一個官方支援的中國聊天用戶端。
- •不需要公開 URL——不需要 ngrok、不需要網域、不需要 webhook 伺服器
- •可在防火牆後運作——連線是從你的機器向外發起的
- •低延遲——即時雙向訊息傳遞
- •豐富的內容支援——文字、圖片、檔案、音訊、影片和貼圖
前置條件
- •OpenClaw v2026.2.2 或更新版本
- •一個飛書/Lark 企業帳號（免費版即可）
- •在飛書開放平台建立應用程式的管理員權限
步驟一：建立飛書應用程式
- 1.前往飛書開放平台（或國際租戶使用 Lark Developer Console）
- 2.點擊建立自建應用
- 3.設定應用名稱（例如「OpenClaw Agent」）和描述
- 4.上傳圖示（OpenClaw 龍蝦 logo 很適合）
- 5.從憑證頁面複製 App ID（格式：
cli_xxx）和 App Secret
步驟二：設定應用程式權限
在你的應用程式權限設定中，啟用以下範圍：
| 權限 | 用途 |
|---|---|
im:message | 傳送和接收訊息 |
im:message.group_at_msg | 接收群聊中的 @提及 |
im:resource | 存取圖片和檔案 |
contact:user.id:readonly | 識別使用者 |
新增權限後，點擊發布以提交審核。在大多數企業租戶中，自建應用會自動通過審核。
步驟三：啟用事件訂閱
- 1.在應用設定中，前往事件訂閱
- 2.選擇 WebSocket 模式（長連線）——這很關鍵。不要使用 webhook 模式，因為它需要公開 URL。
- 3.訂閱以下事件：
步驟四：設定 OpenClaw
將飛書憑證新增到你的 OpenClaw 配置中。編輯 ~/.openclaw/.env：
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
或者使用 OpenClaw 設定檔（~/.openclaw/config.yaml）：
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
重啟 OpenClaw：
openclaw restart
你應該會看到一條日誌訊息，確認飛書 WebSocket 連線已建立。
步驟五：測試連線
開啟飛書，在聊天列表中找到你的應用（搜尋你在步驟一設定的應用名稱）。發送一則訊息：
> Hello!
- •文字訊息
- •圖片（如果使用支援視覺功能的模型，代理可以分析它們）
- •檔案（代理可以讀取文件）
- •語音訊息（轉錄後作為文字處理）
群聊配置
OpenClaw 支援飛書群聊，提供三種存取模式：
| 模式 | 行為 |
|---|---|
open（預設） | 任何群組成員在 @提及時都可以觸發機器人 |
allowlist | 即使有 @提及，也只有核准的使用者可以互動 |
disabled | 完全忽略群組訊息 |
在 config.yaml 中配置：
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
在群聊中，代理只在被 @提及時回應，避免在繁忙的頻道中造成干擾。
串流回應
OpenClaw 支援在飛書中使用互動卡片串流 AI 回應。代理不會等待完整回應才發送，而是先發送一個初始卡片，然後在 AI 生成文字時即時更新。對於長回應，這提供了更好的使用者體驗。
串流預設啟用。要停用它：
channels:
feishu:
streaming: false
支援的訊息類型
| 方向 | 支援的類型 |
|---|---|
| 傳入（使用者 → 代理） | 文字、富文字（post）、圖片、檔案、音訊、影片、貼圖 |
| 傳出（代理 → 使用者） | 文字、圖片、檔案、音訊、互動卡片 |
疑難排解
「找不到應用」錯誤：確認應用已在你的飛書租戶中發布並通過審核。企業租戶中的自建應用通常會自動審核通過，但某些組織需要管理員核准。
代理沒有回應：檢查 OpenClaw 日誌（openclaw logs）是否有 WebSocket 連線錯誤。驗證 App ID 和 App Secret 是否正確。
群聊中收不到訊息：確認機器人已被加入群組，使用者正確地 @提及了機器人。檢查 groupAccess 設定。
連線中斷：WebSocket 連線會自動重連。如果頻繁斷線，請檢查你的網路穩定性或防火牆設定。
使用社群橋接器（替代方案）
如果你需要原生整合以外的功能，由 AlexAnys 維護的社群 feishu-openclaw 橋接器 提供了額外功能，如自訂訊息格式和進階群組管理。設定大約需要 5 分鐘，不需要公開伺服器。
完整文件請參閱官方飛書頻道指南。