• Runtime: running
• Connectivity probe: ok
• Um Capability válido (read-only, write-capable ou admin-capable)
• O probe do canal mostrando transporte conectado e, onde aplicável, as palavras works ou audit ok

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, o token que você gerou no BotFather está errado ou foi revogado. Atualize a configuração no campo botToken, tokenFile ou na variável de ambiente TELEGRAM_BOT_TOKEN da conta padrão.

4. Polling engasgado ou reconexão lenta

Acompanhe openclaw logs --follow para ver se o long polling está travando. Se o comportamento se mantiver por muito tempo, os docs indicam que a raiz quase sempre está em proxy, DNS ou IPv6 defeituosos.

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, significa que o canal está configurado, mas o carregamento do plugin quebrou. O comando openclaw doctor --fix foi feito exatamente para resolver esse problema antes de reiniciar o gateway.

Configuração correta do Telegram no OpenClaw

Um erro comum é tentar logar com openclaw channels login telegram. Não é assim que funciona. O canal Telegram do OpenClaw obtém o token diretamente da configuração ou de variável de ambiente. O procedimento correto é: habilitar channels.telegram.enabled: true, fornecer o token e iniciar o gateway.
Para mensagens diretas (DM), o sistema usa pareamento. Depois de subir o gateway, rode openclaw pairing list telegram e, se houver códigos pendentes, aprove com 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.

• Runtime: running
• Connectivity probe: ok
• Um Capability válido (read-only, write-capable ou admin-capable)
• O probe do canal mostrando transporte conectado e, onde aplicável, as palavras works ou audit ok

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, o token que você gerou no BotFather está errado ou foi revogado. Atualize a configuração no campo botToken, tokenFile ou na variável de ambiente TELEGRAM_BOT_TOKEN da conta padrão.

4. Polling engasgado ou reconexão lenta

Acompanhe openclaw logs --follow para ver se o long polling está travando. Se o comportamento se mantiver por muito tempo, os docs indicam que a raiz quase sempre está em proxy, DNS ou IPv6 defeituosos.

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, significa que o canal está configurado, mas o carregamento do plugin quebrou. O comando openclaw doctor --fix foi feito exatamente para resolver esse problema antes de reiniciar o gateway.

Configuração correta do Telegram no OpenClaw

Um erro comum é tentar logar com openclaw channels login telegram. Não é assim que funciona. O canal Telegram do OpenClaw obtém o token diretamente da configuração ou de variável de ambiente. O procedimento correto é: habilitar channels.telegram.enabled: true, fornecer o token e iniciar o gateway.
Para mensagens diretas (DM), o sistema usa pareamento. Depois de subir o gateway, rode openclaw pairing list telegram e, se houver códigos pendentes, aprove com 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.