--- read_when: - Vuoi che OpenClaw sia in esecuzione 24/7 su una VPS cloud (non sul tuo laptop) - Vuoi un Gateway sempre attivo e pronto per la produzione sul tuo VPS - Vuoi il pieno controllo su persistenza, binari e comportamento di riavvio - Stai eseguendo OpenClaw in Docker su Hetzner o un provider simile summary: Esegui OpenClaw Gateway 24/7 su una VPS Hetzner economica (Docker) con stato persistente e binari integrati title: Hetzner x-i18n: generated_at: "2026-05-06T17:58:11Z" model: gpt-5.5 provider: openai source_hash: 6102649b381b3b1ecd6f52e1cf518fc36147fe143ebc8fd4be5f44ab26cb3b4d source_path: install/hetzner.md workflow: 16 --- ## Obiettivo Eseguire un Gateway OpenClaw persistente su una VPS Hetzner usando Docker, con stato durevole, binari integrati e comportamento di riavvio sicuro. Se vuoi "OpenClaw 24/7 per circa 5 $", questa è la configurazione affidabile più semplice. I prezzi di Hetzner cambiano; scegli la VPS Debian/Ubuntu più piccola e scala verso l'alto se incontri errori OOM. Promemoria sul modello di sicurezza: - Gli agenti condivisi in azienda vanno bene quando tutti rientrano nello stesso perimetro di fiducia e il runtime è solo aziendale. - Mantieni una separazione rigorosa: VPS/runtime dedicati + account dedicati; nessun profilo personale Apple/Google/browser/password manager su quell'host. - Se gli utenti sono avversari tra loro, separa per gateway/host/utente OS. Vedi [Sicurezza](/it/gateway/security) e [Hosting VPS](/it/vps). ## Cosa stiamo facendo (in parole semplici)? - Affittare un piccolo server Linux (VPS Hetzner) - Installare Docker (runtime dell'app isolato) - Avviare il Gateway OpenClaw in Docker - Rendere persistenti `~/.openclaw` + `~/.openclaw/workspace` sull'host (sopravvivono a riavvii/ricostruzioni) - Accedere alla Control UI dal tuo laptop tramite un tunnel SSH Quello stato montato di `~/.openclaw` include `openclaw.json`, per agente `agents//agent/auth-profiles.json` e `.env`. È possibile accedere al Gateway tramite: - Inoltro porta SSH dal tuo laptop - Esposizione diretta della porta se gestisci autonomamente firewall e token Questa guida presuppone Ubuntu o Debian su Hetzner. Se usi un'altra VPS Linux, mappa i pacchetti di conseguenza. Per il flusso Docker generico, vedi [Docker](/it/install/docker). --- ## Percorso rapido (operatori esperti) 1. Effettua il provisioning della VPS Hetzner 2. Installa Docker 3. Clona il repository OpenClaw 4. Crea directory host persistenti 5. Configura `.env` e `docker-compose.yml` 6. Integra i binari richiesti nell'immagine 7. `docker compose up -d` 8. Verifica persistenza e accesso al Gateway --- ## Cosa ti serve - VPS Hetzner con accesso root - Accesso SSH dal tuo laptop - Familiarità di base con SSH + copia/incolla - Circa 20 minuti - Docker e Docker Compose - Credenziali di autenticazione del modello - Credenziali provider opzionali - QR WhatsApp - Token bot Telegram - OAuth Gmail --- Crea una VPS Ubuntu o Debian in Hetzner. Connettiti come root: ```bash ssh root@YOUR_VPS_IP ``` Questa guida presuppone che la VPS sia stateful. Non trattarla come infrastruttura usa e getta. ```bash apt-get update apt-get install -y git curl ca-certificates curl -fsSL https://get.docker.com | sh ``` Verifica: ```bash docker --version docker compose version ``` ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw ``` Questa guida presuppone che tu crei un'immagine personalizzata per garantire la persistenza dei binari. I container Docker sono effimeri. Tutto lo stato a lungo termine deve risiedere sull'host. ```bash mkdir -p /root/.openclaw/workspace # Set ownership to the container user (uid 1000): chown -R 1000:1000 /root/.openclaw ``` Crea `.env` nella radice del repository. ```bash OPENCLAW_IMAGE=openclaw:latest OPENCLAW_GATEWAY_TOKEN= OPENCLAW_GATEWAY_BIND=lan OPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/root/.openclaw OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace GOG_KEYRING_PASSWORD= XDG_CONFIG_HOME=/home/node/.openclaw ``` Imposta `OPENCLAW_GATEWAY_TOKEN` quando vuoi gestire il token stabile del gateway tramite `.env`; altrimenti configura `gateway.auth.token` prima di fare affidamento sui client tra i riavvii. Se nessuna delle due fonti esiste, OpenClaw usa un token solo runtime per quell'avvio. Genera una password per il keyring e incollala in `GOG_KEYRING_PASSWORD`: ```bash openssl rand -hex 32 ``` **Non committare questo file.** Questo file `.env` è per l'env del container/runtime, come `OPENCLAW_GATEWAY_TOKEN`. L'autenticazione OAuth/API-key dei provider archiviata risiede nel file montato `~/.openclaw/agents//agent/auth-profiles.json`. Crea o aggiorna `docker-compose.yml`. ```yaml services: openclaw-gateway: image: ${OPENCLAW_IMAGE} build: . restart: unless-stopped env_file: - .env environment: - HOME=/home/node - NODE_ENV=production - TERM=xterm-256color - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND} - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT} - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN} - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD} - XDG_CONFIG_HOME=${XDG_CONFIG_HOME} - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin volumes: - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace ports: # Recommended: keep the Gateway loopback-only on the VPS; access via SSH tunnel. # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly. - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789" command: [ "node", "dist/index.js", "gateway", "--bind", "${OPENCLAW_GATEWAY_BIND}", "--port", "${OPENCLAW_GATEWAY_PORT}", "--allow-unconfigured", ] ``` `--allow-unconfigured` serve solo per comodità di bootstrap, non sostituisce una configurazione corretta del gateway. Imposta comunque l'autenticazione (`gateway.auth.token` o password) e usa impostazioni di bind sicure per il tuo deployment. Usa la guida runtime condivisa per il flusso comune dell'host Docker: - [Integra i binari richiesti nell'immagine](/it/install/docker-vm-runtime#bake-required-binaries-into-the-image) - [Crea e avvia](/it/install/docker-vm-runtime#build-and-launch) - [Cosa persiste dove](/it/install/docker-vm-runtime#what-persists-where) - [Aggiornamenti](/it/install/docker-vm-runtime#updates) Dopo i passaggi condivisi di build e avvio, completa la seguente configurazione per aprire il tunnel: **Prerequisito:** assicurati che la configurazione sshd della VPS consenta l'inoltro TCP. Se hai irrigidito la configurazione SSH, controlla `/etc/ssh/sshd_config` e imposta: ``` AllowTcpForwarding local ``` `local` consente inoltri locali `ssh -L` dal tuo laptop bloccando gli inoltri remoti dal server. Impostarlo su `no` farà fallire il tunnel con: `channel 3: open failed: administratively prohibited: open failed` Dopo aver confermato che l'inoltro TCP è abilitato, riavvia il servizio SSH (`systemctl restart ssh`) ed esegui il tunnel dal tuo laptop: ```bash ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP ``` Apri: `http://127.0.0.1:18789/` Incolla il segreto condiviso configurato. Questa guida usa il token del gateway per impostazione predefinita; se sei passato all'autenticazione con password, usa invece quella password. La mappa di persistenza condivisa si trova in [Runtime VM Docker](/it/install/docker-vm-runtime#what-persists-where). ## Infrastructure as Code (Terraform) Per i team che preferiscono flussi infrastructure-as-code, una configurazione Terraform mantenuta dalla community fornisce: - Configurazione Terraform modulare con gestione dello stato remoto - Provisioning automatizzato tramite cloud-init - Script di deployment (bootstrap, deploy, backup/ripristino) - Rafforzamento della sicurezza (firewall, UFW, accesso solo SSH) - Configurazione del tunnel SSH per l'accesso al gateway **Repository:** - Infrastruttura: [openclaw-terraform-hetzner](https://github.com/andreesg/openclaw-terraform-hetzner) - Configurazione Docker: [openclaw-docker-config](https://github.com/andreesg/openclaw-docker-config) Questo approccio integra la configurazione Docker sopra con deployment riproducibili, infrastruttura versionata e ripristino di emergenza automatizzato. Mantenuto dalla community. Per problemi o contributi, vedi i link ai repository sopra. ## Passaggi successivi - Configura i canali di messaggistica: [Canali](/it/channels) - Configura il Gateway: [Configurazione Gateway](/it/gateway/configuration) - Mantieni OpenClaw aggiornato: [Aggiornamento](/it/install/updating) ## Correlati - [Panoramica installazione](/it/install) - [Fly.io](/it/install/fly) - [Docker](/it/install/docker) - [Hosting VPS](/it/vps)