Remote access

Configurazione del Gateway remoto

Esecuzione di OpenClaw.app con un Gateway remoto

OpenClaw.app raggiunge un Gateway remoto tramite un tunnel SSH: un LocalForward SSH associa una porta locale alla porta WebSocket del Gateway sull'host remoto.

flowchart TB
    subgraph Client["Macchina client"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(porta locale)"]
        T["Tunnel SSH"]

        A --> B
        B --> T
    end
    subgraph Remote["Macchina remota"]
        direction TB
        C["WebSocket del Gateway"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

Configurazione

  1. Aggiungi una voce alla configurazione SSH con LocalForward 18789 127.0.0.1:18789 (consulta Accesso remoto per il blocco di configurazione completo).
  2. Copia la tua chiave SSH sull'host remoto con ssh-copy-id.
  3. Imposta gateway.remote.token (o gateway.remote.password) tramite openclaw config set gateway.remote.token "<your-token>".
  4. Avvia il tunnel: ssh -N remote-gateway &.
  5. Chiudi e riapri OpenClaw.app.

Per un tunnel che rimanga attivo dopo i riavvii e si riconnetta automaticamente, usa la configurazione LaunchAgent nella pagina Accesso remoto anziché eseguire manualmente ssh -N.

Come funziona

Componente Funzione
LocalForward 18789 127.0.0.1:18789 Inoltra la porta locale 18789 alla porta remota 18789
ssh -N Connessione SSH senza eseguire comandi remoti (solo inoltro delle porte)
KeepAlive Riavvia automaticamente il tunnel in caso di arresto anomalo (LaunchAgent)
RunAtLoad Avvia il tunnel quando viene caricato il LaunchAgent (LaunchAgent)

OpenClaw.app si connette a ws://127.0.0.1:18789 sul client. Il tunnel inoltra tale connessione alla porta 18789 dell'host remoto su cui è in esecuzione il Gateway.

Contenuti correlati

Was this useful?
On this page

On this page