# Render

Distribuisci OpenClaw su Render usando Infrastructure as Code. Il Blueprint render.yaml incluso definisce l'intero stack in modo dichiarativo, servizio, disco, variabili d'ambiente, così puoi distribuire con un solo clic e versionare l'infrastruttura insieme al codice.

# Prerequisiti

• Un account Render (tier gratuito disponibile)
• Una chiave API del tuo provider di modelli preferito

# Distribuire con un Render Blueprint

Deploy to Render

Facendo clic su questo link:

1. Verrà creato un nuovo servizio Render dal Blueprint render.yaml nella root di questo repo.
2. Verrà compilata l'immagine Docker e avviato il deployment

Una volta distribuito, l'URL del tuo servizio segue il pattern https://<service-name>.onrender.com.

# Capire il Blueprint

I Render Blueprints sono file YAML che definiscono la tua infrastruttura. Il file render.yaml in questo repository configura tutto ciò che serve per eseguire OpenClaw:

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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Funzionalità Blueprint principali usate:

Funzionalità	Scopo
runtime: docker	Compila dal Dockerfile del repo
healthCheckPath	Render monitora /health e riavvia le istanze non sane
generateValue: true	Genera automaticamente un valore crittograficamente sicuro
disk	Archiviazione persistente che sopravvive ai redeploy

# Scegliere un piano

Piano	Spin-down	Disco	Ideale per
Free	Dopo 15 min inattivo	Non disponibile	Test, demo
Starter	Mai	1GB+	Uso personale, piccoli team
Standard+	Mai	1GB+	Produzione, più canali

Il Blueprint usa starter come valore predefinito. Per usare il tier gratuito, cambia plan: free nel render.yaml del tuo fork (ma attenzione: senza disco persistente lo stato di OpenClaw si reimposta a ogni deployment).

# Dopo il deployment

# Accedere alla Control UI

La dashboard web è disponibile su https://<your-service>.onrender.com/.

Connettiti usando il secret condiviso configurato. Questo template di deployment genera automaticamente OPENCLAW_GATEWAY_TOKEN (trovalo in Dashboard → your service → Environment); se lo sostituisci con autenticazione tramite password, usa invece quella password.

# Funzionalità della dashboard Render

# Log

Visualizza i log in tempo reale in Dashboard → your service → Logs. Filtra per:

• Log di build (creazione dell'immagine Docker)
• Log di deployment (avvio del servizio)
• Log runtime (output dell'applicazione)

# Accesso shell

Per il debug, apri una sessione shell tramite Dashboard → your service → Shell. Il disco persistente è montato in /data.

# Variabili d'ambiente

Modifica le variabili in Dashboard → your service → Environment. Le modifiche attivano un redeploy automatico.

# Auto-deploy

Se usi il repository OpenClaw originale, Render non eseguirà l'auto-deploy del tuo OpenClaw. Per aggiornarlo, esegui una sincronizzazione manuale del Blueprint dalla dashboard.

# Dominio personalizzato

1. Vai su 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à

Render supporta scalabilità orizzontale e verticale:

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

Per OpenClaw, la scalabilità verticale è in genere sufficiente. La scalabilità orizzontale richiede sticky session o gestione dello stato esterna.

# Backup e migrazione

Esporta in qualsiasi momento stato, configurazione, profili di autenticazione e workspace usando l'accesso shell nella Dashboard Render:

openclaw backup create

Questo crea un archivio di backup portabile con lo stato OpenClaw più l'eventuale workspace configurato. Vedi Backup per i dettagli.

# Risoluzione dei problemi

# Il servizio non si avvia

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

• OPENCLAW_GATEWAY_TOKEN mancante — verifica che sia impostato in Dashboard → Environment
• Mancata corrispondenza della porta — assicurati che OPENCLAW_GATEWAY_PORT=8080 sia impostato affinché il gateway si associ alla porta prevista da Render

# Cold start lenti (tier gratuito)

I servizi del tier gratuito vanno in spin-down dopo 15 minuti di inattività. La prima richiesta dopo lo spin-down richiede alcuni secondi mentre il container si avvia. Passa al piano Starter per restare sempre attivo.

# Perdita di dati dopo il redeploy

Questo succede nel tier gratuito (nessun disco persistente). Passa a un piano a pagamento, oppure esporta regolarmente un backup completo tramite openclaw backup create nella shell Render.

# Errori di health check

Render si aspetta una risposta 200 da /health entro 30 secondi. Se le build riescono ma i deployment falliscono, il servizio potrebbe impiegare troppo tempo ad avviarsi. Controlla:

• I log di build per eventuali errori
• Se il container viene eseguito localmente con docker build && docker run

# Passi successivi

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