Mensagens Duplicadas — Solução OpenClaw

Como resolver problema de mensagens duplicadas no OpenClaw. Causas e soluções.

Mensagens Duplicadas

O OpenClaw está enviando a mesma mensagem várias vezes? Veja como resolver.

Sintomas
  • Mesma resposta aparece 2+ vezes
  • Bot responde múltiplas vezes à mesma pergunta
  • Notificações duplicadas
Causas e Soluções1. Múltiplas Instâncias do Gateway

Causa: Mais de um gateway rodando simultaneamente.

Diagnóstico:

ps aux | grep openclaw
# Se aparecer mais de um processo, problema encontrado

Solução:

# Matar todos os processos
pkill -f openclaw

# Iniciar apenas um
openclaw gateway start
2. Webhook Chamado Múltiplas Vezes

Causa: Serviço externo reenvia webhook por timeout.

Diagnóstico:

openclaw logs | grep webhook
# Procure por timestamps muito próximos

Solução:

# config.yaml
webhooks:
  deduplication:
    enabled: true
    window_seconds: 60
3. Retry de Mensagem no Canal

Causa: WhatsApp/Telegram reenvia mensagem que “falhou”.

Solução:

# config.yaml
channels:
  deduplication:
    enabled: true
    message_id_cache: 1000
4. Loop de Resposta

Causa: Bot responde a própria mensagem.

Diagnóstico: Verifique se o bot está em grupo e respondendo a si mesmo.

Solução:

# config.yaml
channels:
  ignore_self: true
5. Heartbeat Mal Configurado

Causa: Heartbeat dispara múltiplas vezes.

Solução:

# config.yaml
heartbeat:
  interval: 5m  # Não menos que 5 minutos
  overlap_protection: true
Deduplicação ManualPor Message ID
deduplication:
  strategy: message_id
  cache_size: 1000
  ttl_seconds: 300
Por Conteúdo
deduplication:
  strategy: content_hash
  window_seconds: 60
Combinado
deduplication:
  strategy: hybrid
  message_id_cache: 1000
  content_window: 30
Verificar Logs
# Procurar duplicatas
openclaw logs | grep -E "message.*received" | uniq -d

# Ver se há múltiplos processamentos
openclaw logs | grep "processing message" | tail -50
PrevençãoConfiguração Robusta
# config.yaml completo para evitar duplicatas
deduplication:
  enabled: true
  strategy: hybrid
  message_id_cache: 1000
  content_window: 60

channels:
  ignore_self: true
  
webhooks:
  timeout: 10000
  no_retry: false
Monitoramento
# Alerta se muitas mensagens em pouco tempo
openclaw logs | grep -c "sent message" 
# Se > 100 em 1 minuto, algo errado
Casos EspecíficosWhatsApp Duplicando
  1. Verifique se só há uma sessão ativa
  2. Não abra WhatsApp Web no navegador enquanto usa OpenClaw
  3. Configure auto_reconnect para evitar sessões paralelas
Telegram Duplicando
  1. Verifique se só há um bot com esse token
  2. Configure webhook OU polling, não ambos
  3. Use drop_pending_updates: true ao iniciar
Discord Duplicando
  1. Verifique presença em múltiplos servidores
  2. Configure rate limiting apropriado
Ainda com Problemas?
  1. Pare tudo: pkill -f openclaw
  2. Limpe cache: rm -rf ~/.openclaw/cache/
  3. Reinicie limpo: openclaw gateway start
  4. Monitore: openclaw logs -f
Próximos Passos