Come collegare OpenClaw a Telegram

Risposta breve. Crea un bot con @BotFather in Telegram (/newbot) e copia il suo token. Dai il token a OpenClaw, poi consenti di scrivergli solo al tuo ID utente Telegram numerico. Sulla tua macchina significa openclaw channels add --channel telegram --token <token> più dmPolicy: "allowlist" con il tuo ID in allowFrom. Su PlayNHost incolli il token e il tuo ID nella pagina Agente, e riavvii.

Verificato il 6 novembre 2026, valido per OpenClaw 2026.11.1.

Questa guida usa la documentazione Telegram di OpenClaw e il pannello PlayNHost così come funziona oggi. Telegram è integrato in OpenClaw: non c'è nessun plugin da installare.

Passo 1: crea il bot e copia il suo token

1. In Telegram, apri una chat con @BotFather. Controlla che il nome sia esattamente @BotFather.
2. Invia /newbot, scegli un nome visualizzato, poi uno username che finisca con bot.
3. BotFather risponde con il token, che assomiglia a 123456789:AAH.... Tienilo privato: chiunque lo abbia può controllare il tuo bot.

BotFather ha anche una web app (t.me/BotFather?startapp) che fa la stessa cosa con dei pulsanti.

Usa un bot su cui non gira nient'altro. Se un vecchio OpenClaw sul tuo portatile, o un altro programma, usa ancora lo stesso token, fermalo prima oppure crea un nuovo bot.

Passo 2: trova il tuo ID utente Telegram

La allowlist di OpenClaw vuole il tuo ID utente numerico, non il tuo @username, il numero di telefono o l'ID del bot. I modi elencati dalla documentazione di OpenClaw:

• Dal bot stesso (nessuna terza parte). Mentre il bot è in modalità pairing, mandagli un messaggio qualsiasi. La sua risposta di abbinamento include "Your Telegram user id". Su PlayNHost è il modo che suggeriamo, vedi sotto.
• Dal log di OpenClaw. Esegui openclaw logs --follow, scrivi al bot e leggi senderUserId nella voce telegram pairing request.
• L'API di Telegram. Scrivi al bot, poi apri https://api.telegram.org/bot<bot_token>/getUpdates e leggi message.from.id.
• Un bot di terze parti come @userinfobot o @getidsbot. La documentazione di OpenClaw lo giudica meno riservato.

Passo 3 su PlayNHost: incolla il token e il tuo ID

Nella stessa pagina ti serve una chiave di un provider IA. Senza, Avvia si ferma con "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token." (la console scrive in inglese).

1. Apri il tuo server su panel.playnhost.com, poi la scheda Agente.
2. Sotto Provider IA, imposta una chiave se non l'hai ancora fatto (vedi quale chiave di provider IA usare).
3. Sotto App di chat, premi Imposta su Token del bot Telegram, incolla il token di BotFather e premi Salva. Il pannello ne controlla la forma; un incolla sbagliato riceve "That is not a valid telegram bot token." Una volta salvato, la riga mostra solo gli ultimi quattro caratteri e il token non viene mai più mostrato.
4. Non conosci ancora il tuo ID? Lascia vuoto ID utente Telegram e premi Avvia. Quando l'agente è attivo, la console stampa:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Scrivi un messaggio al tuo bot in Telegram. Ti risponde una volta con un codice di abbinamento e il tuo ID utente Telegram (OpenClaw manda un codice circa una volta all'ora per persona e ignora i messaggi nel frattempo). Copia l'ID e ignora il codice: su PlayNHost non c'è nulla da approvare. Con questo passaggio non entra nessuno.
5. Sotto Chi può scrivergli, scrivi il tuo ID in ID utente Telegram e premi Salva. Più ID vanno sulla stessa riga, separati da virgole.
6. La pagina dice "Le modifiche si applicano al prossimo avvio del tuo agente." Premi Riavvia ora. La console poi conferma:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Scrivi al tuo bot. Il tuo agente risponde. I messaggi di qualsiasi altro account Telegram vengono ignorati.

Che cosa imposta PlayNHost per te

• Con degli ID nel riquadro Agente, i DM di Telegram usano dmPolicy: "allowlist" con esattamente quegli ID, come raccomanda la documentazione di OpenClaw per un bot con un solo proprietario. Senza ID usano pairing: gli sconosciuti ricevono un codice e vengono ignorati, e nessuno può approvarli senza la riga di comando o la dashboard di OpenClaw, e un server PlayNHost non offre né l'una né l'altra.
• Gli ID che elenchi diventano anche i proprietari dei comandi di OpenClaw (commands.ownerAllowFrom), quindi i comandi riservati al proprietario funzionano per te dal primo messaggio.
• Il token arriva a OpenClaw come TELEGRAM_BOT_TOKEN nel suo ambiente. Un token scritto nel file di impostazioni di OpenClaw avrebbe la precedenza, quindi l'avvio lo rimuove dal file: vale il token del riquadro Agente.
• I gruppi restano chiusi: OpenClaw non ammette nessun gruppo finché non ne viene aggiunto uno alle sue impostazioni, e un'impostazione che lasci parlare chiunque con l'agente viene riportata ai tuoi ID al prossimo avvio.

Passo 3 sulla tua macchina

1. Aggiungi il token:

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

   oppure imposta TELEGRAM_BOT_TOKEN nell'ambiente del Gateway. Un token nel file di configurazione ha la precedenza sulla variabile d'ambiente.
2. Consenti solo te stesso in ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   La parte commands ti rende il proprietario per i comandi riservati: OpenClaw non lo fa per una allowlist scritta a mano. Una allowlist con allowFrom vuoto blocca ogni DM e viene rifiutata dal controllo di configurazione di OpenClaw.
3. Oppure tieni la modalità pairing predefinita e approvati dopo il tuo primo messaggio:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   I codici scadono dopo un'ora. Anche il primo abbinamento approvato ti rende proprietario dei comandi.
4. Controlla il canale con openclaw channels status --probe.

Quando non risponde

Vuoi anche Discord? Vedi collegare OpenClaw a Discord. Non hai ancora configurato nulla? Crea un server OpenClaw.

PlayNHost non è affiliata alla OpenClaw Foundation. OpenClaw è un software open source con licenza MIT.