OpenClaw Gateway 設定指南：高效管理 WhatsApp 連接

在開發機器人或處理多個連線時，最讓人頭痛的往往不是程式碼本身，而是複雜的網路架構。如果你也曾為了如何穩定管理 WhatsApp Session，或是如何在不同環境下安全地存取控制平面而感到困擾，理解網路模型的運作邏輯會讓你的開發流程順暢許多。

Network Model

內容已併入 Network。請參考該頁面取得最新指南。

大部分的操作都會經過 Gateway (openclaw gateway)，這是一個長期執行的單一程序，負責管理頻道連線和 WebSocket 控制平面。

核心規則

• 建議每個主機執行一個 Gateway。它是唯一被允許擁有 WhatsApp Web 會話的程序。如果是為了救援機器人或嚴格隔離的需求，可以執行多個具有獨立 Profile 和 Port 的 Gateway。參考 Multiple gateways。
• 優先使用 Loopback：Gateway WS 預設為 ws://127.0.0.1:18789。即使是 Loopback，設定精靈預設也會產生 Gateway Token。如果要透過 tailnet 存取，請執行 openclaw gateway --bind tailnet --token ...，因為非 Loopback 的綁定必須使用 Token。
• Node 會根據需求透過 LAN、tailnet 或 SSH 連線到 Gateway WS。舊有的 TCP bridge 已經棄用。
• Canvas host 由 Gateway HTTP 伺服器提供服務，並使用與 Gateway 相同的 Port（預設為 18789）：
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ 當 gateway.auth 設定完成且 Gateway 綁定在 Loopback 之外時，這些路由會受到 Gateway 認證保護。Node 客戶端會使用與其活動 WS 會話綁定的 Node 範圍 Capability URL。參考 Gateway configuration (canvasHost, gateway)。
• 遠端使用通常透過 SSH 隧道或 tailnet VPN。參考 Remote access 和 Discovery。

AI Setup Assistant

下一步

• Gateway configuration
• Remote access