Metti in funzione OpenClaw su Railway con un template pronto all’uso e completa la configurazione direttamente dal browser. È il modo più semplice per partire senza mai toccare un terminale sul server: Railway esegue il Gateway al posto tuo e tu configuri tutto attraverso il wizard web su /setup.

Checklist rapida (per chi parte da zero)

  1. Clicca Deploy on Railway (qui sotto).
  2. Aggiungi un Volume montato su /data.
  3. Imposta le Variabili necessarie (come minimo SETUP_PASSWORD).
  4. Attiva l’HTTP Proxy sulla porta 8080.
  5. Apri https://<tuo-dominio-railway>/setup e completa il wizard.

Deploy con un clic

Deploy on Railway

Dopo il deploy, trovi l’URL pubblico in Railway → il tuo servizio → Settings → Domains.

Railway può:

  • assegnarti un dominio generato automaticamente (di solito https://<qualcosa>.up.railway.app), oppure
  • usare un dominio personalizzato, se ne hai collegato uno.

A quel punto apri:

  • https://<tuo-dominio-railway>/setup — wizard di configurazione (protetto da password)
  • https://<tuo-dominio-railway>/openclaw — Interfaccia di controllo

Cosa ottieni

  • OpenClaw Gateway + Interfaccia di controllo hostati
  • Wizard di configurazione web su /setup (niente comandi da terminale)
  • Storage persistente tramite Railway Volume (/data), così configurazioni, credenziali e workspace sopravvivono ai redeploy
  • Backup esportabile su /setup/export per migrare altrove in futuro

Impostazioni Railway necessarie

Rete pubblica

Abilita l’HTTP Proxy per il servizio.

  • Porta: 8080

Volume (obbligatorio)

Collega un volume montato su:

  • /data

Variabili

Imposta queste variabili sul servizio:

  • SETUP_PASSWORD (obbligatoria)
  • PORT=8080 (obbligatoria — deve coincidere con la porta del Public Networking)
  • OPENCLAW_STATE_DIR=/data/.openclaw (consigliata)
  • OPENCLAW_WORKSPACE_DIR=/data/workspace (consigliata)
  • OPENCLAW_GATEWAY_TOKEN (consigliata; trattala come un segreto amministrativo)

Come funziona il setup

  1. Vai su https://<tuo-dominio-railway>/setup e inserisci la tua SETUP_PASSWORD.
  2. Scegli un provider per il modello/autenticazione e incolla la tua chiave API.
  3. (Facoltativo) Aggiungi i token di Telegram/Discord/Slack.
  4. Clicca Run setup.

Se i messaggi diretti di Telegram sono impostati sulla modalità pairing, il wizard può approvare il codice di abbinamento.

Ottenere i token per le chat

Token del bot Telegram

  1. Scrivi a @BotFather su Telegram
  2. Esegui /newbot
  3. Copia il token (ha un formato tipo 123456789:AA...)
  4. Incollalo in /setup

Token del bot Discord

  1. Vai su https://discord.com/developers/applications
  2. New Application → scegli un nome
  3. Bot → Add Bot
  4. Attiva MESSAGE CONTENT INTENT sotto Bot → Privileged Gateway Intents (obbligatorio, altrimenti il bot va in crash all’avvio)
  5. Copia il Bot Token e incollalo in /setup
  6. Invita il bot nel tuo server (OAuth2 URL Generator; scopes: bot, applications.commands)

Backup e migrazione

Scarica un backup da:

  • https://<tuo-dominio-railway>/setup/export

Questo esporta lo stato di OpenClaw e il workspace, così puoi migrare su un altro host senza perdere configurazioni o dati.

arrow_back
Precedente
Exe Dev
Successivo
Render
arrow_forward