Vai al contenuto
dots.online
Circa 30 min

Come installare OpenClaw e collegare Telegram

Bastano circa trenta minuti per passare da zero a un agente a cui puoi scrivere su Telegram. I comandi sono copiati dalla documentazione ufficiale; verificali in base alla tua versione.

Cosa ti serve

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

Passaggi

  1. 1

    Scegli dove eseguirlo

    Per provarlo basta il tuo laptop. Per un agente sempre attivo, usa un piccolo VPS o un server domestico. Non esporre la porta del gateway a internet.

  2. 2

    Installa OpenClaw

    Esegui l’installer ufficiale. Rileva il sistema operativo, installa Node se necessario, 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. 3

    Esegui la configurazione iniziale e installa il servizio

    Scegli Quick start per riutilizzare l’accesso AI rilevato oppure Custom setup per seguire la procedura completa. Poi installa il gateway come servizio in background, così continuerà a funzionare anche dopo i riavvii.

    openclaw onboard
    # after quick start, stop the foreground gateway (Ctrl+C) and install the service
    openclaw gateway install
  4. 4

    Crea un bot Telegram e aggiungilo

    Su Telegram, scrivi a @BotFather (controlla che il nome utente sia esatto), esegui /newbot e copia il token. Aggiungilo a OpenClaw e controlla lo stato del canale.

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

    Autorizza il tuo account

    Invia un messaggio qualsiasi al tuo bot. Chi scrive da un account sconosciuto riceve un codice di abbinamento invece di una risposta; approva il tuo account entro un’ora.

    openclaw pairing list telegram
    openclaw pairing approve telegram <CODE>
  6. 6

    Mettilo in sicurezza

    Esegui il controllo di sicurezza integrato e mantieni aggiornato il gateway. Le versioni precedenti alla 2026.4.22 presentano vulnerabilità critiche note.

    openclaw security audit
    openclaw update --channel stable

Consigli pratici

  • Mantieni gateway.bind sull’interfaccia di loopback e accedi tramite SSH o Tailscale, mai da una porta aperta.
  • Lascia dmPolicy impostato sull’abbinamento, così gli estranei che trovano il tuo bot non potranno usarlo.
  • Considera le competenze di terze parti come estensioni del browser: installane poche e solo da fonti affidabili.
  • Imposta le approvazioni per l’esecuzione in modo che chiedano sempre conferma, finché non ti fidi della configurazione.