Soporte de imagen y multimedia en OpenClaw

¿Alguna vez has intentado enviar un archivo a través de un bot y te has encontrado con errores de formato o límites de tamaño que no tienen sentido? Manejar multimedia en integraciones de mensajería suele ser un dolor de cabeza, sobre todo cuando tienes que gestionar la compresión y los tipos de archivos de forma manual.

OpenClaw simplifica este proceso en el canal de WhatsApp (vía Baileys Web), encargándose de la detección de tipos de archivo y el ajuste de tamaño de forma automática para que tus mensajes lleguen siempre a su destino.

Requisitos previos

• Canal de WhatsApp configurado y activo mediante Baileys Web.
• Acceso a la CLI de OpenClaw.
• Archivos locales o URLs de archivos multimedia (imágenes, audio, video o documentos).

Inicio rápido

Para enviar multimedia con un subtítulo opcional, usa el comando openclaw message send con el flag --media. Puedes usar una ruta local o una URL de internet.

openclaw message send --media <path-or-url> [--message <caption>]

Si quieres probar qué datos se enviarán sin realizar el envío real, añade el flag --dry-run. Para obtener el resultado en formato JSON, usa --json:

openclaw message send --media ./foto.jpg --message "Aquí tienes la imagen" --json

Comportamiento por tipo de archivo

El sistema procesa los archivos según su tipo:

• Imágenes: Se redimensionan y comprimen a JPEG (máximo 2048px en el lado más largo). El límite es de 6 MB.
• Audio y Video: Se envían tal cual hasta un máximo de 16 MB. El audio se envía automáticamente como una nota de voz (ptt: true).
• GIFs: Para que un video MP4 se reproduzca en bucle como un GIF en el móvil, usa el flag --gif-playback.
• Documentos: Cualquier otro tipo de archivo se envía como documento, con un límite de hasta 100 MB.

Uso en comandos (Pi)

Cuando recibes multimedia, OpenClaw descarga el archivo a una carpeta temporal y te permite usar estas variables en tus plantillas:

• {{MediaUrl}}: URL temporal del archivo.
• {{MediaPath}}: Ruta local en el servidor o sandbox.
• {{Transcript}}: Transcripción automática para archivos de audio.

Solución de problemas

• Error de media ilegible o demasiado grande: Si intentas enviar un archivo que supera los límites (6 MB para fotos, 16 MB para audio/video, 100 MB para documentos), verás un error claro en los logs y el mensaje no se enviará.
• Falta de descripción o transcripción: Si el archivo entrante supera los límites de procesamiento (10 MB imagen, 20 MB audio, 50 MB video), el sistema saltará el análisis multimedia pero el comando seguirá ejecutándose con el texto original.
• Detección de tipo incorrecta: El sistema prioriza los “magic bytes” del archivo antes que la extensión. Si un archivo no se detecta bien, verifica que el archivo no esté corrupto.

Si necesitas ayuda personalizada para configurar tu entorno, utiliza el AI Setup Assistant.

Próximos pasos

• Configuración de Auto-Reply
• Uso de variables en comandos Pi