Deploy su Render | Docs

Metti in funzione OpenClaw su Render usando l’Infrastructure as Code. Il file render.yaml Blueprint incluso definisce l’intero stack in modo dichiarativo — servizio, disco, variabili d’ambiente — così puoi fare il deploy con un clic e versionare l’infrastruttura insieme al codice.

Prerequisiti

Un account Render (esiste anche il piano gratuito)
Una chiave API del tuo provider di modelli preferito

Deploy con un Render Blueprint

Deploy to Render

Cliccando questo link:

Viene creato un nuovo servizio Render a partire dal Blueprint render.yaml nella root del repository.
Ti verrà chiesto di impostare SETUP_PASSWORD.
Render compila l’immagine Docker e lancia il deploy.

Una volta completato, l’URL del servizio segue lo schema https://<nome-servizio>.onrender.com.

Capire il Blueprint

I Render Blueprint sono file YAML che descrivono la tua infrastruttura. Il render.yaml di questo repository configura tutto il necessario per far girare OpenClaw:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Funzionalità principali del Blueprint:

Funzionalità	A cosa serve
`runtime: docker`	Compila a partire dal Dockerfile del repository
`healthCheckPath`	Render monitora `/health` e riavvia le istanze non sane
`sync: false`	Chiede il valore durante il deploy (per i segreti)
`generateValue: true`	Genera automaticamente un valore crittograficamente sicuro
`disk`	Storage persistente che sopravvive ai redeploy

Scegliere un piano

Piano	Spegnimento	Disco	Ideale per
Free	Dopo 15 min inattività	Non disponibile	Test, demo
Starter	Mai	1GB+	Uso personale, piccoli team
Standard+	Mai	1GB+	Produzione, canali multipli

Il Blueprint usa starter come predefinito. Per usare il piano gratuito, cambia plan: free nel file render.yaml del tuo fork (ma attenzione: senza disco persistente la configurazione si resetta ad ogni deploy).

Dopo il deploy

Completare il wizard di configurazione

Vai su https://<tuo-servizio>.onrender.com/setup
Inserisci la tua SETUP_PASSWORD
Seleziona un provider di modelli e incolla la tua chiave API
Facoltativamente, configura i canali di messaggistica (Telegram, Discord, Slack)
Clicca Run setup

Accedere all’interfaccia di controllo

La dashboard web è disponibile su https://<tuo-servizio>.onrender.com/openclaw.

Funzionalità della Dashboard Render

Log

Visualizza i log in tempo reale da Dashboard → il tuo servizio → Logs. Puoi filtrare per:

Log di build (creazione dell’immagine Docker)
Log di deploy (avvio del servizio)
Log di runtime (output dell’applicazione)

Accesso shell

Per il debug, apri una sessione shell da Dashboard → il tuo servizio → Shell. Il disco persistente è montato su /data.

Variabili d’ambiente

Modifica le variabili da Dashboard → il tuo servizio → Environment. Le modifiche attivano automaticamente un nuovo deploy.

Auto-deploy

Se usi il repository originale di OpenClaw, Render non esegue l’auto-deploy. Per aggiornare, lancia manualmente un Blueprint sync dalla dashboard.

Dominio personalizzato

Vai su Dashboard → il tuo servizio → Settings → Custom Domains
Aggiungi il tuo dominio
Configura il DNS come indicato (CNAME verso *.onrender.com)
Render emette automaticamente un certificato TLS

Scalabilità

Render supporta la scalabilità sia orizzontale che verticale:

Verticale: Cambia piano per ottenere più CPU/RAM
Orizzontale: Aumenta il numero di istanze (piano Standard e superiori)

Per OpenClaw, la scalabilità verticale è di solito sufficiente. Quella orizzontale richiede sessioni sticky o gestione esterna dello stato.

Backup e migrazione

Esporta la configurazione e il workspace in qualsiasi momento:

https://<tuo-servizio>.onrender.com/setup/export

Scaricherai un backup portabile che puoi ripristinare su qualsiasi host OpenClaw.

Risoluzione dei problemi

Il servizio non si avvia

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

SETUP_PASSWORD mancante — il Blueprint te la chiede durante il deploy, ma verifica che sia effettivamente impostata
Porta non corrispondente — assicurati che PORT=8080 coincida con la porta esposta nel Dockerfile

Avvio lento a freddo (piano gratuito)

I servizi del piano gratuito si spengono dopo 15 minuti di inattività. La prima richiesta dopo lo spegnimento richiede qualche secondo per l’avvio del container. Passa al piano Starter per averlo sempre attivo.

Perdita di dati dopo il redeploy

Succede con il piano gratuito (nessun disco persistente). Passa a un piano a pagamento, oppure esporta regolarmente la configurazione tramite /setup/export.

Fallimento degli health check

Render si aspetta una risposta 200 da /health entro 30 secondi. Se la build va a buon fine ma il deploy fallisce, il servizio potrebbe impiegare troppo tempo ad avviarsi. Verifica:

I log di build per eventuali errori
Che il container funzioni in locale con docker build && docker run