Guida Rapida a OpenClaw Facile

Installa la tua istanza OpenClaw in pochi semplici passaggi

Avvio Rapido

  1. 1. Registrati con il tuo account Google
  2. 2. Sottoscrivi un piano (Basic, Pro o Enterprise)
  3. 3. Aggiungi le tue chiavi API da Anthropic o OpenAI
  4. 4. (Opzionale) Connetti il tuo bot Telegram per la messaggistica tramite @BotFather
  5. 5. Clicca "Installa Istanza" e attendi il completamento del provisioning

Prerequisiti

  • Un account Google per l'autenticazione
  • Chiave API da Anthropic (Claude) o OpenAI (ChatGPT) - almeno una richiesta
  • Carta di credito per il pagamento dell'abbonamento

Passaggio 1: Crea un Account

Visita openclawfacile.it e clicca "Inizia". Verrai reindirizzato per accedere con il tuo account Google.

OpenClaw Facile utilizza Google OAuth per l'autenticazione - nessuna password necessaria. Il tuo account viene creato automaticamente dopo l'accesso.

Passaggio 2: Scegli un Piano di Abbonamento

Prima di installare un'istanza, dovrai sottoscrivere un piano. Visita la pagina dei prezzi per vedere i livelli disponibili:

  • Basic - Perfetto per singoli utenti e piccoli progetti
  • Pro - Consigliato per team e uso in produzione
  • Enterprise - Risorse massime per applicazioni ad alto volume

Clicca "Sottoscrivi" sul piano scelto. Verrai reindirizzato a Stripe Checkout per completare il pagamento. Il tuo abbonamento si attiva immediatamente dopo la conferma del pagamento.

Passaggio 3: Configura le Chiavi API

OpenClaw richiede chiavi API da Anthropic (per Claude) o OpenAI (per ChatGPT). Ne serve almeno una, ma puoi configurarle entrambe.

Consulta la Guida alla Configurazione delle Chiavi API per istruzioni passo passo su come ottenere le chiavi da ciascun provider.

Importante: Le tue chiavi API sono crittografate e conservate in modo sicuro. Sono accessibili solo alla tua istanza.

Passaggio 4: Connetti il Bot Telegram (Opzionale)

Se vuoi interagire con la tua istanza OpenClaw tramite Telegram, puoi connettere il tuo bot:

  1. Apri Telegram e avvia una chat con @BotFather
  2. Digita /newbot e segui le istruzioni per creare il tuo bot
  3. Copia il token del bot che BotFather ti fornisce
  4. Inserisci il token durante il flusso di installazione, oppure aggiornalo successivamente dalla pagina Telegram nel tuo pannello

Il token del tuo bot è crittografato e conservato in modo sicuro, proprio come le tue chiavi API. Puoi aggiornarlo in qualsiasi momento dalle impostazioni Telegram nel tuo pannello.

Passaggio 5: Installa l'Istanza

Una volta che il tuo abbonamento è attivo e le chiavi API sono configurate, vai al tuo pannello e clicca "Installa Istanza".

OpenClaw Facile eseguirà:

  1. Allocazione delle risorse su Fly.io in base al tuo livello di abbonamento
  2. Creazione di una Fly Machine isolata con la tua immagine OpenClaw
  3. Collegamento di un volume persistente per i dati del tuo workspace
  4. Configurazione sicura delle tue chiavi API
  5. Configurazione automatica di HTTPS tramite Fly.io

L'installazione richiede tipicamente 20-30 secondi. Vedrai lo stato "Provisioning" durante questo periodo.

Accedere alla tua Istanza

Una volta completata l'installazione, la tua istanza avrà lo stato "In esecuzione" e vedrai il tuo URL univoco:

https://[nome-app].fly.dev

Clicca l'URL o il pulsante "Visita Istanza" per accedere alla tua interfaccia OpenClaw. HTTPS è configurato automaticamente da Fly.io.

Gestire la tua Istanza

Dal tuo pannello, puoi controllare la tua istanza con queste azioni:

  • Avvia - Avvia un'istanza fermata
  • Ferma - Ferma temporaneamente la tua istanza (conserva i dati)
  • Riavvia - Riavvia la tua istanza (utile dopo l'aggiornamento delle chiavi API)
  • Elimina - Elimina permanentemente la tua istanza (non può essere annullato)

Puoi anche aggiornare le tue chiavi API dalla pagina Chiavi API o il token del tuo bot Telegram dalla pagina Telegram. Aggiornando uno dei due, la tua macchina verrà automaticamente aggiornata con la nuova configurazione.

Risoluzione Problemi

L'istanza non si avvia

  • Verifica che le tue chiavi API siano valide e inserite correttamente
  • Controlla che il tuo abbonamento sia attivo (non cancellato, sospeso o incompleto)
  • Prova a eliminare e reinstallare l'istanza
  • Contatta il supporto se il problema persiste

Impossibile accedere al sottodominio

  • La propagazione DNS può richiedere alcuni minuti - attendi 2-3 minuti e riprova
  • Verifica che lo stato della tua istanza sia "In esecuzione" (non "Fermata")
  • Prova ad accedere in una finestra del browser in incognito/privata
  • Svuota la cache del browser e la cache DNS

Errore "Chiave API non valida" in OpenClaw

  • Vai alle Impostazioni del tuo pannello e ricopia la chiave API (controlla eventuali spazi extra)
  • Verifica che la chiave sia attiva nella console del tuo provider (Anthropic o OpenAI)
  • Controlla che il tuo account del provider API abbia crediti sufficienti/fatturazione configurata
  • Dopo aver aggiornato le chiavi, riavvia la tua istanza perché le modifiche abbiano effetto

Prossimi Passaggi

Leggi la Guida alla Configurazione delle Chiavi API per istruzioni dettagliate su come ottenere e configurare le chiavi API.

Contatta il Supporto se riscontri problemi o hai domande.