Cosa controllare subito per Telegram

Prima di addentrarci in problemi complessi, vediamo le cause più comuni per cui un bot Telegram configurato con OpenClaw può sembrare non funzionare.

• Il bot è online ma non scrive nei gruppi: Questo è un classico. La documentazione di OpenClaw spiega che bisogna controllare l'impostazione requireMention e la modalità privacy del bot su Telegram. Se vuoi che il bot possa leggere tutti i messaggi di un gruppo, devi disabilitare la privacy mode tramite il comando /setprivacy con @BotFather. In alternativa, puoi rendere il bot amministratore del gruppo. Dopo aver cambiato queste impostazioni, è necessario rimuovere e aggiungere di nuovo il bot al gruppo perché le modifiche abbiano effetto .
• Errore 401 all'avvio (getMe returned 401): Significa che il token del bot fornito da @BotFather è sbagliato, scaduto o revocato. La soluzione è aggiornare il botToken nel file di configurazione, nel tokenFile, o la variabile d'ambiente TELEGRAM_BOT_TOKEN .
• Errori di rete durante l'invio: Se riscontri errori di rete, la documentazione suggerisce di controllare la configurazione DNS, eventuali problemi con IPv6 e il routing del proxy verso l'API api.telegram.org .
• Polling lento o in stallo: Se il bot risponde con grande ritardo, tieni d'occhio i log con openclaw logs --follow. Se il problema persiste, le cause potrebbero nuovamente essere problemi di proxy, DNS o IPv6, poiché influenzano la capacità di mantenere una connessione di long polling stabile .
• Conflitto di polling (errore getUpdates 409): Questo errore è molto specifico. Indica che più di un processo sta usando lo stesso token bot. La documentazione ufficiale di OpenClaw per Telegram è chiara: il long polling è progettato per avere un solo poller attivo per ogni token bot. Se vedi un errore 409, significa che c'è un altro gateway OpenClaw, uno script personalizzato o un altro servizio che sta utilizzando lo stesso token .

La procedura se il bot smette di funzionare dopo un aggiornamento

Se il problema è iniziato dopo aver aggiornato OpenClaw, la procedura consigliata dai documenti è la seguente:

1. Esegui openclaw status --all.
2. Esegui openclaw doctor --fix. Questo comando è specificamente progettato per ripulire vecchi staging e "shadow auth" corrotti.
3. Riavvia il gateway con openclaw gateway restart.
4. Verifica di nuovo lo stato con openclaw status --all .

In particolare, se nel primo comando compare un messaggio come plugin load failed: dependency tree corrupted, significa che il plugin di Telegram è configurato ma il suo caricamento è fallito. Anche in questo caso, openclaw doctor --fix è lo strumento indicato per risolvere il problema prima di riavviare il gateway .

La corretta configurazione di Telegram su OpenClaw

È importante ricordare due dettagli fondamentali su come OpenClaw gestisce Telegram:

• Niente openclaw channels login telegram: A differenza di altri canali come WhatsApp, per Telegram non si usa un comando di login. Le credenziali (il token del bot) vengono lette direttamente dal file di configurazione o da una variabile d'ambiente. Devi semplicemente assicurarti che channels.telegram.enabled: true sia impostato e poi avviare il gateway .
• Approvazione dei messaggi privati: Per i messaggi diretti (DM), OpenClaw usa un sistema di "pairing" (accoppiamento). Dopo aver avviato il gateway e aver inviato un messaggio al bot, devi controllare se è richiesta un'approvazione con il comando openclaw pairing list telegram e, se necessario, approvarla con openclaw pairing approve telegram <codice> .

Conclusione: niente ipotesi, solo fatti

Con le informazioni a disposizione, è impossibile dirti con certezza "il tuo bot è rotto a causa di X". Sarebbe un'inutile supposizione.
Quello che possiamo fare è dirti con precisione cosa fare per arrivare a una soluzione. Esegui la scaletta diagnostica, partendo dai cinque comandi principali. Per il 90% dei casi legati a Telegram, il problema rientrerà in uno di questi quattro scenari: impostazioni di privacy/menzione, token bot scaduto o non valido, problemi di connettività di rete (DNS/IPv6/proxy), o un conflitto di long polling perché un altro processo sta usando lo stesso token .

Cosa controllare subito per Telegram

Prima di addentrarci in problemi complessi, vediamo le cause più comuni per cui un bot Telegram configurato con OpenClaw può sembrare non funzionare.

• Il bot è online ma non scrive nei gruppi: Questo è un classico. La documentazione di OpenClaw spiega che bisogna controllare l'impostazione requireMention e la modalità privacy del bot su Telegram. Se vuoi che il bot possa leggere tutti i messaggi di un gruppo, devi disabilitare la privacy mode tramite il comando /setprivacy con @BotFather. In alternativa, puoi rendere il bot amministratore del gruppo. Dopo aver cambiato queste impostazioni, è necessario rimuovere e aggiungere di nuovo il bot al gruppo perché le modifiche abbiano effetto .
• Errore 401 all'avvio (getMe returned 401): Significa che il token del bot fornito da @BotFather è sbagliato, scaduto o revocato. La soluzione è aggiornare il botToken nel file di configurazione, nel tokenFile, o la variabile d'ambiente TELEGRAM_BOT_TOKEN .
• Errori di rete durante l'invio: Se riscontri errori di rete, la documentazione suggerisce di controllare la configurazione DNS, eventuali problemi con IPv6 e il routing del proxy verso l'API api.telegram.org .
• Polling lento o in stallo: Se il bot risponde con grande ritardo, tieni d'occhio i log con openclaw logs --follow. Se il problema persiste, le cause potrebbero nuovamente essere problemi di proxy, DNS o IPv6, poiché influenzano la capacità di mantenere una connessione di long polling stabile .
• Conflitto di polling (errore getUpdates 409): Questo errore è molto specifico. Indica che più di un processo sta usando lo stesso token bot. La documentazione ufficiale di OpenClaw per Telegram è chiara: il long polling è progettato per avere un solo poller attivo per ogni token bot. Se vedi un errore 409, significa che c'è un altro gateway OpenClaw, uno script personalizzato o un altro servizio che sta utilizzando lo stesso token .

La procedura se il bot smette di funzionare dopo un aggiornamento

Se il problema è iniziato dopo aver aggiornato OpenClaw, la procedura consigliata dai documenti è la seguente:

1. Esegui openclaw status --all.
2. Esegui openclaw doctor --fix. Questo comando è specificamente progettato per ripulire vecchi staging e "shadow auth" corrotti.
3. Riavvia il gateway con openclaw gateway restart.
4. Verifica di nuovo lo stato con openclaw status --all .

In particolare, se nel primo comando compare un messaggio come plugin load failed: dependency tree corrupted, significa che il plugin di Telegram è configurato ma il suo caricamento è fallito. Anche in questo caso, openclaw doctor --fix è lo strumento indicato per risolvere il problema prima di riavviare il gateway .

La corretta configurazione di Telegram su OpenClaw

È importante ricordare due dettagli fondamentali su come OpenClaw gestisce Telegram:

• Niente openclaw channels login telegram: A differenza di altri canali come WhatsApp, per Telegram non si usa un comando di login. Le credenziali (il token del bot) vengono lette direttamente dal file di configurazione o da una variabile d'ambiente. Devi semplicemente assicurarti che channels.telegram.enabled: true sia impostato e poi avviare il gateway .
• Approvazione dei messaggi privati: Per i messaggi diretti (DM), OpenClaw usa un sistema di "pairing" (accoppiamento). Dopo aver avviato il gateway e aver inviato un messaggio al bot, devi controllare se è richiesta un'approvazione con il comando openclaw pairing list telegram e, se necessario, approvarla con openclaw pairing approve telegram <codice> .

Conclusione: niente ipotesi, solo fatti

Con le informazioni a disposizione, è impossibile dirti con certezza "il tuo bot è rotto a causa di X". Sarebbe un'inutile supposizione.
Quello che possiamo fare è dirti con precisione cosa fare per arrivare a una soluzione. Esegui la scaletta diagnostica, partendo dai cinque comandi principali. Per il 90% dei casi legati a Telegram, il problema rientrerà in uno di questi quattro scenari: impostazioni di privacy/menzione, token bot scaduto o non valido, problemi di connettività di rete (DNS/IPv6/proxy), o un conflitto di long polling perché un altro processo sta usando lo stesso token .