Manuale open-source · edizione maggio 2026

OpenClaw:
Guida Completa 🦞

Dal primo “hatch” al team multi-agente: tutto ciò che serve per padroneggiare il lobster digitale più virale del 2026. In italiano, capitolo per capitolo.

22 capitoli 8 parti + 5 appendici CC BY-SA 4.0 PDF / ePub esportabili
Mascotte lobster di OpenClaw
22capitoli + extra
3livelli di lettura
9agenti d'esempio
1progetto HomeClaw
OpenClaw non risponde soltanto: agisce. Non è un chatbot, è un dipendente digitale che esegue i tuoi task mentre dormi.
— dalla Guida Completa, Capitolo 1
A chi è rivolta

Tre livelli di lettore, segnalati su ogni capitolo

Che tu non abbia mai aperto un terminale o stia per scrivere skill personalizzate, c'è un percorso per te.

Base

Non hai mai usato il terminale, ma vuoi un assistente AI personale. Istruzioni passo-passo e concetti spiegati da zero.

★★

Intermedio

Hai già installato OpenClaw o strumenti simili e vuoi sbloccarne il pieno potenziale: workflow, integrazioni, multi-agente.

★★★

Avanzato

Sei sviluppatore o power user: skill custom, cron complessi, deploy su VPS, architettura interna del Gateway.

Come è strutturato

Otto parti, dal concetto al team di agenti

Ogni parte ha la sua sezione e i suoi capitoli numerati progressivamente da 1 a 22, più un capitolo extra e cinque appendici.

I

Capire OpenClaw

Le fondamenta concettuali: cos'è un agente autonomo e qual è la sua anatomia interna.

II

Installazione e primo setup

Scelta dell'ambiente, sandboxing, installazione e collegamento ai canali.

III

Il primo mese con OpenClaw

Dall'onboarding dell'agente ai primi workflow pronti, fino alle integrazioni.

IV

Setup multi-agente

Quando un solo agente non basta: progettare, instradare e coordinare un team.

V

Sicurezza e costi

Il modello di rischio, come difendersi e come gestire la spesa LLM.

VI

Manutenzione e ottimizzazione

Care and feeding dell'agente: diagnosi, riparazione, backup e affinamento.

VII

Uso avanzato

Skill custom, cron complessi, deploy su cloud e l'architettura del Gateway.

VIII

Visione e futuro

L'ecosistema attorno a OpenClaw e cosa significa avere un collega digitale.

+

Capitolo extra · HomeClaw

Un progetto che mette insieme tutto il libro: l'assistente vocale di casa, locale e open-source, su Raspberry Pi 5.

A–E

Appendici

Materiali di riferimento rapido da tenere a portata di mano.

Percorsi di lettura

Non sei obbligato a leggere tutto in ordine

Tre percorsi consigliati a seconda di quanto vuoi spingerti — e di quanto tempo hai.

🟢

Installare OpenClaw oggi

3–4 ore
1 → 2 → 3 → 5 → 6 → 7 → 8 → 13 → 14

Salti il capitolo Docker/sandbox per arrivare prima all'agente funzionante, ma leggi subito sicurezza e costi prima di lasciarlo correre da solo.

🟡

Un setup robusto

1 settimana
1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 13 → 14 → 15

Aggiungi il capitolo sandbox e quello sulle integrazioni: la base solida prima di automatizzare la tua vita.

🔴

Un team di agenti

2–4 settimane
tutti i capitoli, in ordine

Tutto il libro, più l'Appendice C per i template SOUL.md da cui partire per i tuoi archetipi di agente.

Un assaggio dal libro

HomeClaw: il tuo “Jarvis” locale, in un weekend

Il capitolo extra costruisce un assistente vocale domestico interamente locale — niente cloud obbligatorio, niente abbonamenti, niente pubblicità. Solo un lobster digitale che ti risponde dal salotto.

Nel 2026 Alexa ha messo la pubblicità e Google ha messo da parte l'Assistant. Dall'altra parte, lo stack voice open-source è maturato: openWakeWord, Whisper e Piper girano su un Raspberry Pi da salotto. Aggiungi un agente vero come OpenClaw e “Ehi Claw, domani vado a Milano, organizza tutto” smette di essere fantascienza.

  • Tre tier di complessità: da €130 mono-stanza a €550+ multi-stanza con satelliti ESP32-S3 e Pi Zero 2 W
  • Wyoming Protocol (wake + STT + TTS) connesso all'agente via una skill bridge in Python
  • Accelerazione su Raspberry Pi AI HAT+ 2 (Hailo-10H, 40 TOPS) per Whisper e un LLM locale
  • Onesto sui limiti: dove lo stack locale perde contro il cloud e dove bastano €130 e pazienza
Estratto · «Una mattina con HomeClaw»

Prima di parlare di cavi e systemd, vale la pena immaginare cosa cambia nella giornata quando HomeClaw funziona.

  • 6:45Il cronjob mattutino si sveglia in silenzio: legge calendario, email della notte e il meteo, e prepara un briefing in testo piano.
  • 6:58“Buongiorno.” — “Oggi alle dieci hai la call con Lorenzo. Il treno per Milano di domani è confermato. Tre email importanti, te le mando su Telegram?”
  • 7:15Il bambino: “Quanto fa sette per otto?” Lo speaker ID locale riconosce la voce e instrada la domanda a Q, l'agente educativo.
  • 7:30“Timer venti minuti.” Nessuna voce, solo il LED che pulsa verde — regola SOUL.md: comandi banali = nessuna voce.
  • 23:45A letto, sussurri “domattina sveglia alle sei e mezza.” Durante le ore di sonno i LED sono al 10%. “Va bene.” Silenzio.
«Ehi Claw, domani vado a Milano, organizza tutto» non è più fantascienza: è un weekend di setup.
— dal capitolo extra «HomeClaw»
Come usare questo libro

Leggi online, in locale, o esporta in PDF / ePub

Leggere online o in locale

Naviga le cartelle direttamente su GitHub: ogni file .md viene renderizzato e i link tra capitoli funzionano. Oppure clona il repo e aprilo in Obsidian o VS Code.

# clona e leggi in locale
git clone https://github.com/angelogeminiani/openclaw-la-guida-completa.git
cd openclaw-la-guida-completa

Esportare in PDF / ePub

Con Pandoc generi un volume unico, pronto per la stampa A5 o per il lettore ebook.

# PDF unico (richiede LaTeX)
pandoc README.md PARTE-*/[0-9]*.md \
  capitolo-extra-homeclaw.md \
  Appendici/[A-D]-*.md \
  --lua-filter=tools/strip-external-links.lua \
  -o openclaw-guida.pdf --toc --toc-depth=2

# ePub
pandoc README.md PARTE-*/[0-9]*.md \
  capitolo-extra-homeclaw.md Appendici/[A-E]-*.md \
  -o openclaw-guida.epub --toc --toc-depth=2

⚠️ Prima di iniziare: una cosa importante

OpenClaw ha accesso completo al computer su cui gira — filesystem, rete, comandi shell, browser, email, calendario. Questo lo rende potente e pericoloso.

Non installarlo mai su un computer in uso attivo o con dati sensibili: usa sempre un dispositivo dedicato o un VPS isolato. Leggi il Capitolo 13 prima di esporlo a internet o di dargli accessi in scrittura.

L'autore

Chi ha scritto questa guida

GG Gian Angelo Geminiani
Autore

Gian Angelo Geminiani

Ha installato, rotto e rimesso in piedi OpenClaw su Mac Mini, VPS e Raspberry Pi per scrivere questa guida — incluso il progetto HomeClaw da cui nasce il capitolo extra.

Profilo LinkedIn →
Aiutala a crescere 🦞

Una condivisione vale più di una stella

Questa guida vive del passaparola: bastano due secondi per darle visibilità. Non sai da dove partire? Scegli un tono e lascia che Clawdia scriva il post per te — poi lo copi o lo condividi al volo.

Clawdia · la tua copywriter aragosta

Ciao! Sono Clawdia 🦞 Scegli uno stile qui sopra e ti scrivo io il post perfetto. Poi lo copi o lo mandi dove vuoi.

Copiala o condividila:
Condividi
Ti piace?
Condividilo 🦞