Configurare Telegram in OpenClaw

Un bot Telegram è il canale più rapido da attivare, perché tutta la configurazione si riduce a un token da BotFather e a un comando che lo salva. Ecco la configurazione rapida passo passo, le regole di precedenza dei token, le impostazioni che stanno dal lato di Telegram invece che nella configurazione, e la scelta del trasporto tra long polling e webhook.

Configurazione rapida

• Entrambi i flussi di BotFather terminano con un token da incollare in OpenClaw: il flusso via chat, in cui scrivi all’account BotFather, verifichi che l’handle sia esatto, esegui il comando per il nuovo bot e salvi il token, oppure il flusso web nella web app di BotFather, che funziona in ogni client Telegram e ti permette di creare il bot da un’interfaccia e copiarne il token.
• Il modo più rapido per configurarlo è il comando channels add con il canale Telegram e il token, che scrive il token nella configurazione al posto tuo; modificare a mano significa invece un blocco Telegram con il canale abilitato, il token del bot, la policy DM pairing e una voce di gruppo con carattere jolly che richiede una menzione, e la variabile d’ambiente del token del bot è un fallback solo per l’account predefinito, dato che gli account con nome devono usare la chiave del token o un file di token.
• Con il ricaricamento a caldo predefinito, il gateway in esecuzione applica la nuova configurazione del canale, e la verifica channels status controlla che Telegram sia pronto; se il gateway è offline lo avvii come servizio gestito o nel terminale, e un ambiente di servizio modificato richiede un riavvio per essere caricato.
• Inviare un messaggio qualsiasi al bot crea la richiesta di abbinamento che il comando pairing list mostra e il comando approve accetta, con codici che scadono dopo un’ora; aggiungere il bot a un gruppo richiede poi il tuo ID utente numerico per le allowlist e l’ID della chat di gruppo come chiave sotto la mappa groups, letto dai log, da un bot che mostra l’ID dei messaggi inoltrati o dagli aggiornamenti della Bot API, e confermato con il comando whoami una volta che il gruppo è consentito; gli ID negativi dei supergruppi vanno sotto groups, mai nell’elenco dei mittenti del gruppo.

Telegram non usa openclaw channels login telegram.

I token e il lato Telegram

La risoluzione del token tiene conto dell’account: un file di token prevale sulla chiave del token del bot, la chiave del token del bot prevale sull’ambiente, la configurazione vince sempre sulla variabile d’ambiente, che si risolve solo per l’account predefinito, e dopo un avvio riuscito OpenClaw mette in cache l’identità del bot per un massimo di 24 ore, così i riavvii evitano una chiamata getMe in più, mentre un token cambiato o rimosso svuota quella cache. Dal lato di Telegram, i bot sono in modalità privacy per impostazione predefinita, il che limita i messaggi di gruppo che ricevono; per vedere tutti i messaggi di gruppo puoi disattivare la modalità privacy con il comando di BotFather per la privacy oppure rendere il bot amministratore del gruppo, e dopo aver cambiato la modalità privacy devi rimuovere e riaggiungere il bot in ogni gruppo perché Telegram applichi la modifica. Lo stato di amministratore si controlla nelle impostazioni del gruppo, e i bot amministratori ricevono tutti i messaggi del gruppo, il che si adatta a un comportamento di gruppo sempre attivo. Le opzioni utili di BotFather sono l’impostazione per l’ingresso nei gruppi, che consente o nega l’aggiunta ai gruppi, e l’impostazione della privacy per la visibilità nei gruppi, entrambe disponibili anche nella web app di BotFather.

Long polling o webhook

• Il long polling è l’impostazione predefinita; la modalità webhook richiede un URL di webhook e un segreto di webhook, con un percorso opzionale che di default è la route telegram-webhook, un host che di default è loopback, una porta che di default è 8787, e un percorso di certificato per un PEM autofirmato nelle configurazioni con IP diretto o senza dominio; il listener riserva la route health ai controlli di stato, quindi il percorso del webhook deve usare una route diversa, e una configurazione esistente su quella route deve spostarsi, aggiornare l’URL e la mappatura del reverse proxy, e verificare la modifica del listener con la verifica di stato.
• In modalità long polling, OpenClaw salva la sua posizione di ripresa dopo che un aggiornamento è stato registrato nella coda di ingresso durevole, così un handler fallito resta ritentabile da quella coda; il listener locale si mette in ascolto su loopback sulla porta 8787 per impostazione predefinita, e un ingresso pubblico significa un reverse proxy davanti a esso o un host jolly impostato di proposito.
• La modalità webhook valida le protezioni della richiesta, il token segreto di Telegram e il corpo JSON, registra l’aggiornamento nella coda durevole prima di restituire un 200 vuoto, e segnala l’acquisizione durevole riuscita con un header di consegna accettata che le risposte di health, instradamento, autenticazione, validazione ed errore di archiviazione omettono, così un reverse proxy può richiederlo invece di dedurre l’accettazione dai tempi; dopo la scrittura durevole, gli aggiornamenti vengono presi in carico ed elaborati attraverso lo svuotamento dell’ingresso centrale, con corsie per chat e per topic, e i turni lenti dell’agente non trattengono mai la conferma di consegna di Telegram.

OpenClaw su Telegram è l’articolo sul canale a cui appartiene questa configurazione, e la guida al controllo degli accessi di OpenClaw su Telegram spiega cosa decidere dopo su chi può raggiungere il bot.

Dove le configurazioni si inceppano

Quasi ogni configurazione Telegram fallita dipende da una di tre cose: un token incollato per un account con nome tramite la variabile d’ambiente che serve solo l’account predefinito, un ID di gruppo inserito nell’elenco dei mittenti invece che nella mappa groups, oppure la modalità privacy lasciata attiva con l’obbligo di menzione disattivato. La risoluzione dei problemi di Telegram in OpenClaw ripercorre quei sintomi in ordine, e la procedura guidata di cinque minuti spiega come collegare il tuo primo canale.

Su Diali

Su Diali il canale Telegram si collega dalla dashboard e la configurazione di runtime viene generata da lì e sostituita a ogni rilascio, quindi i passaggi in BotFather all’inizio di questo articolo sono la parte che resta a carico tuo. La pagina Telegram su Diali descrive il canale su Diali e la pagina sulla sicurezza di Diali il perimetro che ogni canale collegato condivide.

• Un token da BotFather; la CLI lo scrive al posto tuo.
• I codici di abbinamento scadono dopo un’ora; gli ID di gruppo vanno sotto groups.
• Long polling per impostazione predefinita; i webhook richiedono un segreto e una route libera.