Diagnóstico rápido para bot do Telegram do OpenClaw travado

É verdade, você não deveria precisar perguntar de novo. Aqui está um roteiro para se virar sozinho.

Como isolar o problema do bot do OpenClaw no Telegram

Antes de começar a mexer nas configurações, você precisa entender que o problema pode estar em três camadas diferentes:

• O gateway/runtime está funcionando? A linha de base saudável é exibir

  Runtime: running

  e

  Connectivity probe: ok

  .
• O canal do Telegram está conectado? A sonda do canal precisa indicar que o transporte está conectado e, quando suportado, mostrar works ou

  audit ok

  .
• O token/configuração do Telegram está correto? Ao contrário de outros canais, o bot do Telegram no OpenClaw não usa o comando

  openclaw channels login telegram

  . Ele obtém o token diretamente do arquivo de configuração ou da variável de ambiente TELEGRAM_BOT_TOKEN e só depois inicia o gateway.

Se o bot simplesmente não responde (silêncio total)

A causa mais provável está em uma destas três falhas:

• O gateway/runtime não está rodando ou a sonda de conectividade falhou.
• O token do Telegram está ausente ou incorreto no arquivo de configuração ou nas variáveis de ambiente.
• O plugin do Telegram não foi carregado (um bug real já foi reportado com a mensagem exata "telegram plugin not available").

Se o bot está conectado, mas as respostas travam ou demoram

A evidência mais forte, baseada em relatos de bugs, sugere um problema no runtime do gateway, e não especificamente no token do Telegram. Um relatório aponta que as respostas do Telegram podem travar devido a um "gargalo de CPU" no gateway (CPU spin).

Ordem correta do diagnóstico

1. Verifique a saúde do runtime/gateway primeiro, antes de mexer em qualquer configuração.
2. Confira a sonda do canal para ver se o transporte do Telegram está como connected ou works.
3. Se o runtime estiver OK mas o Telegram ainda não funcionar, revise o token/configuração. Lembre-se: o bot do Telegram usa o token do arquivo de configuração ou da variável de ambiente, e não um fluxo de login interativo.
4. Se aparecer o erro "telegram plugin not available", o caminho é investigar problemas de plugin/dependência, e não o token do bot.

Pontos principais com base nas evidências

• O funcionamento do bot do Telegram no OpenClaw depende de dois pilares: gateway rodando + token no arquivo de configuração ou variável de ambiente.
• Ele não utiliza o comando

  openclaw channels login telegram

  como alguns outros canais fazem.
• Para um diagnóstico rápido, você deve olhar primeiro para runtime > sonda > canal, em vez de sair perguntando para outros usuários.

Nível de certeza

• O fluxo de diagnóstico verificando runtime/sonda/token é bem documentado e seguro para seguir.
• A questão de travamento por "CPU spin" no gateway é, até agora, apenas um relato de bug com forte correlação. Trate isso como uma hipótese muito provável, não como uma conclusão definitiva para qualquer máquina.

Resumo para o bolso: para descobrir onde o bot do Telegram do OpenClaw parou, verifique primeiro a sonda de saúde do gateway/runtime. Depois, confira o token do Telegram nas configurações. O Telegram não usa fluxo de login, ele se alimenta diretamente do token que você configurou.