Telegram Não Recebe Mídia

Sintomas

O OpenClaw não processa fotos, vídeos ou documentos enviados via Telegram.

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🔴 File API não configurada

Prioridade: Alta

O Telegram requer download explícito. Verifique telegram_download_files: true no config.yaml.

🟡 Tamanho máximo excedido

Prioridade: Média

Telegram API tem limite de 20MB para download. Para arquivos maiores, use Telegram Bot API.

🟡 Modelo sem suporte multimodal

Prioridade: Média

Para analisar imagens, use modelo com vision: GPT-4o, Claude 3.5, Gemini 1.5.

🟢 Permissões do bot insuficientes

Prioridade: Baixa

No grupo, o bot precisa de permissão para ler mensagens de mídia.

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