OpenClaw Onboarding: la tua prima volta con il tuo assistente AI (guida per principianti)
# OPENCLAW ONBOARDING: LA TUA PRIMA VOLTA CON IL TUO ASSISTENTE AI (GUIDA PER PRINCIPIANTI ASSOLUTI)
Hai appena installato OpenClaw. Hai seguito la guida all'installazione, hai superato la paura del terminale, e ora ti trovi davanti a uno schermo nero che ti aspetta.
Che fai?
Questa è la fase più importante: **l'onboarding di OpenClaw**. È il momento in cui trasformi un programma installato in un assistente AI che parla con te, capisce chi sei, e inizia a fare cose utili per la tua vita quotidiana.
Niente panico. Ti guido passo dopo passo.
---
## COS'E' L'ONBOARDING DI OPENCLAW (E PERCHE' NON DEVETE AVERE PAURA)
Immagina di aver comprato un cane nuovo. Non lo metti in mezzo al salotto e ti aspetti che sappia già sedersi, dare la zampa, e non mangiare le scarpe. No. Gli dai un nome, gli mostri dove dormire, e inizi a costruire un rapporto.
L'onboarding di OpenClaw è esattamente questo: il momento in cui gli dai un nome, gli spieghi chi sei, e inizi a costruire un rapporto.
OpenClaw offre una **procedura guidata** che ti accompagna passo passo. Non devi indovinare nulla. Ti viene chiesto cosa serve, tu rispondi, e lui si configura da solo.
---
## PASSO 1: AVVIA LA PROCEDURA GUIDATA
Dopo aver installato OpenClaw, apri il terminale (quella "finestra nera" di cui parlavamo) e scrivi:
```
openclaw doctor
```
Cosa fa questo comando?
- **openclaw** → dice al computer di usare il programma OpenClaw
- **doctor** → è come un controllo medico. Verifica che tutto sia installato correttamente
Se tutto è a posto, vedrai un messaggio verde che dice che OpenClaw è pronto. Se c'è qualcosa che manca, te lo dice lui. È come avere un meccanico che ti dice "manca l'olio" invece di trovartelo da solo.
---
## PASSO 2: SCEGLI IL TUO MODELLIO AI
Il modello AI è il "cervello" di OpenClaw. È ciò che gli dà la capacità di capire cosa gli dici e rispondere in modo intelligente.
Durante l'onboarding, OpenClaw ti chiederà: **quale fornitore di modelli vuoi usare?**
Le opzioni principali sono:
- **Anthropic** (Claude) – ottimo per ragionamento e scrittura
- **OpenAI** (GPT-4) – versatile, capisce quasi tutto
- **Google** (Gemini) – buono per analisi e creatività
- **Altri** – OpenClaw supporta molti fornitori diversi
Non serve essere esperti per scegliere. Ecco un consiglio semplice:
- Se hai già una chiave API di OpenAI o Anthropic, usa quella
- Se non sai cosa sia una chiave API: non preoccuparti. È come il PIN della carta di credito. Serve per dimostrare che sei tu. Vai sul sito del fornitore, richiedila, e incollala quando OpenClaw te la chiede.
---
## PASSO 3: CONFIGURA L'AUTENTICAZIONE
L'autenticazione è il modo in cui OpenClaw sa che sei tu. Senza di quella, chiunque potrebbe parlare con il tuo agente AI.
Durante l'onboarding, OpenClaw genera automaticamente una **chiave di autenticazione**. È una stringa lunga e casuale di lettere e numeri.
**Consiglio di sicurezza:** salva questa chiave in un posto sicuro. Un file di testo sul computer va bene, ma non inviarla via email o metterla sui social network. È come la chiave di casa: non la dai a chiunque.
---
## PASSO 4: AVVIA IL GATEWAY
Il Gateway è il cuore di OpenClaw. È il servizio che gira in background e gestisce tutto: riceve i tuoi messaggi, li passa al modello AI, e ti risponde.
Per avviarlo, dal terminale:
```
openclaw gateway start
```
Cosa significa:
- **openclaw** → il programma
- **gateway** → il servizio principale
- **start** → accendilo
Se tutto funziona, vedrai un messaggio tipo "Gateway started on port 18789". Il numero 18789 è come il numero della porta di casa: è così che altri programmi trovano OpenClaw sul tuo computer.
Puoi verificare che tutto giri bene con:
```
openclaw gateway status
```
Questo è il "controllo qualità". Ti dice se il Gateway è acceso, spento, o ha qualche problema.
---
## PASSO 5: COLLEGA UN CANALE DI CHAT
Qui diventa divertente. OpenClaw può parlare con te attraverso diverse app:
- **WhatsApp** – il più popolare. Ti arriva un messaggio come se ti scrivessi un amico
- **Telegram** – ottimo se vuoi funzionalità extra come i bot avanzati
- **Discord** – se usi già Discord per giocare o chattare con amici
- **iMessage** – se sei nel mondo Apple
Per collegare WhatsApp, per esempio, dovrai scansionare un QR code con il telefono. Sì, proprio come fai quando attivi WhatsApp Web. È lo stesso concetto: il tuo telefono "parla" con OpenClaw.
Durante l'onboarding, OpenClaw ti guiderà attraverso la scelta del canale. Scegli quello che usi di più. Non puoi sbagliare: se non ti convince, lo cambi dopo.
---
## PASSO 6: DAI UN NOME AL TUO AGENTE
Il tuo agente AI non è un robot anonimo. Ha un nome, e lo scegli tu.
Durante l'onboarding ti verrà chiesto: **come vuoi chiamare il tuo assistente?**
Fontina? Jarvis? Clippy (no, non Clippy)? A te la scelta.
Il nome che scegli diventa il modo in cui gli parli e lui ti risponde. È un dettaglio piccolo, ma cambia tutto. Parlare con "Fontina" è diverso da parlare con "AI Assistant #47".
---
## COSA SUCCEDE DOPO L'ONBOARDING
Una volta completata la procedura guidata, il tuo OpenClaw è operativo. Puoi:
- **Parlargli** dall'app che hai scelto (WhatsApp, Telegram, ecc.)
- **Dargli compiti** come "scrivimi una lista della spesa" o "ricordami di chiamare mamma"
- **Personalizzarlo** con i file di configurazione (SOUL.md, USER.md, AGENTS.md)
- **Aggiungere competenze** (le "Skill") per fargli fare cose specifiche
Il tuo agente non saprà tutto subito. Ma è come un bambino: impara da te. Più gli parli, più impara le tue abitudini, i tuoi gusti, il tuo stile.
---
## ERRORI COMUNI DEL PRIMO GIORNO (E COME RISOLVERLI)
**"Il Gateway non parte"**
Di solito è perché la porta 18789 è già occupata da qualcos'altro. Risolvi con:
```
openclaw gateway stop
openclaw gateway start
```
Prima spegni, poi riavvia. Come spegnere e riaccendere il router quando internet non funziona. Funziona sempre.
**"Non riesco a collegare WhatsApp"**
Controlla che il QR code sia ancora valido. I codici QR scadono dopo circa 60 secondi. Se scade, avvialo di nuovo e scansiona subito.
**"L'agente non risponde"**
Verifica che il Gateway sia attivo:
```
openclaw gateway status
```
Se dice "stopped", avvialo. Se dice "running" ma non risponde, controlla la connessione internet. OpenClaw ha bisogno di internet per parlare con il modello AI.
---
## IN SINTESI
L'onboarding di OpenClaw è progettato per essere fatto una sola volta. Ci vogliono circa 5-10 minuti. Dopo quello, hai un assistente AI personale che:
- Vive sul tuo computer (o su una macchina virtuale, come raccomando sempre)
- Parla con te tramite l'app che preferisci
- Impara da te nel tempo
- Può fare molto più di quanto pensi
Il passo più difficile non è tecnico. È decidere di iniziare.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'. Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non e' paranoia, e' buon senso.
Hai appena installato OpenClaw. Hai seguito la guida all'installazione, hai superato la paura del terminale, e ora ti trovi davanti a uno schermo nero che ti aspetta.
Che fai?
Questa è la fase più importante: **l'onboarding di OpenClaw**. È il momento in cui trasformi un programma installato in un assistente AI che parla con te, capisce chi sei, e inizia a fare cose utili per la tua vita quotidiana.
Niente panico. Ti guido passo dopo passo.
---
## COS'E' L'ONBOARDING DI OPENCLAW (E PERCHE' NON DEVETE AVERE PAURA)
Immagina di aver comprato un cane nuovo. Non lo metti in mezzo al salotto e ti aspetti che sappia già sedersi, dare la zampa, e non mangiare le scarpe. No. Gli dai un nome, gli mostri dove dormire, e inizi a costruire un rapporto.
L'onboarding di OpenClaw è esattamente questo: il momento in cui gli dai un nome, gli spieghi chi sei, e inizi a costruire un rapporto.
OpenClaw offre una **procedura guidata** che ti accompagna passo passo. Non devi indovinare nulla. Ti viene chiesto cosa serve, tu rispondi, e lui si configura da solo.
---
## PASSO 1: AVVIA LA PROCEDURA GUIDATA
Dopo aver installato OpenClaw, apri il terminale (quella "finestra nera" di cui parlavamo) e scrivi:
```
openclaw doctor
```
Cosa fa questo comando?
- **openclaw** → dice al computer di usare il programma OpenClaw
- **doctor** → è come un controllo medico. Verifica che tutto sia installato correttamente
Se tutto è a posto, vedrai un messaggio verde che dice che OpenClaw è pronto. Se c'è qualcosa che manca, te lo dice lui. È come avere un meccanico che ti dice "manca l'olio" invece di trovartelo da solo.
---
## PASSO 2: SCEGLI IL TUO MODELLIO AI
Il modello AI è il "cervello" di OpenClaw. È ciò che gli dà la capacità di capire cosa gli dici e rispondere in modo intelligente.
Durante l'onboarding, OpenClaw ti chiederà: **quale fornitore di modelli vuoi usare?**
Le opzioni principali sono:
- **Anthropic** (Claude) – ottimo per ragionamento e scrittura
- **OpenAI** (GPT-4) – versatile, capisce quasi tutto
- **Google** (Gemini) – buono per analisi e creatività
- **Altri** – OpenClaw supporta molti fornitori diversi
Non serve essere esperti per scegliere. Ecco un consiglio semplice:
- Se hai già una chiave API di OpenAI o Anthropic, usa quella
- Se non sai cosa sia una chiave API: non preoccuparti. È come il PIN della carta di credito. Serve per dimostrare che sei tu. Vai sul sito del fornitore, richiedila, e incollala quando OpenClaw te la chiede.
---
## PASSO 3: CONFIGURA L'AUTENTICAZIONE
L'autenticazione è il modo in cui OpenClaw sa che sei tu. Senza di quella, chiunque potrebbe parlare con il tuo agente AI.
Durante l'onboarding, OpenClaw genera automaticamente una **chiave di autenticazione**. È una stringa lunga e casuale di lettere e numeri.
**Consiglio di sicurezza:** salva questa chiave in un posto sicuro. Un file di testo sul computer va bene, ma non inviarla via email o metterla sui social network. È come la chiave di casa: non la dai a chiunque.
---
## PASSO 4: AVVIA IL GATEWAY
Il Gateway è il cuore di OpenClaw. È il servizio che gira in background e gestisce tutto: riceve i tuoi messaggi, li passa al modello AI, e ti risponde.
Per avviarlo, dal terminale:
```
openclaw gateway start
```
Cosa significa:
- **openclaw** → il programma
- **gateway** → il servizio principale
- **start** → accendilo
Se tutto funziona, vedrai un messaggio tipo "Gateway started on port 18789". Il numero 18789 è come il numero della porta di casa: è così che altri programmi trovano OpenClaw sul tuo computer.
Puoi verificare che tutto giri bene con:
```
openclaw gateway status
```
Questo è il "controllo qualità". Ti dice se il Gateway è acceso, spento, o ha qualche problema.
---
## PASSO 5: COLLEGA UN CANALE DI CHAT
Qui diventa divertente. OpenClaw può parlare con te attraverso diverse app:
- **WhatsApp** – il più popolare. Ti arriva un messaggio come se ti scrivessi un amico
- **Telegram** – ottimo se vuoi funzionalità extra come i bot avanzati
- **Discord** – se usi già Discord per giocare o chattare con amici
- **iMessage** – se sei nel mondo Apple
Per collegare WhatsApp, per esempio, dovrai scansionare un QR code con il telefono. Sì, proprio come fai quando attivi WhatsApp Web. È lo stesso concetto: il tuo telefono "parla" con OpenClaw.
Durante l'onboarding, OpenClaw ti guiderà attraverso la scelta del canale. Scegli quello che usi di più. Non puoi sbagliare: se non ti convince, lo cambi dopo.
---
## PASSO 6: DAI UN NOME AL TUO AGENTE
Il tuo agente AI non è un robot anonimo. Ha un nome, e lo scegli tu.
Durante l'onboarding ti verrà chiesto: **come vuoi chiamare il tuo assistente?**
Fontina? Jarvis? Clippy (no, non Clippy)? A te la scelta.
Il nome che scegli diventa il modo in cui gli parli e lui ti risponde. È un dettaglio piccolo, ma cambia tutto. Parlare con "Fontina" è diverso da parlare con "AI Assistant #47".
---
## COSA SUCCEDE DOPO L'ONBOARDING
Una volta completata la procedura guidata, il tuo OpenClaw è operativo. Puoi:
- **Parlargli** dall'app che hai scelto (WhatsApp, Telegram, ecc.)
- **Dargli compiti** come "scrivimi una lista della spesa" o "ricordami di chiamare mamma"
- **Personalizzarlo** con i file di configurazione (SOUL.md, USER.md, AGENTS.md)
- **Aggiungere competenze** (le "Skill") per fargli fare cose specifiche
Il tuo agente non saprà tutto subito. Ma è come un bambino: impara da te. Più gli parli, più impara le tue abitudini, i tuoi gusti, il tuo stile.
---
## ERRORI COMUNI DEL PRIMO GIORNO (E COME RISOLVERLI)
**"Il Gateway non parte"**
Di solito è perché la porta 18789 è già occupata da qualcos'altro. Risolvi con:
```
openclaw gateway stop
openclaw gateway start
```
Prima spegni, poi riavvia. Come spegnere e riaccendere il router quando internet non funziona. Funziona sempre.
**"Non riesco a collegare WhatsApp"**
Controlla che il QR code sia ancora valido. I codici QR scadono dopo circa 60 secondi. Se scade, avvialo di nuovo e scansiona subito.
**"L'agente non risponde"**
Verifica che il Gateway sia attivo:
```
openclaw gateway status
```
Se dice "stopped", avvialo. Se dice "running" ma non risponde, controlla la connessione internet. OpenClaw ha bisogno di internet per parlare con il modello AI.
---
## IN SINTESI
L'onboarding di OpenClaw è progettato per essere fatto una sola volta. Ci vogliono circa 5-10 minuti. Dopo quello, hai un assistente AI personale che:
- Vive sul tuo computer (o su una macchina virtuale, come raccomando sempre)
- Parla con te tramite l'app che preferisci
- Impara da te nel tempo
- Può fare molto più di quanto pensi
Il passo più difficile non è tecnico. È decidere di iniziare.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'. Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento