大部分操作都透過 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 設定(canvasHost、gateway)。
- 遠端存取通常透過 SSH tunnel 或 tailnet VPN。詳見 遠端存取 和 探索。