OpenClaw parou no bot do Telegram? O checklist definitivo para resolver

Telegram: o que inspecionar em cada sintoma

1. Bot online, mas o grupo ignora tudo

Se o bot aparece como online e simplesmente não reage às mensagens do grupo, o vilão mais comum é a privacidade ou a exigência de menção. O documento oficial do Telegram no OpenClaw orienta :

• Verifique se o modo de privacidade do bot está desativado (use o comando /setprivacy no BotFather). Com o modo privacidade ligado, o bot só vê mensagens que começam com barra ou que o mencionam diretamente.
• Para que o bot leia todas as mensagens do grupo sem restrição, é preciso desligar o privacy mode e depois remover e recolocar o bot no grupo. Sim, a reaplicação da regra só acontece quando o bot entra novamente no chat.
• Alternativa: torne o bot administrador do grupo — isso ignora a trava de privacidade automaticamente.

2. Erro de rede ou conexão caindo

Se o log mostrar falhas de rede ao enviar mensagens, a trilha de investigação correta é checar os logs da API do Telegram e revisar as configurações de DNS, IPv6 e proxy até o endpoint api.telegram.org.

3. Token inválido (erro 401)

Quando a inicialização devolve

getMe returned 401

4. Polling engasgado ou reconexão lenta

Acompanhe

openclaw logs --follow

5. Conflito de polling — erro 409 no getUpdates

Se você ver um conflito 409, é sinal claro de que há outro processo (outro gateway OpenClaw, um script externo ou qualquer outro poller) usando o mesmo token do bot. O long polling do OpenClaw é protegido para ter apenas um poller ativo por token. Encontre e desligue o outro processo.

E se o bot quebrou depois de uma atualização?

Atualizou e o canal sumiu? A sequência de reparo prescrita é :

1. openclaw status --all

2. openclaw doctor --fix

   → esse comando é específico para limpar staging e shadows de autenticação antigos que travam o plugin.

3. openclaw gateway restart

4. openclaw status --all

   novamente para confirmar.

Se aparecer a mensagem

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Configuração correta do Telegram no OpenClaw

Um erro comum é tentar logar com

openclaw channels login telegram

channels.telegram.enabled: true

openclaw pairing list telegram

openclaw pairing approve telegram <código>

Resumo para o seu troubleshooting

Sem os logs, não dá para afirmar "o defeito é X". Mas, munido dos comandos certos, você consegue encontrar a falha. Para Telegram, seu checklist de suspeitos principais tem quatro nomes:

• Privacidade/menção (bot não lê o grupo)
• Token 401 (credencial inválida)
• DNS/IPv6/proxy (erro de rede até a API do Telegram)
• Conflito de polling 409 (outro processo usando o mesmo token)

Rode a escada de diagnóstico, compare com a baseline saudável e ataque o primeiro sintoma que aparecer fora do padrão.