OpenClaw não responde é uma das situações mais frustrantes depois que a instalação já funcionou uma vez. O bot estava recebendo mensagens no WhatsApp, Telegram, Slack ou terminal, mas de repente ficou mudo. A primeira reação costuma ser reinstalar tudo, apagar sessão, gerar token novo ou mexer em várias configurações ao mesmo tempo. Esse é quase sempre o caminho mais caro, porque você perde pistas importantes e pode criar um segundo problema em cima do primeiro.

O diagnóstico bom começa separando três camadas: o canal recebeu a mensagem? O gateway do OpenClaw processou a mensagem? O modelo ou ferramenta conseguiu responder? Quando você mistura essas camadas, qualquer falha parece “a IA parou”. Na prática, pode ser QR Code expirado, token de bot inválido, processo travado, limite de API, modelo local desligado, prompt esperando aprovação ou rotina de cron configurada em horário errado.

Este guia organiza uma sequência curta para descobrir por que o OpenClaw não responde sem destruir a instalação. Ele complementa o guia de instalação do OpenClaw, as páginas de canais e a seção de erros comuns. A regra principal é simples: observe antes de corrigir. Só reinicie, relogue ou troque credenciais depois de saber em qual camada o silêncio apareceu.

Primeiro: defina o tipo de silêncio

Antes de rodar comandos, descreva o sintoma em uma frase. Isso evita diagnóstico aleatório.

Os quatro cenários mais comuns são:

  1. o OpenClaw não aparece online no canal;
  2. o bot aparece online, mas não lê mensagens;
  3. o bot lê mensagens, mas não entrega resposta;
  4. o bot responde em um canal, mas não em outro.

Cada cenário aponta para uma direção diferente. Se o bot nem aparece online, investigue conexão do canal e processo. Se aparece online mas ignora mensagens, investigue permissões, allowlist, menção obrigatória ou filtro de usuário. Se lê mensagens e não responde, olhe modelo, API, fila, ferramenta externa e logs. Se só um canal falha, não mexa no modelo antes de verificar aquele canal.

Para quem usa o OpenClaw como operador de madrugada, essa distinção é ainda mais importante. Uma rotina de cron no OpenClaw pode ter executado corretamente, mas a entrega no WhatsApp falhou. Ou o canal entregou o briefing, mas uma ação ficou aguardando aprovação. Não trate todos os casos como “o agente quebrou”.

Checklist de cinco minutos

Comece pelo caminho mais barato:

openclaw status
openclaw channels status --probe
openclaw logs

Se sua versão tiver openclaw doctor, rode também:

openclaw doctor

Procure três coisas no resultado:

  • o gateway está rodando;
  • o canal usado está conectado;
  • existe erro de autenticação, conexão, rate limit ou modelo.

Não cole logs completos em grupos ou tickets públicos se eles contiverem nomes de clientes, IDs, URLs internas ou caminhos de arquivo. O ideal é copiar apenas a linha de erro e remover dados sensíveis. A página de segurança do OpenClaw explica por que credenciais, tokens e sessões não devem circular em prompt, chat ou print.

Se o gateway estiver parado, reinicie apenas o gateway:

openclaw gateway restart

Se o gateway estiver ativo e só um canal falhar, não reinstale o OpenClaw. Vá para o diagnóstico do canal.

Quando WhatsApp não responde

No WhatsApp, o problema mais comum é sessão desconectada ou instável. O bot pode ter funcionado ontem e parado hoje porque o WhatsApp Web deslogou, o celular perdeu internet, a sessão expirou ou outro dispositivo assumiu a conexão.

Verifique primeiro:

openclaw whatsapp status

Se aparecer desconectado, tente reconectar:

openclaw whatsapp reconnect

Só refaça o link quando a reconexão falhar:

openclaw whatsapp link

Apagar a sessão deve ser último recurso, não primeiro. Sessão corrompida existe, mas apagar tudo sem olhar logs pode esconder se o problema era rede, limite, permissão ou conflito de dispositivos. Leia também o erro Channel Disconnected para entender quando a falha é realmente de canal.

Outro detalhe: confirme se você está mandando mensagem para o número correto e pelo contexto correto. Em setups com número pessoal, número de teste e número de atendimento, é comum testar no canal errado. Para atendimento comercial, o guia de WhatsApp no OpenClaw ajuda a separar ambiente de teste e operação.

Quando Telegram não responde

No Telegram, o diagnóstico costuma ser mais limpo. O token do bot pode estar inválido, o bot pode ter sido removido do grupo, a conversa pode exigir /start, ou a configuração pode limitar usuários permitidos.

Cheque status:

openclaw telegram status

Depois confirme:

  • o bot existe no BotFather;
  • o token configurado é o token atual;
  • você iniciou conversa com o bot;
  • o grupo permite que o bot leia mensagens;
  • o seu usuário está autorizado, se houver allowlist.

Quando o Telegram é usado para aprovações pessoais, não libere o bot para qualquer grupo só para testar. Faça o teste em conversa direta ou grupo privado de diagnóstico. A página de Telegram é o melhor ponto de partida para revisar permissões e formato de uso.

Se Telegram responde, mas WhatsApp não, o modelo provavelmente está funcionando. Foque no canal. Se nenhum canal responde e o terminal também não gera resposta, investigue gateway, modelo e credenciais.

Quando Slack, Teams ou Discord ficam mudos

Canais de equipe têm uma causa extra: política de leitura. O bot pode estar online, mas sem permissão para ler aquele canal, sem intenção de conteúdo habilitada, fora da allowlist ou esperando menção explícita.

Pergunte:

  1. O bot foi convidado para o canal certo?
  2. A integração tem permissão de leitura e escrita no canal?
  3. Existe política exigindo menção, como @OpenClaw?
  4. A allowlist inclui o canal e o usuário?
  5. A mensagem está em thread que o bot consegue acessar?

Para times que usam o OpenClaw como mesa de decisão, vale revisar os guias de Slack com IA, Microsoft Teams com IA e Discord com IA. Eles reforçam um padrão seguro: primeiro leitura e resumo, depois rascunho, depois aprovação. Se o bot foi configurado para não agir sem aprovação, uma “não resposta” pode ser só uma política funcionando.

No Discord, sintomas como “bot conecta mas não responde” frequentemente envolvem intent de conteúdo, canal fora da allowlist ou menção obrigatória. O importante é não confundir presença online com permissão real de leitura.

Quando o modelo ou API não responde

Se os canais estão conectados e o gateway recebe mensagens, o próximo suspeito é a camada de modelo. Para API externa, procure erro de autenticação, quota, rate limit ou indisponibilidade. Para modelo local, confirme se o serviço está rodando.

Exemplos de pistas nos logs:

401 Unauthorized
rate limited
model not found
context length exceeded
connection refused
timeout

Cada uma pede resposta diferente. 401 sugere credencial inválida. rate limited sugere excesso de uso ou limite temporário. model not found sugere nome de modelo incorreto. context length exceeded sugere conversa grande demais. connection refused sugere serviço local parado, porta errada ou rede bloqueada.

As páginas de Authentication Failed, Rate Limited, Model Not Found e Connection Refused cobrem esses casos em mais detalhe. Se você usa Ollama ou outro modelo local, veja também o guia de modelos locais no OpenClaw.

Nunca resolva erro de autenticação colando API key em chat ou em arquivo compartilhado. Use variável de ambiente, gerenciador de segredos ou configuração local. Se uma chave apareceu em print ou log público, considere revogar e gerar outra.

Quando o problema é prompt, contexto ou aprovação

Nem todo silêncio é técnico. Às vezes o OpenClaw recebeu a mensagem, mas a instrução não era executável. Exemplos:

  • “resolva isso” sem fonte, prazo ou critério;
  • pedido que exige credencial não configurada;
  • ação sensível bloqueada por política de aprovação;
  • contexto grande demais para o modelo;
  • rotina de cron criada para horário diferente do esperado.

Use comandos verificáveis:

Leia as mensagens deste canal desde ontem às 18h. Entregue decisões, pendências e riscos. Não publique em outros canais.

Compare com um comando mais ambíguo:

Vê aí o que aconteceu.

O primeiro dá fonte, período, formato e limite. O segundo depende de adivinhação. Quando o OpenClaw parecer “não responder bem”, reduza o problema: peça um resumo de uma fonte, uma ação de leitura, uma saída curta. Só depois volte para fluxo completo.

Essa abordagem também ajuda em rotinas de triagem de email com IA ou Google Calendar com IA. Se o agente falha em uma rotina composta, teste primeiro cada fonte separada: email, calendário, canal e modelo.

O que não fazer

Evite estes atalhos:

  • reinstalar tudo antes de ler logs;
  • apagar sessão de WhatsApp como primeira tentativa;
  • trocar vários tokens ao mesmo tempo;
  • liberar permissões totais “só para testar”;
  • colar credenciais em prompt, print ou issue;
  • mudar modelo, canal e cron no mesmo diagnóstico;
  • concluir que a IA errou quando a ação estava aguardando aprovação.

Um diagnóstico bom muda uma variável por vez. Se você reinicia gateway, reloga WhatsApp, troca modelo, altera prompt e muda horário do cron no mesmo bloco, até pode voltar a funcionar, mas você não sabe qual era a causa. Na próxima queda, começa do zero de novo.

Roteiro seguro de recuperação

Use este roteiro quando o OpenClaw não responde:

  1. Descreva o sintoma em uma frase.
  2. Rode openclaw status e openclaw channels status --probe.
  3. Confira se o problema é canal único ou geral.
  4. Leia logs recentes e procure erro explícito.
  5. Reinicie apenas o gateway se ele estiver parado.
  6. Reconecte apenas o canal que falhou.
  7. Teste uma mensagem simples e verificável.
  8. Só depois revise credenciais, modelo, allowlist ou sessão.

Para pequenos negócios, esse cuidado evita parar uma operação inteira por causa de um erro simples. O guia da Eupresa sobre OpenClaw para MEI mostra como esse tipo de automação precisa continuar controlável mesmo quando a empresa é enxuta.

OpenClaw não responde não deve virar pânico operacional. Trate como incidente pequeno: identifique camada, colete evidência, mexa em uma coisa por vez e preserve o controle humano. O melhor agente não é o que nunca falha; é o que deixa claro onde falhou e permite voltar ao trabalho sem apagar tudo.