Telegram não responde ou parou de funcionar: como resolver
Resposta direta: se o Telegram inteiro parou de funcionar, teste outra rede, confira a página de status e atualize o aplicativo. Se apenas um bot não responde, envie /start, confirme o token no BotFather, verifique se o bot foi bloqueado e procure conflito entre webhook e polling. No OpenClaw, rode openclaw gateway status, openclaw channels status --probe e openclaw logs --follow para descobrir em qual camada a mensagem parou.
Quando o Telegram não responde, reinstalar tudo costuma ser a pior primeira tentativa. A falha pode estar em quatro lugares diferentes: aplicativo ou rede, conta e conversa, configuração do bot no Telegram ou Gateway/modelo do OpenClaw. Cada camada exige um teste diferente.
Use o diagnóstico abaixo na ordem. Ele começa por verificações que não alteram dados e deixa revogação de token, exclusão de webhook e reconexão para depois da identificação da causa.
Diagnóstico rápido: onde o Telegram parou?
| Sintoma | Causa mais provável | Primeiro teste |
|---|---|---|
| Nenhuma conversa carrega no celular | Rede, aplicativo ou indisponibilidade do Telegram | Troque Wi-Fi por dados móveis e abra outra conversa |
| Mensagens para pessoas funcionam, mas o bot não responde | Bot bloqueado, /start, token ou permissão | Abra a conversa direta e envie /start |
| O bot responde no privado, mas não no grupo | Privacy Mode, allowlist ou modo por menção | Mencione o bot e confira as permissões do grupo |
| O token funciona, mas nenhuma mensagem chega ao OpenClaw | Gateway parado, webhook/polling ou outra instância | Rode os comandos de status e consulte os logs |
| A mensagem chega, mas a IA não gera resposta | Modelo, chave de API, quota ou timeout | Teste outro canal e procure o erro do provedor nos logs |
| Respostas aparecem duplicadas ou de forma intermitente | Duas instâncias ou webhook e polling simultâneos | Pare a instância duplicada e escolha um método de entrega |
Surge erro 429 Too Many Requests | Limite de requisições | Respeite retry_after e reduza a frequência |
Se o aplicativo Telegram inteiro parou de funcionar
Antes de mexer no bot, confirme se o próprio Telegram envia e recebe mensagens comuns.
- Abra uma conversa com uma pessoa ou com Mensagens Salvas.
- Troque do Wi-Fi para dados móveis, ou faça o contrário.
- Desative temporariamente VPN, proxy ou DNS privado para testar.
- Confirme que data, hora e fuso do aparelho estão automáticos.
- Atualize o Telegram pela loja oficial e reinicie o aplicativo.
- Verifique se existe uma indisponibilidade ampla em um serviço como Downdetector.
Se nenhuma conversa funciona, o problema provavelmente não está no OpenClaw nem no token do bot. Evite revogar credenciais enquanto o serviço ou a rede estiver instável.
Se o Telegram funciona no celular, mas não no computador, revise a conexão do Telegram Desktop ou Web, saia apenas da sessão afetada e entre novamente. Não encerre todas as sessões sem necessidade.
Se apenas o bot do Telegram não responde
1. Envie /start na conversa direta
Abra o perfil do bot e toque em Iniciar ou envie:
/start
Bots não podem iniciar uma conversa privada com uma pessoa que nunca falou com eles. Se o usuário apagou a conversa, bloqueou o bot ou nunca pressionou Iniciar, o envio pode falhar mesmo que o restante da configuração esteja correto.
2. Confirme se o bot foi bloqueado
Abra o perfil do bot. Se aparecer a opção Desbloquear, use-a e envie /start novamente. Nos logs, bloqueio costuma aparecer como erro semelhante a Forbidden: bot was blocked by the user.
O bot também não consegue responder a um usuário ou grupo do qual foi removido. Confira se ele ainda aparece na lista de participantes.
3. Verifique o token com a Bot API
Use o endpoint getMe somente no seu terminal. Substitua o marcador pelo token atual e não cole o resultado em chats, issues ou prints públicos.
curl "https://api.telegram.org/bot<SEU_TOKEN>/getMe"
Uma resposta com "ok": true confirma que o token é reconhecido pela API. Os erros mais comuns são:
- 401 Unauthorized: token inválido, incompleto ou revogado;
- 404 Not Found: URL montada incorretamente;
- timeout ou falha de DNS: problema de rede no computador ou servidor;
- resposta válida, mas sem ação do bot: o defeito está depois da autenticação.
Se o token realmente vazou ou foi revogado, abra o @BotFather, use /mybots, selecione o bot e gere um novo token. Atualize o segredo no ambiente do OpenClaw e reinicie o Gateway. Não grave o token diretamente em conteúdo versionado.
Bot funciona no privado, mas não responde no grupo
Esse caso quase sempre envolve permissões ou o modo de leitura do grupo.
Mencione o bot ou use um comando
Em uma configuração segura, o bot pode responder apenas quando recebe um comando ou é mencionado:
@meuassistente_openclaw_bot resumo das últimas mensagens
Se a menção funciona, mas uma frase comum não, o bot provavelmente está em modo por menção. Isso é desejável em grupos porque reduz ruído, custo e respostas fora de contexto.
Revise o Privacy Mode no BotFather
O Privacy Mode limita quais mensagens de grupo o bot recebe. Com ele ativo, o bot normalmente vê comandos, respostas e menções dirigidas a ele, mas não toda a conversa.
Antes de desativar esse controle, pergunte se o fluxo realmente precisa ler todas as mensagens. Para resumo contínuo de um grupo privado, talvez precise; para comandos e aprovações, mantenha o modo restrito.
Confira permissões e allowlist
Verifique se o bot:
- continua no grupo;
- pode ler e enviar mensagens;
- tem permissão adicional somente quando a tarefa exige;
- está autorizado na lista de chats do OpenClaw;
- usa o identificador correto do grupo, inclusive após migração para supergrupo.
Não torne o bot administrador apenas para “ver se resolve”. Conceda o mínimo necessário e teste novamente.
OpenClaw no Telegram não responde: teste por camada
Se o Telegram e o token funcionam, descubra se a mensagem chega ao Gateway.
1. Verifique o Gateway
openclaw gateway status
Se estiver parado, inicie ou reinicie conforme sua instalação:
openclaw gateway restart
Depois rode o status novamente. Se o Gateway não inicia, siga o guia de Gateway que não inicia em vez de alterar o canal Telegram.
2. Teste a conectividade dos canais
openclaw channels status --probe
Compare Telegram com os outros canais. Se WhatsApp ou Discord responde e apenas Telegram falha, concentre-se em token, chat permitido, permissões e método de recebimento. Se todos falham, investigue Gateway, modelo e configuração geral.
3. Acompanhe os logs durante uma mensagem de teste
openclaw logs --follow
Com o comando aberto, envie /start ou uma mensagem curta ao bot. Há três resultados úteis:
- nenhum evento aparece: a atualização não chegou; investigue token, webhook, polling ou outra instância;
- a mensagem aparece, mas ocorre erro de modelo: Telegram está saudável; corrija API, quota, modelo ou timeout;
- a resposta é gerada, mas o envio falha: procure bloqueio, chat incorreto, permissão ou rate limit.
Revise logs antes de compartilhá-los. Eles podem conter identificadores de chat, usernames, trechos de mensagens e caminhos internos.
4. Rode o diagnóstico geral
openclaw doctor
Esse teste ajuda a encontrar configuração inválida, dependência ausente ou falha de modelo que parece ser problema do Telegram. Para um roteiro mais amplo, consulte OpenClaw não responde: diagnóstico rápido.
Webhook e polling em conflito
Um bot deve ter um consumidor claro para as atualizações. Se uma instalação usa polling enquanto um webhook antigo continua configurado, ou se duas instâncias usam o mesmo token, as mensagens podem sumir, atrasar ou gerar conflito.
Confira o webhook atual:
curl "https://api.telegram.org/bot<SEU_TOKEN>/getWebhookInfo"
Se sua instalação usa polling e a resposta mostra uma URL antiga, remova o webhook:
curl "https://api.telegram.org/bot<SEU_TOKEN>/deleteWebhook"
Em seguida, reinicie somente a instância correta do OpenClaw e faça um novo teste. Não use drop_pending_updates=true sem entender o efeito: essa opção descarta mensagens acumuladas que ainda não foram processadas.
Se o log mostra conflito de getUpdates, procure outro processo, container, servidor ou ambiente de teste usando o mesmo token. Pare a cópia duplicada; não tente compensar aumentando timeouts.
Erros comuns e o que fazer
401 Unauthorized
O token está incorreto ou foi revogado. Gere outro no BotFather, atualize o segredo e reinicie o Gateway. Confirme com getMe.
403 Forbidden
O bot pode ter sido bloqueado, removido do grupo ou impedido de enviar mensagens. Confirme conversa, participante e permissões.
409 Conflict
Outra instância está consumindo as atualizações por polling, ou existe conflito com webhook. Mantenha apenas um consumidor para o token.
429 Too Many Requests
A aplicação enviou mensagens rápido demais. Leia o campo retry_after, aguarde o intervalo indicado e implemente fila com recuo progressivo. Evite loops de repetição imediata, pois eles prolongam o bloqueio.
Mensagem chega, mas não há resposta da IA
Teste o modelo fora do Telegram ou em outro canal. Chave inválida, saldo esgotado, modelo indisponível e timeout são falhas da camada de IA, não da Bot API. Veja também erro de rate limit e API key inválida.
Checklist de recuperação segura
- O aplicativo Telegram envia mensagens normais.
- A conversa direta com o bot recebeu
/start. - O bot não está bloqueado nem removido do grupo.
- O token retorna
ok: trueemgetMe. - O token fica em variável de ambiente ou cofre de segredos.
- O Gateway está ativo.
-
openclaw channels status --probereconhece o Telegram. - Os logs registram a mensagem de teste.
- Existe somente uma instância usando o token.
- Webhook e polling não estão ativos de forma incompatível.
- O chat está permitido e o bot tem apenas as permissões necessárias.
- O modelo de IA responde sem erro de quota ou autenticação.
Como evitar que o bot pare novamente
Use um token diferente para produção e testes. Mantenha apenas uma instância responsável por cada token, monitore o Gateway como serviço e registre reinícios. Em grupos, prefira comandos ou menções e limite os chats autorizados.
Também vale criar uma verificação simples de saúde: status do Gateway, teste do canal e alerta em um canal alternativo quando o Telegram falhar. Para preparar a operação antes de depender do bot, use o checklist de produção para OpenClaw no WhatsApp e Telegram.
Perguntas frequentes
Por que o Telegram parou de funcionar de repente?
As causas mais comuns são rede instável, VPN ou proxy, aplicativo desatualizado e indisponibilidade temporária. Se mensagens normais funcionam e apenas o bot parou, investigue /start, bloqueio, token, permissões e a aplicação conectada ao bot.
Por que meu bot do Telegram não responde no grupo?
Ele pode estar em Privacy Mode, configurado para responder somente por menção, fora da allowlist ou sem permissão de envio. Mencione o bot, teste um comando e revise as permissões antes de torná-lo administrador.
Como saber se o token do BotFather está correto?
Chame o endpoint getMe da Bot API no terminal. Se a resposta trouxer "ok": true e os dados do bot esperado, o token é válido. Nunca publique o token nem a saída completa do comando.
Posso usar webhook e polling ao mesmo tempo?
Não para o mesmo fluxo de atualizações. Escolha um método e garanta que apenas uma instância consuma o token. Conflitos costumam causar mensagens perdidas, duplicadas ou o erro 409 Conflict.
O OpenClaw recebe a mensagem, mas não responde. O problema é o Telegram?
Provavelmente não. Se os logs mostram a mensagem entrando, o canal funcionou. Verifique modelo, chave de API, quota, timeout, ferramenta chamada e política de aprovação.
Preciso criar outro bot para resolver?
Só depois de confirmar que o token foi comprometido, o bot foi excluído ou a configuração atual ficou irrecuperável. Na maioria dos casos, corrigir token, permissões, webhook, instância duplicada ou Gateway preserva o bot existente.