Bot OpenClaw Não Responde? Solução em 2 Minutos
Seu bot está online mas não responde? 90% dos casos se resolvem em 2 minutos. Siga nosso fluxograma de diagnóstico rápido.
Bot Não Responde? Calma, Vamos Resolver!
💚 90% dos casos se resolvem em menos de 2 minutos.
Respire fundo. Você está no lugar certo. Siga o fluxograma abaixo.
Responda cada pergunta e siga o caminho:
openclaw gateway status
Aparece “running” ou “online”?
- ✅ Sim → Vá para pergunta 2
- ❌ Não → Solução A ← Seu problema é esse!
openclaw status
Seu canal (WhatsApp/Telegram) aparece como “connected”?
- ✅ Sim → Vá para pergunta 3
- ❌ Não → Solução B ← Seu problema é esse!
openclaw gateway logs -f
Envie uma mensagem para o bot e observe os logs.
Aparece algo como “message received” ou o texto da mensagem?
O problema: O serviço OpenClaw não está rodando.
A solução (30 segundos):
openclaw gateway start
Ou, se precisar reiniciar:
openclaw gateway restart
Verificar se funcionou:
openclaw gateway status
# Deve mostrar "running"
✅ Funcionou? Teste enviando uma mensagem. Se respondeu, problema resolvido!
❌ Ainda não? Veja erros específicos do gateway →
O problema: O WhatsApp/Telegram desconectou.
A solução depende do canal:
openclaw channel reconnect whatsapp
Se pedir QR code, escaneie com seu celular.
Dicas:
- Feche outras sessões WhatsApp Web abertas
- Escaneie o QR em menos de 30 segundos (expira rápido)
- Se persistir:
rm -rf ~/.openclaw/whatsapp-session && openclaw gateway restart
🔵 Telegram
openclaw channel reconnect telegram
Verifique se o token do bot ainda é válido. Se necessário, crie um novo token no @BotFather.
💜 Discord
openclaw channel reconnect discord
Verifique se o bot ainda está no servidor e tem as permissões corretas.
✅ Canal reconectado? Teste enviando uma mensagem.
O problema: O OpenClaw recebe a mensagem, mas algo impede a resposta.
Causas mais comuns:
🔑 1. Chave da API expirou ou está errada
openclaw doctor
Se aparecer erro de API key:
- Verifique sua chave em
~/.openclaw/config.yaml - Confirme que ainda é válida no console.anthropic.com ou platform.openai.com
- Atualize se necessário
💰 2. Créditos da API acabaram
Verifique seu saldo:
- Anthropic: console.anthropic.com/billing
- OpenAI: platform.openai.com/usage
Adicione créditos ou troque de provider.
🔇 3. Bot está configurado para ignorar suas mensagens
Verifique em config.yaml:
# Procure por filtros como:
ignoreFromMe: true # Ignora mensagens do próprio número
ignoreGroups: true # Ignora mensagens de grupos
Se você está testando do mesmo número, desative temporariamente ignoreFromMe.
⏱️ 4. Timeout na resposta da IA
A IA pode estar demorando para responder. Aumente o timeout:
# config.yaml
model:
timeout: 120 # segundos
O problema: O canal parece conectado, mas as mensagens não aparecem nos logs.
Possíveis causas:
📵 1. Sessão do WhatsApp corrompida
Resete a sessão:
rm -rf ~/.openclaw/whatsapp-session
openclaw gateway restart
Escaneie o QR code novamente.
🔒 2. Bot do Telegram com webhook incorreto
# Verificar webhook atual
curl "https://api.telegram.org/bot<SEU_TOKEN>/getWebhookInfo"
# Deletar webhook se necessário
curl "https://api.telegram.org/bot<SEU_TOKEN>/deleteWebhook"
Reinicie o gateway após.
🌐 3. Problema de rede/firewall
Verifique se seu servidor consegue acessar a internet:
curl -I https://api.anthropic.com
curl -I https://web.whatsapp.com
Se houver erro, verifique firewall/proxy.
Execute este diagnóstico completo:
# 1. Status geral
openclaw doctor
# 2. Testar envio manual
openclaw send --to "SEU_NUMERO" --text "Teste de envio"
# 3. Ver últimos logs
openclaw gateway logs --lines 50
Se o envio manual funciona mas o bot não responde automaticamente, o problema está no handler de mensagens ou filtros.
Ver logs em tempo real com debug completo
DEBUG=* openclaw gateway start
Isso mostra TUDO que está acontecendo. Procure por linhas vermelhas ou “error”.
Verificar se o processo está travado
# Ver CPU/memória do processo
top -p $(pgrep -f openclaw)
# Se CPU está em 100% por muito tempo, o processo travou
# Solução: reiniciar
openclaw gateway restart
Verificar erros não tratados
# Ver últimos erros
openclaw gateway logs | grep -i "error\|exception\|failed"
Anote os erros e procure no troubleshooting completo ou pergunte no Discord.
Antes de pedir ajuda, confirme:
- Gateway está rodando? (
openclaw gateway status) - Canal está conectado? (
openclaw status) - API key é válida? (
openclaw doctor) - Créditos disponíveis? (verifique o console do provider)
- Mensagens aparecem nos logs? (
openclaw gateway logs -f) - Teste de envio manual funciona? (
openclaw send)
Você não está sozinho! Nossa comunidade resolve problemas em minutos:
Ao pedir ajuda, inclua:
- Resultado do
openclaw doctor - Últimas 20 linhas dos logs (
openclaw gateway logs --lines 20) - Qual canal (WhatsApp/Telegram/Discord)
- O que você já tentou
Resposta em minutos, não em horas!
Talvez seu problema seja mais específico:
- Gateway Não Inicia — Erro ao iniciar o serviço
- WhatsApp Desconecta Frequentemente — Sessão instável
- Telegram Não Responde — Específico para Telegram
- Erro de Timeout — Requisição demorou demais
- Erro de API Key — Problemas de autenticação
Ótimo! Agora aproveite seu assistente:
📖 Próximos Passos → · 🎨 Personalizar SOUL.md → · 🔌 Adicionar Skills →