dotsgpt
Circa 30 minuti

Come installare OpenClaw e collegare Telegram

Calcola circa mezz’ora per passare da una macchina appena configurata a un agente che ti risponde su Telegram. I comandi riportati provengono dalla documentazione ufficiale: confrontali con quelli della versione che installi.

Cosa ti serve

  • Un computer o VPS con macOS, Linux, WSL2 o Windows
  • Node 24.16+ o Node 26, che l’installer può aggiungere per te
  • Una chiave API o un abbonamento per un modello, oppure un modello locale
  • Un account Telegram

Passo dopo passo

  1. Scegli una macchina e crea un bot

    Un portatile va bene per una prova; per un agente sempre attivo, invece, è meglio un piccolo VPS o un server domestico. La porta del gateway non deve mai essere esposta a Internet. Su Telegram, dopo aver verificato attentamente il nome utente, scrivi a @BotFather, esegui /newbot e copia il token che ti fornisce.

  2. Installa OpenClaw

    Esegui l’installer ufficiale per il tuo sistema. Rileva il sistema operativo, aggiunge Node se manca, installa OpenClaw e avvia la configurazione iniziale.

    # macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

  3. Completa la configurazione iniziale e installa il servizio gateway

    Scegli Quick start per riutilizzare l’accesso all’IA rilevato oppure Custom setup per configurare ogni opzione. Al termine della configurazione iniziale, arresta il gateway in esecuzione in primo piano e installalo come servizio in background, così si riavvia dopo un riavvio del sistema.

    openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install

  4. Aggiungi il canale Telegram

    Aggiungi Telegram come canale usando il token del tuo bot. Poi verifica lo stato del canale per confermare che la connessione funzioni.

    openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe

  5. Approva l'associazione

    Invia un messaggio qualsiasi al tuo bot. I mittenti sconosciuti ricevono un codice di associazione anziché una risposta: elenca quindi le richieste in sospeso e approva il tuo codice entro un'ora.

    openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

  6. Esegui un controllo e aggiorna

    Esegui il controllo di sicurezza integrato e aggiorna dal canale stabile. Le versioni precedenti alla 2026.4.22 presentano vulnerabilità critiche note: non mantenerle installate.

    openclaw security audit
openclaw update --channel stable

Cosa fare subito dopo la configurazione

  • Lascia dmPolicy su pairing, così gli sconosciuti che trovano il tuo bot non potranno usarlo.
  • Imposta le approvazioni di exec su chiedi sempre finché non ti fidi della configurazione.
  • Ripeti regolarmente il controllo di sicurezza e aggiorna.

Configuratore di policy →

Errori comuni

  • Esporre la porta del gateway invece di mantenere gateway.bind su loopback e connettersi tramite SSH o Tailscale.
  • Installare troppe skill di terze parti: considerale come estensioni del browser e aggiungine solo alcune provenienti da fonti affidabili.
  • Dimenticare che un agente bloccato in un ciclo continua a consumare token del modello.
Come configurare DotsCome configurare MuseCome configurare Gemini SparkCome usare Claude come agente personale