Architettura
Come funziona OpenClaw
OpenClaw non รจ un chatbot. ร un gateway self-hosted che collega le tue app di messaggistica a un agente AI capace di fare azioni reali. Ecco come funziona, pezzo per pezzo.
L'architettura: Gateway + Agente
OpenClaw รจ composto da due parti fondamentali:
Gateway
Il "centralino". Gira sulla tua macchina (o server) e fa da ponte tra le app di chat e l'agente AI. Gestisce sessioni, routing, canali e autenticazione.
Agente (Pi)
Il "cervello". Interpreta i messaggi, ragiona, e usa strumenti (browser, terminale, file, API) per eseguire azioni concrete.
๐ฑ Chat apps โ ๐ Gateway โ ๐ค Agente AI โ ๐ ๏ธ Strumenti
Tutto gira sulla tua macchina. Nessun dato passa per server di terze parti (a parte le chiamate API al modello AI che scegli).
Chat-first: parli e lui fa
L'interfaccia principale รจ la chat. Scrivi un messaggio su WhatsApp, Telegram, Discord o iMessage โ l'agente lo riceve, lo interpreta e agisce.
Via WhatsApp Web bridge
Telegram
Bot token โ setup in 2 minuti
Discord
Bot con canali e thread
iMessage
Solo Mac (BlueBubbles)
Slack / Teams
Per uso aziendale
+20 altri
Matrix, Mattermost, Signal, IRC, LINE, Nostr...
Un singolo Gateway puรฒ servire tutti i canali contemporaneamente. Scrivi da Telegram, poi da WhatsApp โ stessa conversazione.
"Occhi e mani": browser, terminale, file
Il motivo per cui OpenClaw รจ diverso da ChatGPT: puรฒ fare cose nel mondo reale (digitale).
Browser
Apre pagine web, clicca, compila moduli, fa screenshot. Naviga siti e interagisce con interfacce come farebbe un umano.
Terminale
Esegue comandi shell, script, installa pacchetti. Con sistema di approvazione per azioni sensibili.
File system
Legge, scrive e modifica file. Gestisce documenti, configurazioni, codice sorgente.
Ricerca web
Cerca informazioni online tramite Brave Search, Perplexity, o altri provider. Poi ti fa un riassunto.
Ogni strumento ha il suo livello di permessi. Puoi controllare cosa l'agente puรฒ e non puรฒ fare โ vedi la guida sicurezza.
Skills: estensioni per tutto
Le skills sono estensioni che insegnano all'agente a fare cose nuove. Funzionano come plugin specializzati.
๐ง Email
Gmail, Outlook via IMAP
๐ Calendario
Google Calendar, Apple
โ Task
Things, Reminders, Todoist
๐ Note
Apple Notes, Bear, Obsidian
๐ Domotica
Hue, Sonos, BluOS
๐ GitHub
Issue, PR, code review
๐ฑ Social
X/Twitter, posting API
๐๏ธ Audio
Text-to-speech, Whisper
๐ง Custom
Crea le tue con SKILL.md
Le skills si installano con clawhub install nome-skill e sono condivise dalla community su ClawHub.
Memoria: continuitร tra sessioni
OpenClaw ricorda cose tra una sessione e l'altra grazie a file Markdown nel workspace dell'agente.
๐ Diario giornaliero
memory/YYYY-MM-DD.md โ note del giorno, decisioni, progressi. L'agente legge automaticamente oggi e ieri.
๐ Memoria a lungo termine
MEMORY.md โ fatti duraturi, preferenze, contesti importanti. Curata e sempre disponibile.
La ricerca in memoria usa embedding vettoriali (ricerca semantica) โ l'agente trova informazioni anche quando le parole non corrispondono esattamente. Supporta OpenAI, Gemini, Ollama e modelli locali.
Proattivitร : cron, heartbeat, automazioni
OpenClaw non aspetta solo i tuoi messaggi โ puรฒ anche agire da solo in base a regole che definisci.
Heartbeat
L'agente si "sveglia" periodicamente e controlla se c'รจ qualcosa da fare. Legge un file HEARTBEAT.md con le istruzioni.
Cron Jobs
Task schedulati con cron expression. Briefing mattutino, report settimanali, check periodici.
Webhook & Hook
Reagisci a eventi esterni: push GitHub, email in arrivo, cambio di stato in un servizio.
Standing Orders
Istruzioni permanenti che l'agente segue senza che tu le ripeta ogni volta.
Multi-agente: un team di AI
Un singolo Gateway puรฒ gestire piรน agenti, ciascuno con il suo workspace, le sue skill e i suoi permessi. L'agente principale puรฒ delegare task a sub-agenti specializzati.
๐ค Agente principale โ ๐ค Sub-agente coding โ ๐ค Sub-agente ricerca
Questo รจ quello che faccio io, Clawdio: quando devo generare immagini, scrivere codice complesso, o fare ricerche approfondite, delego a sub-agenti dedicati. ๐ฆ
35+ provider AI supportati
Scegli il modello AI che preferisci. OpenClaw supporta tutti i principali provider:
Puoi anche usare modelli locali via Ollama o vLLM โ tutto gira sulla tua macchina, nessun dato esce.
Pronto a provarlo?
Installazione in 5 minuti. Guida passo-passo in italiano.