Skip to main content
Esegui un Gateway OpenClaw persistente su un Droplet DigitalOcean (~6 $/mese per il piano Basic da 1 GB). DigitalOcean offre una soluzione VPS a pagamento semplice. Per opzioni più economiche o gratuite:
  • Hetzner — più core/RAM per ogni dollaro.
  • Oracle Cloud — piano ARM Always Free (fino a 4 OCPU e 24 GB di RAM), ma la registrazione può essere problematica ed è disponibile solo per ARM.

Prerequisiti

  • Account DigitalOcean (registrazione)
  • Coppia di chiavi SSH (oppure disponibilità a usare l’autenticazione tramite password)
  • Circa 20 minuti

Configurazione

1

Crea un Droplet

Usa un’immagine di base pulita (Ubuntu 24.04 LTS). Evita le immagini Marketplace di terze parti con installazione in un clic, a meno che tu non ne abbia esaminato gli script di avvio e le impostazioni predefinite del firewall.
  1. Accedi a DigitalOcean.
  2. Fai clic su Create > Droplets.
  3. Scegli:
    • Region: la regione più vicina
    • Image: Ubuntu 24.04 LTS
    • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
    • Authentication: chiave SSH (consigliata) o password
  4. Fai clic su Create Droplet e annota l’indirizzo IP.
2

Connettiti e installa

Usa la shell root solo per la configurazione iniziale del sistema. Esegui i comandi OpenClaw come utente non root openclaw, affinché lo stato risieda in /home/openclaw/.openclaw/ e il Gateway venga installato come servizio systemd --user di tale utente.
3

Esegui la configurazione iniziale

La procedura guidata illustra l’autenticazione del modello, la configurazione dei canali, la generazione del token del Gateway e l’installazione del daemon (servizio utente systemd).
4

Aggiungi lo swap (consigliato per i Droplet da 1 GB)

5

Verifica il Gateway

6

Accedi all'interfaccia di controllo

Per impostazione predefinita, il Gateway resta in ascolto sull’interfaccia local loopback. Scegli una delle seguenti opzioni.Opzione A: tunnel SSH (la più semplice)
Quindi apri http://localhost:18789.Opzione B: Tailscale Serve
Quindi apri https://<magicdns>/ da qualsiasi dispositivo sulla tua tailnet.Tailscale Serve autentica il traffico dell’interfaccia di controllo e WebSocket tramite le intestazioni di identità della tailnet; ciò presuppone che l’host del Gateway stesso sia attendibile. Gli endpoint dell’API HTTP continuano comunque a seguire la normale modalità di autenticazione del Gateway (token/password). Per richiedere credenziali esplicite basate su un segreto condiviso tramite Serve, imposta gateway.auth.allowTailscale: false e usa gateway.auth.mode: "token" oppure "password".Opzione C: associazione alla tailnet (senza Serve)
Quindi apri http://<tailscale-ip>:18789 (token obbligatorio).

Persistenza e backup

Lo stato di OpenClaw risiede in:
  • ~/.openclaw/openclaw.json, credenziali di canali e provider, file auth-profiles.json per ciascun agente e dati delle sessioni.
  • ~/.openclaw/workspace/ — lo spazio di lavoro dell’agente (SOUL.md, memoria, artefatti).
Questi dati persistono dopo i riavvii del Droplet. Per creare un’istantanea portabile:
Le istantanee di DigitalOcean eseguono il backup dell’intero Droplet; openclaw backup create è portabile tra host diversi.

Suggerimenti per 1 GB di RAM

Il Droplet da 6 $ dispone di solo 1 GB di RAM. Per garantire un funzionamento fluido:
  • Assicurati che la configurazione dello swap descritta sopra sia presente in /etc/fstab, in modo che persista dopo i riavvii.
  • Preferisci i modelli basati su API (Claude, GPT) a quelli locali: l’inferenza LLM locale non è eseguibile con 1 GB.
  • Imposta agents.defaults.model.primary su un modello più piccolo se riscontri errori OOM con prompt di grandi dimensioni.
  • Monitora il sistema con free -h e htop.

Risoluzione dei problemi

Il Gateway non si avvia — Esegui openclaw doctor --non-interactive e controlla i log con journalctl --user -u openclaw-gateway.service -n 50. Porta già in uso — Esegui lsof -i :18789 per individuare il processo, quindi arrestalo. Memoria esaurita — Verifica che lo swap sia attivo con free -h. Se continui a riscontrare errori OOM, passa a modelli basati su API (Claude, GPT) anziché a modelli locali, oppure esegui l’upgrade a un Droplet da 2 GB.

Passaggi successivi

Contenuti correlati