Guida a OpenClaw: l’agente AI open source spiegato
Guida della collana AIPIA riservata ai soci: 23 pagine in PDF, nell’area Risorse utili.
Di cosa parla questa guida
OpenClaw è un agente AI open source che gira sulla tua macchina e a cui parli dalle app di messaggistica che usi già: WhatsApp, Telegram, Discord, Slack.
La differenza con un chatbot sta in una parola: agisce. Riceve un’istruzione e produce effetti: legge la posta, gestisce il calendario, esegue codice, dialoga con API esterne, sempre sotto il tuo controllo.
Il principio è local-first: conversazioni, memoria e configurazione vivono in file di testo sul tuo disco, non su server di terzi. Le chiavi API dei modelli le fornisci tu; con un modello locale via Ollama i dati non lasciano la tua rete.
La guida spiega architettura, usi concreti e sicurezza passo dopo passo, senza dare per scontato che tu viva di terminale. Serve un minimo di confidenza con i comandi, non serve essere programmatori.
Come è organizzata
Parte I · Capire OpenClaw: cos’è e a cosa serve, la storia da esperimento di un weekend a fenomeno globale, perché un agente locale e open source cambia le carte.
Parte II · Come è fatto e come funziona: l’architettura a tre pezzi (Gateway, canali, modello), la memoria in file di testo, modelli cloud o locali, skill e tool, l’heartbeat, multi-agente e Canvas.
Parte III · Cosa puoi farci: requisiti e costi reali, i canali di messaggistica a confronto, casi d’uso per professionisti e tre scenari completi di installazione.
Parte IV · Sicurezza e responsabilità: i rischi documentati con i numeri, le sette regole d’oro, credenziali e dati sensibili, limiti attuali, glossario essenziale e come iniziare senza farsi male.
Tre idee dalla guida
Skill e tool: conoscenza contro capacità
Un tool è una capacità tecnica dell’agente: leggere file, scrivere, eseguire comandi, cercare sul web. Una skill è un file Markdown che gli insegna a combinare i tool per un compito specifico. La regola che conta per i permessi: installare una skill non conferisce nuove capacità tecniche. Se il tool di scrittura è disabilitato, l’agente non scrive, per quante skill abbia. Tenere separate le due cose chiarisce gran parte della sicurezza: ogni tool spento è una porta in meno da sorvegliare.
L’heartbeat: l’agente che lavora da solo
A intervalli regolari, trenta minuti di default, il Gateway sveglia l’agente. L’agente legge il file HEARTBEAT.md, scritto in italiano semplice, e decide se serve intervenire: controllare la posta e avvisarti solo per le urgenze, preparare il briefing del mattino, sorvegliare una pagina che cambia. Le activeHours limitano gli interventi a una finestra oraria, così nessun avviso alle tre di notte. Due cautele dalla guida: frequenze troppo alte consumano token senza vantaggio reale, e nel file delle istruzioni non vanno mai segreti, perché entra nel contesto del prompt.
Sette regole prima di dare poteri
I rischi sono reali e documentati: oltre 42.000 istanze esposte su Internet, skill malevole nel marketplace, vulnerabilità già corrette che colpiscono chi non aggiorna. La guida risponde con sette regole in ordine di priorità: gateway solo in locale, token casuale di almeno 32 caratteri, firewall in negazione predefinita, liste di accesso strette sui canali, sandbox per le sessioni non principali, lista bianca dei soli tool necessari, aggiornamenti settimanali. E un metodo di partenza: un compito solo, in sola lettura, con poteri di scrittura concessi un pezzo alla volta. Chi vuole costruire agenti con metodo trova nella formazione AIPIA il passo successivo.
La guida completa è dei soci
Guida a OpenClaw: l’agente AI open source spiegato: 23 pagine in PDF. Fa parte delle 12 guide estese riservate ai soci AIPIA: quella che hai letto qui sopra è l’anteprima. Il contributo associativo comprende tutte le guide riservate, le convenzioni e gli eventi per i soci.
Sei già registrato? Accedi e scarichi la guida da questa pagina.
Tutte le guide e l’Associazione
Questa risorsa fa parte dei materiali che AIPIA mette a disposizione di professionisti e community. Nell’hub trovi tutte le guide della collana; iscrivendoti sostieni la loro produzione e accedi a formazione e credenziale europea.