Mídia Não Funciona no WhatsApp

Sintomas

O OpenClaw não recebe ou não processa fotos, áudios e documentos enviados via WhatsApp.

Se você está enfrentando esse problema, siga as soluções abaixo em ordem de probabilidade.

Diagnóstico Rápido

Antes de tentar as soluções, colete informações:

# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version

Soluções🔴 Mime types não configurados

Prioridade: Alta

Ative processamento de mídia: whatsapp_media: true e media_types: [image, audio, document] no config.yaml.

🔴 Modelo não suporta visão

Prioridade: Alta

Para processar imagens, use modelo multimodal: GPT-4o ou Claude 3.5 Sonnet.

🟡 Download de mídia falhando

Prioridade: Média

WhatsApp gera URLs temporárias. Configure whatsapp_media_download_timeout: 30 para mais tempo.

🟢 Tamanho máximo excedido

Prioridade: Baixa

WhatsApp limita: 16MB para imagens/áudio, 100MB para documentos. Informe o limite ao usuário.

Ainda Com Problemas?

Se nenhuma solução acima resolveu:

Colete logs detalhados: openclaw logs --level debug --tail 200 > debug.log
Verifique a versão: openclaw --version — considere atualizar para a última versão
Busque na comunidade: Discord do OpenClaw — outros usuários podem ter resolvido
Abra uma issue: GitHub Issues com logs e passos para reproduzir

📄 Mais em Troubleshooting