大部分操作都透過 Gateway(openclaw gateway)進行。Gateway 是一個常駐程序,負責管理通訊連線和 WebSocket 控制層。

核心規則

  • 每台主機建議只跑一個 Gateway。Gateway 是唯一能持有 WhatsApp Web session 的程序。如果需要救援機器人或嚴格隔離,可以用獨立的 profile 和連接埠執行多個 Gateway。詳見 多 Gateway 部署
  • 預設 loopback 優先:Gateway WS 預設綁定在 ws://127.0.0.1:18789。即使是 loopback,設定精靈也會預設產生一組 gateway token。若要透過 tailnet 存取,請執行 openclaw gateway --bind tailnet --token ...,因為非 loopback 綁定時 token 是必要的。
  • 節點透過 LAN、tailnet 或 SSH 連線到 Gateway WS。舊版 TCP bridge 已淘汰。
  • Canvas host 由 Gateway HTTP 伺服器提供,使用與 Gateway 相同的連接埠(預設 18789):
    • /__openclaw__/canvas/
    • /__openclaw__/a2ui/gateway.auth 已設定且 Gateway 綁定範圍超出 loopback 時,這些路徑會受到 Gateway 認證保護。節點用戶端使用與其 WS session 綁定的節點範圍 capability URL。詳見 Gateway 設定canvasHostgateway)。
  • 遠端存取通常透過 SSH tunnel 或 tailnet VPN。詳見 遠端存取探索