Rendering

Distribuisci OpenClaw su Render usando il Blueprint render.yaml del repository. Questo file dichiara il servizio, il disco e le variabili d'ambiente.

Prerequisiti

• Un account Render (è disponibile un piano gratuito)
• Una chiave API del provider di modelli che preferisci

Distribuzione

Distribuisci su Render

Questa operazione crea un servizio Render da render.yaml, genera l'immagine Docker e la distribuisce. L'URL del servizio segue il formato https://<service-name>.onrender.com.

Il Blueprint

services:  - type: web    name: openclaw    runtime: docker    plan: starter    healthCheckPath: /health    envVars:      - key: OPENCLAW_GATEWAY_PORT        value: "8080"      - key: OPENCLAW_STATE_DIR        value: /data/.openclaw      - key: OPENCLAW_WORKSPACE_DIR        value: /data/workspace      - key: OPENCLAW_GATEWAY_TOKEN        generateValue: true # genera automaticamente un token sicuro    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1

Scelta di un piano

Il Blueprint usa starter per impostazione predefinita. Per usare il piano gratuito, modifica plan: free nel file render.yaml del tuo fork. Tieni presente che, senza un disco persistente, lo stato di OpenClaw viene reimpostato a ogni distribuzione.

Dopo la distribuzione

Accesso all'interfaccia di controllo

La dashboard web è disponibile all'indirizzo https://<your-service>.onrender.com/. Connettiti usando il segreto condiviso, ovvero OPENCLAW_GATEWAY_TOKEN generato automaticamente (puoi trovarlo in Dashboard → your service → Environment), oppure la tua password se sei passato all'autenticazione tramite password.

Log

Dashboard → your service → Logs mostra i log di generazione (creazione dell'immagine Docker), i log di distribuzione (avvio del servizio) e i log di runtime (output dell'applicazione).

Accesso alla shell

Dashboard → your service → Shell apre una sessione shell. Il disco persistente è montato in /data.

Variabili d'ambiente

Modifica le variabili in Dashboard → your service → Environment. Le modifiche attivano automaticamente una nuova distribuzione.

Distribuzione automatica

Render esegue automaticamente una nuova distribuzione quando viene aggiunto un commit al ramo del repository collegato. Se hai eseguito la distribuzione direttamente da openclaw/openclaw anziché dal tuo fork, non disponi dell'accesso in scrittura necessario per attivarla. In tal caso, esegui una sincronizzazione manuale del Blueprint dalla Dashboard oppure configura il servizio affinché usi il tuo fork.

Dominio personalizzato

1. Dashboard → your service → Settings → Custom Domains
2. Aggiungi il tuo dominio
3. Configura il DNS come indicato (CNAME verso *.onrender.com)
4. Render effettua automaticamente il provisioning di un certificato TLS

Scalabilità

• Verticale: cambia piano per ottenere più CPU/RAM. In genere è sufficiente per OpenClaw.
• Orizzontale: aumenta il numero di istanze (piano Standard o superiore). Sono necessarie sessioni persistenti o una gestione esterna dello stato, poiché OpenClaw conserva lo stato di runtime sul disco locale.

Backup e migrazione

Dalla shell della Dashboard di Render puoi esportare in qualsiasi momento stato, configurazione, profili di autenticazione e area di lavoro:

openclaw backup create

Questo comando crea un archivio di backup portabile. Consulta Backup.

Risoluzione dei problemi

Il servizio non si avvia

Controlla i log di distribuzione nella Dashboard di Render. Problemi comuni:

• OPENCLAW_GATEWAY_TOKEN mancante: verifica che sia impostato in Dashboard → Environment
• Porta non corrispondente: assicurati che sia impostato OPENCLAW_GATEWAY_PORT=8080, affinché il Gateway si associ alla porta prevista da Render

Avvii a freddo lenti (piano gratuito)

I servizi del piano gratuito vengono sospesi dopo 15 minuti di inattività; la prima richiesta successiva alla sospensione richiede alcuni secondi mentre il container si avvia. Passa al piano Starter per mantenere il servizio sempre attivo.

Perdita di dati dopo una nuova distribuzione

Si verifica con il piano gratuito, che non dispone di un disco persistente. Passa a un piano a pagamento oppure esporta regolarmente un backup con openclaw backup create dalla shell di Render.

Errori del controllo di integrità

Se la generazione riesce ma la distribuzione non va a buon fine, l'avvio del servizio potrebbe richiedere troppo tempo oppure /health potrebbe non essere raggiungibile. Controlla:

• La presenza di errori nei log di generazione
• Se il container viene eseguito localmente con docker build && docker run

Passaggi successivi

• Configura i canali di messaggistica: Canali
• Configura il Gateway: Configurazione del Gateway
• Mantieni OpenClaw aggiornato: Aggiornamento