OpenClaw non risponde sul bot Telegram: controlliamo insieme

Non abbiamo ancora elementi sufficienti per indicare una singola causa certa, ma la strada per una corretta diagnosi è chiara. La documentazione di OpenClaw indica che, quando un canale "si connette ma ha un comportamento anomalo", la prima cosa da fare è eseguire una serie di comandi in ordine preciso:

openclaw status

openclaw gateway status

openclaw logs --follow

openclaw doctor

openclaw channels status --probe

Questi comandi forniscono il "baseline di salute" del sistema. Per un gateway funzionante, il risultato atteso è:

Runtime: running

Connectivity probe: ok

audit ok

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

openclaw doctor --fix

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 .