Cos'è OpenClaw?
OpenClaw è un agente IA open-source che viene eseguito sul proprio computer. A differenza di ChatGPT o Claude.ai, che risiedono nel cloud e possono solo parlare, OpenClaw risiede sulla propria macchina e può agire — gestendo file, inviando messaggi, navigando il web, controllando dispositivi smart home ed eseguendo automazioni programmate.
Si interagisce con esso attraverso le app di chat che si usano già: WhatsApp, Telegram, Discord, Slack, iMessage e altro. È sempre attivo, sempre in apprendimento e sempre proprio.
Cosa Serve
- •Un computer: Mac, Windows (con WSL2) o Linux. Funziona anche un Raspberry Pi.
- •Node.js 22 o superiore: OpenClaw viene eseguito su Node.js.
- •Una chiave API IA: Da Anthropic (Claude), OpenAI (GPT) o un modello locale tramite Ollama.
- •10 minuti: È genuinamente tutto ciò che serve.
Passo 1: Installare Node.js
Se non si ha Node.js 22+, installarlo tramite nvm (Node Version Manager):
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22
Verifica: node --version dovrebbe mostrare v22.x.x o superiore.
Passo 2: Installare OpenClaw
npm install -g openclaw@latest
Oppure con pnpm:
pnpm add -g openclaw@latest
Verifica: openclaw --version dovrebbe stampare la versione installata.
Passo 3: Eseguire la Procedura Guidata di Onboarding
openclaw onboard --install-daemon
La procedura guidata accompagna attraverso:
- 1.Configurazione della chiave API: Incollare la propria chiave API Anthropic o OpenAI. Se si desidera utilizzare un modello locale, è possibile configurare Ollama in seguito.
- 2.Piattaforma di chat: Scegliere quale app di messaggistica collegare per prima. WhatsApp è la scelta più popolare — si scansionerà un codice QR per collegare il proprio account.
- 3.Installazione del daemon: Il daemon mantiene OpenClaw in esecuzione in background, anche dopo aver chiuso il terminale.
Passo 4: Dire Ciao
Aprire la propria app di chat collegata (WhatsApp, Telegram, ecc.) e inviare un messaggio al proprio agente:
> Ciao! Cosa puoi fare?
Il proprio agente risponderà con un riepilogo delle sue capacità. Provare alcune cose:
- •"Che ore sono a Tokyo?"
- •"Riassumi questo articolo: [incollare un URL]"
- •"Ricordami di chiamare la mamma alle 18 domani"
- •"Cerca sul web l'ultimo rilascio di OpenClaw"
Passo 5: Personalizzare il Proprio Agente
Impostare la sua personalità
Modificare ~/.openclaw/agents/default/SOUL.md per definire il tono e le regole del proprio agente. Ad esempio:
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.
Installare skill
Le skill sono plugin che danno al proprio agente nuove capacità:
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration
Navigare le skill disponibili sul marketplace ClawHub.
Accedere all'Interfaccia Web
OpenClaw include una dashboard web locale:
openclaw ui
Questo apre un'interfaccia nel browser dove è possibile visualizzare la cronologia delle conversazioni, gestire le skill, monitorare l'attività dell'agente e regolare le impostazioni.
Comprendere l'Architettura
Lei (telefono/laptop)
|
v
Piattaforma di Chat (WhatsApp, Telegram, Discord...)
|
v
Gateway OpenClaw (eseguito sulla propria macchina)
|
v
Modello IA (Claude, GPT, Ollama, ecc.)
|
v
Skill e Strumenti (file system, web, API, smart home...)
I propri messaggi fluiscono dalla propria app di chat al gateway OpenClaw sulla propria macchina. Il gateway invia il messaggio a un modello IA per il ragionamento, poi esegue eventuali azioni utilizzando le skill installate. La risposta fluisce indietro attraverso lo stesso percorso.
Tutto viene eseguito localmente eccetto l'inferenza del modello IA (a meno che non si utilizzi Ollama per modelli locali).
Domande Frequenti della Prima Settimana
"Perché il mio agente è lento a rispondere?" La prima risposta dopo un avvio a freddo richiede alcuni secondi mentre il modello IA carica il contesto. I messaggi successivi nella stessa conversazione sono più veloci. Se le risposte sono costantemente lente, controllare la propria connessione Internet verso il provider IA.
"Quanto mi costerà?" Un uso leggero (alcune conversazioni al giorno) costa tipicamente $10-30/mese in commissioni API. È possibile ridurre significativamente i costi utilizzando Claude Haiku o modelli locali per attività semplici.
"Posso usarlo con più app di chat contemporaneamente?" Sì. OpenClaw può essere collegato a WhatsApp, Telegram, Discord e altre piattaforme simultaneamente. I messaggi da tutte le piattaforme sono gestiti dallo stesso agente.
"È sicuro?" OpenClaw viene eseguito sulla propria macchina e si controlla tutti i dati. Mantenerlo aggiornato, rivedere le skill prima di installarle e seguire la guida alla sicurezza su docs.openclaw.ai/security.
Prossimi Passi
- •Leggere la guida SOUL.md per personalizzare la personalità del proprio agente
- •Esplorare il marketplace delle Skill per nuove capacità
- •Unirsi alla comunità Discord per aiuto e ispirazione
- •Consultare la documentazione ufficiale per la configurazione avanzata
Benvenuti nella comunità OpenClaw. La vostra aragosta è pronta.