---
title: "Mídia Não Funciona no WhatsApp"
url: "https://openclaw.ia.br/troubleshooting/whatsapp-midia-nao-funciona/"
markdown_url: "https://openclaw.ia.br/troubleshooting/whatsapp-midia-nao-funciona.MD"
description: "Resolva problemas de envio e recebimento de fotos, áudios e documentos no WhatsApp com OpenClaw."
date: "2026-02-21"
author: ""
---

# Mídia Não Funciona no WhatsApp

Resolva problemas de envio e recebimento de fotos, áudios e documentos no WhatsApp com OpenClaw.


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

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

1. **Colete logs detalhados**: `openclaw logs --level debug --tail 200 > debug.log`
2. **Verifique a versão**: `openclaw --version` — considere atualizar para a última versão
3. **Busque na comunidade**: [Discord do OpenClaw](https://discord.gg/clawd) — outros usuários podem ter resolvido
4. **Abra uma issue**: [GitHub Issues](https://github.com/openclaw/openclaw/issues) com logs e passos para reproduzir

## Artigos Relacionados

- [Troubleshooting Geral](/troubleshooting/) — índice de todos os problemas
- [Guia de Instalação](/instalacao/) — reinstalar pode resolver problemas persistentes
- [FAQ Técnico](/faq/tecnico/) — perguntas frequentes técnicas
- [Guia de Segurança](/seguranca/) — configurações de segurança