OpenClaw travou no chatbot? Guia rápido para resolver

Resultados esperados de um sistema saudável

• O comando

  openclaw gateway status

  deve retornar

  Runtime: running

  e

  Connectivity probe: ok

  .

• openclaw channels status --probe

  precisa mostrar o transporte conectado e, quando houver suporte, works ou

  audit ok

  .

• openclaw status

  não deve apresentar erros evidentes de autenticação ou configuração .

Se o problema começou depois de uma atualização

A documentação do OpenClaw indica que, se um canal sumiu ou o chatbot travou após uma atualização, rode

openclaw status --all

openclaw doctor --fix

openclaw gateway restart

openclaw status --all

Se aparecer a mensagem

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Foco no Telegram: causas e soluções

No caso específico de chatbots do Telegram, as falhas mais comuns são :

• Bot online, mas não responde de forma útil: execute primeiro

  openclaw pairing list telegram

  para checar o pareamento.
• Grupo em silêncio: verifique se o bot exige menção (@bot) para responder e se o "modo privacidade" (

  privacy mode

  ) está ativado nas configurações do grupo.
• Erro de rede ao acessar a API do Telegram: corrija problemas de DNS, IPv6 ou roteamento do proxy.
• Erro 401 (Unauthorized) com getMe na inicialização: o token está inválido. Atualize-o em botToken, tokenFile ou na variável de ambiente TELEGRAM_BOT_TOKEN usando um novo token do BotFather.
• Polling travado ou reconexão lenta: acompanhe com

  openclaw logs --follow

  . Se o problema persistir, a causa raiz provavelmente está no proxy, DNS ou IPv6 .

Se o próprio gateway estiver com problema

• Se openclaw estiver chamando um binário antigo por engano, corrija a variável de ambiente PATH para apontar para a instalação mais recente .
• Se o serviço do gateway estiver com a versão errada ou wrappers antigos, a recomendação é reinstalar o serviço do gateway com a versão desejada e remover wrappers/pacotes desatualizados .

Diagnóstico rápido por sintoma

• Gateway não está rodando / falha na sonda (probe): siga o caminho de correção do gateway, serviço e PATH .
• Gateway roda, mas o chatbot não responde: investigue o fluxo do canal: pareamento, exigência de menção, modo privacidade, token e rede até a API do Telegram .
• Travou logo após uma atualização: priorize

  doctor --fix

  e reinicie o gateway .
• Log com erros fatais repetidos: configuração ou plugin com defeito, não é só uma "lentidão passageira" .

Conclusão

Não fique chutando. A correção no OpenClaw começa por executar os 5 comandos base e depois tratar o problema pelo ramo certo (Telegram ou gateway) . Se puder colar a saída (umas 20 a 30 linhas) de

openclaw gateway status

openclaw channels status --probe

openclaw logs --follow