Vai al contenuto principale
EasyRunner può ospitare il Gateway di OpenClaw come una piccola app containerizzata dietro il suo proxy Caddy. Questa guida presuppone un host EasyRunner che esegue app Compose compatibili con Podman ed espone HTTPS tramite Caddy.

​
Prima di iniziare

  • Un server EasyRunner con un dominio instradato verso di esso.
  • Un’immagine container OpenClaw compilata o pubblicata.
  • Un volume di configurazione persistente per /home/node/.openclaw.
  • Un volume workspace persistente per /workspace.
  • Un token o una password Gateway robusti.
Mantieni l’autenticazione del dispositivo abilitata quando possibile. Se il tuo deployment con reverse proxy non può trasportare correttamente l’identità del dispositivo, correggi prima le impostazioni dei proxy attendibili; usa bypass di autenticazione pericolosi solo per una rete completamente privata e controllata dall’operatore.

​
App Compose

Crea un’app EasyRunner con un file Compose strutturato così: 
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
Sostituisci openclaw.example.com con il nome host del tuo Gateway. Archivia OPENCLAW_GATEWAY_TOKEN nel gestore di segreti/ambiente di EasyRunner invece di committarlo nella definizione dell’app.

​
Configura OpenClaw

All’interno del volume di configurazione persistente, mantieni il Gateway raggiungibile solo tramite il proxy e richiedi l’autenticazione: 
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
Se Caddy termina TLS per il Gateway, configura le impostazioni dei proxy attendibili per il percorso proxy esatto invece di disabilitare globalmente i controlli di autenticazione. Vedi Autenticazione proxy attendibile.

​
Verifica

Dalla tua workstation: 
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
Dall’host EasyRunner, controlla nei log dell’app la presenza di un Gateway in ascolto e l’assenza di errori di avvio relativi a SecretRef, plugin o autenticazione dei canali.

​
Aggiornamenti e backup

  • Scarica o compila la nuova immagine OpenClaw, quindi ridistribuisci l’app EasyRunner.
  • Esegui il backup del volume openclaw-config prima degli aggiornamenti.
  • Esegui il backup di openclaw-workspace se gli agenti vi scrivono dati di progetto duraturi.
  • Esegui openclaw doctor dopo aggiornamenti importanti per rilevare migrazioni della configurazione e avvisi di servizio.

​
Risoluzione dei problemi

  • gateway probe non riesce a connettersi: conferma che il nome host Caddy punti all’app e che il container ascolti su 0.0.0.0:1455.
  • L’autenticazione non riesce: ruota insieme il token nei segreti EasyRunner e il comando del client locale.
  • I file appartengono a root dopo il ripristino: ripara i volumi montati in modo che l’utente del container possa scrivere in /home/node/.openclaw e /workspace.
  • I plugin browser o di canale non funzionano: controlla che i binari esterni richiesti, l’egress di rete e le credenziali montate siano disponibili all’interno del container.