# 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.

```bash
# 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.

```bash
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.

```bash
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.

```bash
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.

```bash
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.

## 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.