Scénario 1 : le bot est totalement silencieux

Si vous n'obtenez absolument aucune réponse de votre bot, la cause se trouve probablement dans l'un de ces trois problèmes :

• Le gateway/runtime n'est pas en cours d'exécution, ou sa sonde de connectivité échoue .
• Le token Telegram est absent ou erroné dans la configuration ou les variables d'environnement .
• Le plugin Telegram n'a pas pu être chargé. Un ticket de bug officiel a d'ailleurs documenté exactement ce symptôme avec le message d'erreur telegram plugin not available .

Scénario 2 : le bot est connecté mais répond au ralenti ou se bloque

D'après les rapports de bugs les plus récents, ce comportement est souvent lié à un problème de runtime du gateway plutôt qu'à une simple erreur de token. Un cas documenté montre que des réponses Telegram peuvent se figer à cause d'un emballement du processeur du gateway, un phénomène appelé CPU spin . Dans ce cas, vérifier l'utilisation des ressources du processus gateway est plus pertinent que de ressaisir le token.

Procédure de résolution, étape par étape

1. Vérifiez d'abord l'état de santé du gateway/runtime, sans toucher à la configuration . Utilisez les commandes de statut pour voir si le runtime tourne et si les sondes sont au vert.
2. Contrôlez la sonde du canal pour confirmer que le transport Telegram est bien connecté et fonctionnel .
3. Si le runtime est sain mais que Telegram reste muet, passez à la vérification du token et de la configuration, en gardant à l'esprit que Telegram lit le token depuis la config ou la variable TELEGRAM_BOT_TOKEN, et non via un flux de connexion interactif .
4. Si vous rencontrez l'erreur telegram plugin not available, cela signale un souci au niveau du plugin ou de ses dépendances – le token du bot n'est probablement pas en cause. Pensez à lancer la commande de réparation openclaw doctor --fix puis à redémarrer le gateway .

En résumé

Le bot Telegram d'OpenClaw dépend de deux piliers : un gateway opérationnel et un token valide défini dans la configuration ou l'environnement . Si vous devez poser un diagnostic rapide, commencez toujours par inspecter l'état du runtime, de la sonde de connectivité et du canal. Ne multipliez pas les questions à l'utilisateur avant d'avoir écarté les causes les plus évidentes .

Niveau de certitude :

• La procédure de vérification runtime/sonde/token est clairement documentée .
• L'hypothèse du « bot bloqué par CPU spin » provient d'un rapport de bug spécifique et doit être considérée comme une piste très probable, mais pas comme une conclusion définitive pour tous les systèmes .

Scénario 1 : le bot est totalement silencieux

Si vous n'obtenez absolument aucune réponse de votre bot, la cause se trouve probablement dans l'un de ces trois problèmes :

• Le gateway/runtime n'est pas en cours d'exécution, ou sa sonde de connectivité échoue .
• Le token Telegram est absent ou erroné dans la configuration ou les variables d'environnement .
• Le plugin Telegram n'a pas pu être chargé. Un ticket de bug officiel a d'ailleurs documenté exactement ce symptôme avec le message d'erreur telegram plugin not available .

Scénario 2 : le bot est connecté mais répond au ralenti ou se bloque

D'après les rapports de bugs les plus récents, ce comportement est souvent lié à un problème de runtime du gateway plutôt qu'à une simple erreur de token. Un cas documenté montre que des réponses Telegram peuvent se figer à cause d'un emballement du processeur du gateway, un phénomène appelé CPU spin . Dans ce cas, vérifier l'utilisation des ressources du processus gateway est plus pertinent que de ressaisir le token.

Procédure de résolution, étape par étape

1. Vérifiez d'abord l'état de santé du gateway/runtime, sans toucher à la configuration . Utilisez les commandes de statut pour voir si le runtime tourne et si les sondes sont au vert.
2. Contrôlez la sonde du canal pour confirmer que le transport Telegram est bien connecté et fonctionnel .
3. Si le runtime est sain mais que Telegram reste muet, passez à la vérification du token et de la configuration, en gardant à l'esprit que Telegram lit le token depuis la config ou la variable TELEGRAM_BOT_TOKEN, et non via un flux de connexion interactif .
4. Si vous rencontrez l'erreur telegram plugin not available, cela signale un souci au niveau du plugin ou de ses dépendances – le token du bot n'est probablement pas en cause. Pensez à lancer la commande de réparation openclaw doctor --fix puis à redémarrer le gateway .

En résumé

Le bot Telegram d'OpenClaw dépend de deux piliers : un gateway opérationnel et un token valide défini dans la configuration ou l'environnement . Si vous devez poser un diagnostic rapide, commencez toujours par inspecter l'état du runtime, de la sonde de connectivité et du canal. Ne multipliez pas les questions à l'utilisateur avant d'avoir écarté les causes les plus évidentes .

Niveau de certitude :

• La procédure de vérification runtime/sonde/token est clairement documentée .
• L'hypothèse du « bot bloqué par CPU spin » provient d'un rapport de bug spécifique et doit être considérée comme une piste très probable, mais pas comme une conclusion définitive pour tous les systèmes .