---
title: "Bot OpenClaw Não Responde? Solução em 2 Minutos"
url: "https://openclaw.ia.br/troubleshooting/bot-nao-responde/"
markdown_url: "https://openclaw.ia.br/troubleshooting/bot-nao-responde.MD"
description: "Seu bot está online mas não responde? 90% dos casos se resolvem em 2 minutos. Siga nosso fluxograma de diagnóstico rápido."
date: ""
author: ""
---

# 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!

<div class="reassurance-box" style="background: linear-gradient(135deg, #ecfdf5 0%, #d1fae5 100%); border: 2px solid #10b981; border-radius: 1rem; padding: 1.5rem; margin: 1.5rem 0; text-align: center;">

** 90% dos casos se resolvem em menos de 2 minutos.**

Respire fundo. Você está no lugar certo. Siga o fluxograma abaixo.

</div>

---

##  Fluxograma de Diagnóstico Rápido

Responda cada pergunta e siga o caminho:

<div class="flowchart" style="background: #f8fafc; border: 2px solid #e2e8f0; border-radius: 1rem; padding: 1.5rem; margin: 1.5rem 0;">

### 1 O Gateway está rodando?

```bash
openclaw gateway status
```

**Aparece "running" ou "online"?**
- ✅ **Sim** → Vá para pergunta 2
- ❌ **Não** → [**Solução A**](#solução-a-gateway-parado) ← Seu problema é esse!

---

### 2 O canal está conectado?

```bash
openclaw status
```

**Seu canal (WhatsApp/Telegram) aparece como "connected"?**
- ✅ **Sim** → Vá para pergunta 3
- ❌ **Não** → [**Solução B**](#solução-b-canal-desconectado) ← Seu problema é esse!

---

### 3 As mensagens aparecem nos logs?

```bash
openclaw gateway logs -f
```

Envie uma mensagem para o bot e observe os logs.

**Aparece algo como "message received" ou o texto da mensagem?**
- ✅ **Sim** → [**Solução C**](#solução-c-mensagem-chega-mas-não-responde) ← A mensagem chega, problema é na resposta
- ❌ **Não** → [**Solução D**](#solução-d-mensagem-não-chega) ← A mensagem nem chega

</div>

---

## ⚡ Soluções Rápidas (em ordem de frequência)

---

### Solução A: Gateway Parado

**O problema:** O serviço OpenClaw não está rodando.

**A solução (30 segundos):**

```bash
openclaw gateway start
```

Ou, se precisar reiniciar:

```bash
openclaw gateway restart
```

**Verificar se funcionou:**
```bash
openclaw gateway status
# Deve mostrar "running"
```

<div class="success-check" style="background: #f0fdf4; border: 1px solid #86efac; border-radius: 0.5rem; padding: 0.75rem; margin: 0.5rem 0;">

✅ **Funcionou?** Teste enviando uma mensagem. Se respondeu, problema resolvido!

❌ **Ainda não?** [Veja erros específicos do gateway →](/troubleshooting/gateway-nao-inicia/)

</div>

---

### Solução B: Canal Desconectado

**O problema:** O WhatsApp/Telegram desconectou.

**A solução depende do canal:**

<details open>
<summary><strong> WhatsApp</strong></summary>

```bash
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`

</details>

<details>
<summary><strong> Telegram</strong></summary>

```bash
openclaw channel reconnect telegram
```

Verifique se o token do bot ainda é válido. Se necessário, crie um novo token no [@BotFather](https://t.me/BotFather).

</details>

<details>
<summary><strong> Discord</strong></summary>

```bash
openclaw channel reconnect discord
```

Verifique se o bot ainda está no servidor e tem as permissões corretas.

</details>

<div class="success-check" style="background: #f0fdf4; border: 1px solid #86efac; border-radius: 0.5rem; padding: 0.75rem; margin: 0.5rem 0;">

✅ **Canal reconectado?** Teste enviando uma mensagem.

</div>

---

### Solução C: Mensagem Chega Mas Não Responde

**O problema:** O OpenClaw recebe a mensagem, mas algo impede a resposta.

**Causas mais comuns:**

<details open>
<summary><strong> 1. Chave da API expirou ou está errada</strong></summary>

```bash
openclaw doctor
```

Se aparecer erro de API key:
1. Verifique sua chave em `~/.openclaw/config.yaml`
2. Confirme que ainda é válida no [console.anthropic.com](https://console.anthropic.com/) ou [platform.openai.com](https://platform.openai.com/)
3. Atualize se necessário

</details>

<details>
<summary><strong> 2. Créditos da API acabaram</strong></summary>

Verifique seu saldo:
- **Anthropic:** [console.anthropic.com/billing](https://console.anthropic.com/billing)
- **OpenAI:** [platform.openai.com/usage](https://platform.openai.com/usage)

Adicione créditos ou troque de provider.

</details>

<details>
<summary><strong> 3. Bot está configurado para ignorar suas mensagens</strong></summary>

Verifique em `config.yaml`:
```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`.

</details>

<details>
<summary><strong>⏱ 4. Timeout na resposta da IA</strong></summary>

A IA pode estar demorando para responder. Aumente o timeout:

```yaml
# config.yaml
model:
  timeout: 120  # segundos
```

</details>

---

### Solução D: Mensagem Não Chega

**O problema:** O canal parece conectado, mas as mensagens não aparecem nos logs.

**Possíveis causas:**

<details open>
<summary><strong> 1. Sessão do WhatsApp corrompida</strong></summary>

Resete a sessão:

```bash
rm -rf ~/.openclaw/whatsapp-session
openclaw gateway restart
```

Escaneie o QR code novamente.

</details>

<details>
<summary><strong> 2. Bot do Telegram com webhook incorreto</strong></summary>

```bash
# 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.

</details>

<details>
<summary><strong> 3. Problema de rede/firewall</strong></summary>

Verifique se seu servidor consegue acessar a internet:

```bash
curl -I https://api.anthropic.com
curl -I https://web.whatsapp.com
```

Se houver erro, verifique firewall/proxy.

</details>

---

##  Teste Rápido de Sanidade

Execute este diagnóstico completo:

```bash
# 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.

---

##  Diagnóstico Avançado

<details>
<summary><strong>Ver logs em tempo real com debug completo</strong></summary>

```bash
DEBUG=* openclaw gateway start
```

Isso mostra TUDO que está acontecendo. Procure por linhas vermelhas ou "error".

</details>

<details>
<summary><strong>Verificar se o processo está travado</strong></summary>

```bash
# 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
```

</details>

<details>
<summary><strong>Verificar erros não tratados</strong></summary>

```bash
# Ver últimos erros
openclaw gateway logs | grep -i "error\|exception\|failed"
```

Anote os erros e procure no [troubleshooting completo](/troubleshooting/) ou pergunte no Discord.

</details>

---

## ✅ Checklist Final

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`)

---

<div class="help-box" style="background: linear-gradient(135deg, #7c3aed 0%, #a855f7 100%); color: white; padding: 2rem; border-radius: 1rem; margin: 2rem 0;">

## 🆘 Ainda Não Funcionou?

**Você não está sozinho!** Nossa comunidade resolve problemas em minutos:

<div style="text-align: center; margin: 1.5rem 0;">

**[ Entrar no Discord →](https://discord.gg/clawd)**

</div>

Ao pedir ajuda, inclua:
1. Resultado do `openclaw doctor`
2. Últimas 20 linhas dos logs (`openclaw gateway logs --lines 20`)
3. Qual canal (WhatsApp/Telegram/Discord)
4. O que você já tentou

**Resposta em minutos, não em horas!**

</div>

---

##  Problemas Relacionados

Talvez seu problema seja mais específico:

- [Gateway Não Inicia](/troubleshooting/gateway-nao-inicia/) — Erro ao iniciar o serviço
- [WhatsApp Desconecta Frequentemente](/troubleshooting/whatsapp-desconecta/) — Sessão instável
- [Telegram Não Responde](/troubleshooting/telegram-nao-responde/) — Específico para Telegram
- [Erro de Timeout](/erros/timeout/) — Requisição demorou demais
- [Erro de API Key](/erros/api-key/) — Problemas de autenticação

---

<div class="next-steps" style="background: #f0fdf4; border: 2px solid #22c55e; border-radius: 1rem; padding: 1.5rem; margin: 2rem 0; text-align: center;">

###  Problema Resolvido?

**Ótimo!** Agora aproveite seu assistente:

[ Próximos Passos →](/guias/pos-instalacao/) · [ Personalizar SOUL.md →](/tutoriais/personalizar-soul/) · [ Adicionar Skills →](/skills/)

</div>