OpenClaw: cos’è, come installarlo e collegarlo a Telegram

OpenClaw è comparso nel mio feed lo scorso inverno, quando il progetto ha cambiato nome due volte in una settimana e ha ottenuto centinaia di migliaia di stelle su GitHub. Da allora, sempre più persone cercano «installazione di OpenClaw» e «OpenClaw Telegram».

Di seguito ripercorro la documentazione ufficiale: cos’è questo strumento, in cosa differisce da Claude Code, come installarlo su Windows, macOS o Linux, come scegliere un modello e come collegare un bot Telegram. Tratto anche la sicurezza in una sezione a parte, perché OpenClaw è stato coinvolto in un paio di incidenti di grande risonanza.

Scopri come lavorare con il servizio nella documentazione di Ailoot.

Che cos’è OpenClaw, in parole semplici?#

OpenClaw collega un modello AI al tuo bot Telegram. Con strumenti e permessi pertinenti configurati può riassumere messaggi o programmare un promemoria. Gateway e configurazione locale funzionano sul tuo computer o server. Questo non rende locali tutte le conversazioni: scegliendo un modello cloud, richiesta e contesto pertinente vengono inviati al fornitore. Tramite Ailoot, la richiesta passa da Ailoot al fornitore del modello selezionato. L’inferenza locale richiede un modello locale senza fallback cloud; i messaggi Telegram transitano comunque da Telegram e gli strumenti attivati possono contattare altri servizi.

Il progetto è sviluppato dalla community open source di OpenClaw. Il repository GitHub è stato creato il 24 novembre 2025 e, al 22 agosto 2026, ha 387 mila stelle e 81 mila fork: è uno dei progetti open source in più rapida crescita dell’anno. Il linguaggio è TypeScript.

La storia dei nomi del progetto è curiosa e vale la pena conoscerla per non confondersi leggendo articoli più vecchi. È iniziato come Warelay, un gateway per WhatsApp. Poi è diventato Clawdbot. Nel gennaio 2026, Anthropic ha chiesto di cambiare nome per una questione di marchio e il progetto è rimasto Moltbot per un paio di giorni. Il 30 gennaio 2026 ha ricevuto il suo nome definitivo: OpenClaw. Quindi, se trovi istruzioni su «Clawdbot» o «Moltbot», si tratta dello stesso progetto: quegli articoli sono stati semplicemente scritti prima del cambio di nome.

La mascotte del progetto è Molty, l’aragosta, e la muta (il cambio di guscio) è diventata la metafora ufficiale di ogni cambio di nome.

In cosa differisce OpenClaw da Claude Code e Hermes Agent?#

Mi chiedono spesso quale sia la differenza perché, dall’esterno, sembrano tutti «agenti AI». Ecco una tabella di confronto:

Come leggere la tabella. Uso Claude Code per lo sviluppo: è più efficace quando serve un modello potente e si lavora con il codice. OpenClaw e Hermes servono a un altro scopo: un agente che funziona sempre, sta su Telegram, ricorda la conversazione del giorno prima e svolge attività secondo una pianificazione. La scelta tra OpenClaw e Hermes è più sottile; c’è già una guida a Hermes con installazione e configurazione.

Se stai scegliendo uno strumento, parti dalla panoramica: con cosa si programma nel 2026 e quali attività delegare a un agente AI. Ho anche un articolo a parte sull’installazione di Claude Code.

Cosa serve prima di installare OpenClaw?#

Controlla prima la versione di Node: è l’unico requisito rigoroso:

node --version

Sono supportate le versioni 22.22.3+, 24.15+ e 25.9+; è consigliata Node 26. Se il comando restituisce «command not found» oppure la versione è vecchia, non preoccuparti: l’installer ufficiale scaricherà una versione recente di Node per te, quindi non devi installare nulla manualmente.

Resta da scegliere il modello. OpenClaw non ragiona da solo: chiama il modello che scegli. Ecco le opzioni in base al costo: una chiave Anthropic, OpenAI o Google — paghi il provider in base all’uso effettivo; oppure un modello locale tramite Ollama — non costa denaro, ma richiede hardware potente. Tratto entrambe le opzioni più avanti, in sezioni separate.

Come si installa OpenClaw su macOS e Linux?#

Il metodo consigliato è l’installer ufficiale:

1. Esegui l’installer

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Lo script rileva il sistema operativo, controlla se Node è installato (e lo installa se serve), installa OpenClaw e poi apre la procedura guidata. Se vuoi dare un’occhiata prima di avviarla, aggiungi il flag: bash -s -- --no-onboard.

2. Verifica che l’installazione sia riuscita

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Il primo comando mostra la versione, il secondo controlla la configurazione e il terzo conferma che il gateway sia in esecuzione e in ascolto sulla porta 18789.

Se usi npm e vuoi gestire l’installazione autonomamente:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

C’è un inconveniente recente, descritto in un capitolo a parte della documentazione. npm 12 blocca per impostazione predefinita gli script di installazione dei pacchetti e, senza il flag --allow-scripts=openclaw, l’installazione si interrompe con un messaggio allowScripts. Con npm 11.15 e versioni precedenti il flag non serve: questa restrizione non è ancora presente. Controlla la versione con: npm --version.

Il flag --install-daemon nel secondo comando configura l’avvio automatico: su macOS è un LaunchAgent, su Linux un servizio systemd. Questo avvia il gateway dopo un riavvio o un accesso, secondo le condizioni del gestore dei servizi. Non impedisce la sospensione e non mantiene il gateway in esecuzione a computer spento. Le risposte Telegram richiedono un host attivo e connesso alla rete; usa un server sempre acceso se devono arrivare anche quando il portatile è sospeso o spento.

Come si installa OpenClaw su Windows?#

La prima opzione è per chi preferisce le finestre del computer al terminale. Windows Hub è un’app OpenClaw nativa per Windows 10 (20H2+) e Windows 11, attualmente in versione beta. Vai alla pagina delle release di Windows Hub e scarica l’installer adatto al tuo processore: OpenClawCompanion-Setup-x64.exe per i computer standard oppure arm64 per ARM. Dopo l’installazione, OpenClaw Companion comparirà nel menu Start, con un’icona nella barra delle applicazioni, una finestra di chat e le impostazioni.

Al primo avvio, l’app proporrà «Set up locally»: accetta. Creerà un ambiente WSL dedicato chiamato OpenClawGateway, vi installerà il gateway e si collegherà ad esso. Non modificherà l’installazione di Ubuntu esistente, se ne hai una.

La seconda opzione passa da PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

La prima riga installa OpenClaw; la seconda registra l’avvio automatico tramite l’Utilità di pianificazione di Windows. Se i criteri del computer bloccano la creazione di attività, OpenClaw passerà automaticamente a un’alternativa: un collegamento nella cartella Esecuzione automatica, così il gateway si avvia quando accedi.

La terza opzione è WSL2, che la documentazione definisce l’ambiente di esecuzione più compatibile su Windows. Installa Ubuntu, abilita systemd e poi segui le istruzioni Linux della sezione precedente:

wsl --install -d Ubuntu-24.04

Dentro WSL, abilita systemd in /etc/wsl.conf (la sezione [boot], la riga systemd=true), riavvia WSL eseguendo wsl --shutdown da PowerShell, quindi installa OpenClaw con il comando Linux. Se «distribuzione» e «systemd» non ti dicono nulla, usa Windows Hub: farà tutto per te.

Come si sceglie un modello e si completa la configurazione iniziale?#

Il modello è il motore dell’assistente. La procedura guidata mostrerà un elenco di provider; ecco tre opzioni pratiche:

Un dettaglio interessante su Anthropic: se Claude Code è già installato sul tuo dispositivo e hai effettuato l’accesso, OpenClaw può usare quella sessione. Prima esegui claude auth login sul dispositivo, poi chiedi a OpenClaw di usarla:

openclaw models auth login --provider anthropic --method cli --set-default

Se il gateway funziona come servizio in background (come accade con --install-daemon), la chiave deve essere disponibile al servizio. Per farlo, inseriscila in ~/.openclaw/.env: ci pensa la procedura guidata, quindi non serve modificare il file manualmente. Dopo ogni modifica, riavvia e controlla:

openclaw gateway restart
openclaw models status

Se pagare è un problema, la soluzione è un modello locale della sezione su Ollama.

Come si collega OpenClaw a Telegram?#

Telegram è il canale più veloce da collegare: serve solo un token del bot, senza verifiche di un account aziendale. La documentazione lo definisce il modo più semplice per iniziare a scrivere all’assistente dal telefono. Ecco tutti i passaggi:

1. Crea un bot con BotFather

   Apri una chat Telegram con @BotFather (assicurati che il nome utente sia proprio quello: ci sono molti falsi), invia /newbot e scegli un nome e un nome utente che termini in bot. Riceverai un token come 123456789:ABCdef...: è la chiave del tuo bot, quindi conservalo come una password.

2. Inserisci il token in OpenClaw

   Il modo più semplice è usare la procedura guidata: esegui openclaw configure e seleziona il canale Telegram. In alternativa, puoi usare l’impostazione channels.telegram.botToken o la variabile d’ambiente TELEGRAM_BOT_TOKEN. La documentazione specifica che il comando openclaw channels login telegram non esiste: Telegram si collega solo tramite token.

3. Avvia il gateway e scrivi al bot

   openclaw gateway
   

   Apri il tuo bot su Telegram e inviagli un messaggio. Risponderà con un codice di abbinamento di otto caratteri. È una misura di sicurezza: i messaggi non verranno elaborati finché non avrai approvato il mittente.

4. Approva te stesso

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Il codice è valido per un’ora, quindi non aspettare troppo. Il primo mittente approvato diventa automaticamente il proprietario dei comandi privilegiati.

Ci sono due aspetti delicati che spesso creano problemi.

Il primo riguarda i gruppi. OpenClaw blocca tutti i gruppi per impostazione predefinita: devi autorizzare esplicitamente il bot nelle impostazioni channels.telegram.groups e lasciare attiva la modalità requireMention: true nel gruppo. Così risponderà solo quando viene chiamato con il nome utente e non si intrometterà nella conversazione generale. Anche Telegram ha la propria modalità di privacy dei bot: in un gruppo, per impostazione predefinita il bot vede solo i comandi. Disattivala con /setprivacy tramite @BotFather. Dopo averlo fatto, devi rimuovere il bot dal gruppo e aggiungerlo di nuovo; altrimenti Telegram non applicherà l’impostazione.

Il secondo è non aprire l’accesso a tutti. Le impostazioni includono la modalità dmPolicy: "open" con un asterisco nell’elenco di accesso: chiunque trovi il bot tramite il nome utente può impartirgli comandi. Per un assistente personale, questo è un modo diretto per dare a qualcun altro il controllo del tuo computer. Lascia attivo l’abbinamento tramite codice oppure inserisci il tuo ID numerico in allowFrom.

Come si usa OpenClaw con un modello locale tramite Ollama?#

Questa opzione mantiene l’inferenza del modello sul tuo hardware se scegli un percorso esclusivamente locale, senza ripiego sul cloud, e non richiede un endpoint di modello a pagamento. Non rende però locale l’intero flusso Telegram: i messaggi passano comunque attraverso Telegram e gli strumenti online attivati possono inviare dati ad altri servizi.

1. Installa Ollama

   Scarica l’installer da ollama.com/download: sono disponibili versioni per macOS, Windows e Linux.

2. Scarica un modello

   ollama pull gemma4
   

3. Collega Ollama a OpenClaw

   openclaw onboard
   

   Scegli il provider Ollama e una modalità: Local only (solo i tuoi modelli), Cloud only (modelli di ollama.com) oppure Cloud + Local. La procedura guidata troverà il server locale e mostrerà i modelli installati.

4. Verifica

   openclaw models list --provider ollama
   

Ecco la nota sincera, senza la quale questa sezione sembrerebbe una pubblicità. La documentazione di OpenClaw afferma chiaramente che per usare comodamente un agente con un modello locale serve hardware paragonabile a due Mac Studio al massimo delle prestazioni, mentre una scheda grafica da 24 GB può gestire solo richieste semplici, con ritardi. I modelli piccoli e molto compressi troncano il contesto e resistono meno alle istruzioni malevole nascoste nel testo di qualcun altro. In pratica: un modello locale su un buon portatile basta per «provarlo e capire di cosa si tratta», ma per l’uso quotidiano di un assistente che usa strumenti un modello cloud è ancora molto più affidabile.

Un altro avvertimento dalla documentazione, per chi sta configurando WSL2 + Ollama + GPU NVIDIA: l’installer ufficiale di Ollama per Linux abilita l’avvio automatico con una politica di riavvio «always» e, su WSL2 con una GPU, questo può far entrare il computer in un ciclo di riavvii. La soluzione è disabilitare l’avvio automatico del servizio. Se ti capita, consulta la sezione sulla risoluzione dei problemi nella pagina di Ollama della documentazione.

Quanto è sicuro eseguire OpenClaw?#

Parto dal punto principale, che non tutti capiscono. OpenClaw può accedere al tuo dispositivo: file, comandi e browser. La documentazione lo dice chiaramente: il progetto è pensato per un solo utente fidato e non dovresti dare a estranei l’accesso al tuo bot. Se qualcuno può scrivere al tuo agente, può usarlo per agire sul tuo computer.

Le precauzioni minime:

1. Lascia attivo l’abbinamento tramite codice oppure usa un elenco di accesso: ne ho parlato nella sezione su Telegram.
2. Non esporre il gateway all’esterno, a meno che non sia necessario. Per impostazione predefinita ascolta solo sul tuo dispositivo: lascialo così.
3. Esegui il controllo integrato dopo ogni modifica alla configurazione:

openclaw security audit

Controlla accessi aperti, autorizzazioni troppo ampie degli strumenti, token deboli e porte esposte. Con il flag --fix, alcuni problemi possono essere corretti automaticamente.

Una nota a parte sulle truffe: non è un rischio teorico. Quando il progetto ha cambiato nome in preda al panico nel gennaio 2026, i bot degli squatter si sono appropriati dei vecchi indirizzi in pochi secondi e hanno subito pubblicato un portafoglio crypto; i falsi «sviluppatori di OpenClaw» hanno iniziato a promuovere una truffa con token. Da qui derivano due regole inderogabili. Scarica OpenClaw solo da openclaw.ai o github.com/openclaw/openclaw. Inoltre, il progetto non ha una criptovaluta: qualsiasi «token OpenClaw» è una truffa. Non inviare denaro per nessun motivo.

Cosa può fare OpenClaw dopo l’installazione?#

Ecco cosa proverei, in ordine:

1. Gateway e modello. Esegui openclaw gateway status, poi apri openclaw dashboard. Il pannello caricato conferma che la Control UI è raggiungibile. Nella sua chat invia «Rispondi: model connection test» e verifica che arrivi una risposta AI; aprire la pagina da solo non verifica il modello.
2. Telegram e compito previsto. Dopo aver configurato il bot e approvato il tuo abbinamento, invia un nuovo messaggio a quel bot in Telegram e controlla che la risposta arrivi lì. Prova poi un compito limitato con un risultato visibile, per esempio riassumere una cartella innocua di cui hai autorizzato la lettura. Per un promemoria verifica separatamente la pianificazione salvata e la consegna. Una risposta nella dashboard non dimostra consegna Telegram o esecuzione programmata.
3. Attività programmate. L’assistente può eseguire attività secondo una pianificazione: un riepilogo mattutino su Telegram, controlli periodici della posta. Ecco perché tieni il gateway sempre in esecuzione.
4. Memoria. OpenClaw conserva la memoria a lungo termine in normali file Markdown nella cartella di lavoro: chi sei, come risponderti e cosa ricorda delle conversazioni precedenti. Puoi aprire i file e leggerli: non c’è alcuna scatola nera.
5. Competenze. Il progetto dispone di un catalogo di competenze e plug-in pronti all’uso, con controlli di sicurezza integrati. Una competenza creata da qualcun altro è codice di qualcun altro sul tuo dispositivo, ecco perché il catalogo le controlla.

C’è una regola: non attivare tutto in una volta. Inizia con una conversazione stabile, poi Telegram e infine le attività programmate. Così ogni problema emerge al proprio passaggio, invece di ritrovarti a dire «si è rotto tutto e non so perché».

Cosa fare se l’installazione non va a buon fine?#

Vediamo tre scenari comuni.

Subito dopo l’installazione compare «openclaw: command not found». Quasi sempre è un problema di percorso: la cartella dei pacchetti npm globali non è inclusa nel PATH del terminale. I comandi diagnostici indicati dalla documentazione sono:

node -v
npm prefix -g
echo "$PATH"

Il percorso restituito dal secondo comando dovrebbe comparire nel terzo. Se non c’è, aggiungilo alle impostazioni della shell oppure chiudi e riapri il terminale: a volte il percorso di Node compare solo in una nuova sessione dopo l’installazione.

Il gateway è in esecuzione, ma l’assistente non risponde. Il sintomo descritto nelle FAQ della documentazione: il primo messaggio non riceve risposta e il contatore dei token è a zero. Significa che l’agente non è nemmeno partito: spesso il modello non è configurato. Controlla in quest’ordine:

openclaw gateway restart
openclaw status
openclaw models status

Se il modello è configurato ma non ricevi ancora risposta, openclaw logs --follow mostra il registro in tempo reale e il punto in cui il processo si blocca.

Il bot Telegram non risponde. Controlla in quest’ordine: che il token appartenga al bot a cui stai scrivendo; che il gateway sia in esecuzione (openclaw gateway status); e che il tuo abbinamento sia stato approvato (openclaw pairing list telegram). Un codice di abbinamento è valido per un’ora: se hai scritto al bot ieri, mandagli semplicemente un altro messaggio e approva il nuovo codice.

Se sei completamente bloccato, la documentazione suggerisce una soluzione inattesa ma sensata: fornire i dati diagnostici a un agente AI locale che possa vedere il tuo dispositivo. Claude Code o Codex, con l’output di openclaw status --all e openclaw doctor, possono interpretare la configurazione più rapidamente di una chat con l’assistenza. Un cerchio che si chiude: l’AI risolve i problemi dell’AI.

Cos’altro chiedono spesso su OpenClaw?#

Scopri Ailoot.