openclaw - 💡(How to fix) Fix Bug: WhatsApp outbound video sends succeed but media never appears in chat [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#61970Fetched 2026-04-08 03:10:37
View on GitHub
Comments
1
Participants
2
Timeline
1
Reactions
0
Timeline (top)
commented ×1

WhatsApp outbound video delivery appears to succeed through the message tool / gateway, but the recipient never receives any visible video in chat.

Error Message

OpenClaw/gateway returns successful outbound send metadata, for example a WhatsApp messageId, but no actual visible video message reaches the recipient.

Root Cause

WhatsApp outbound video delivery appears to succeed through the message tool / gateway, but the recipient never receives any visible video in chat.

RAW_BUFFERClick to expand / collapse

Summary

WhatsApp outbound video delivery appears to succeed through the message tool / gateway, but the recipient never receives any visible video in chat.

Environment

  • OpenClaw: 2026.4.5
  • Host: Ubuntu 24.04.3 LTS
  • Channel: WhatsApp
  • Session type: direct chat
  • Gateway healthy, WhatsApp linked

Repro

  1. Generate a small MP4 video (in this case from video_generate with xai/grok-imagine-video).
  2. Copy it into the documented outbound folder:
    • /root/.openclaw/media/outbound/...mp4
  3. Send via the documented path using the message tool with filePath to WhatsApp.
  4. Gateway returns success with a WhatsApp message id.
  5. Recipient receives nothing visible in chat.

What was tried

Attempt 1

Send generated file directly from tool media path. This was incorrect for WhatsApp and was corrected.

Attempt 2

Copy file into outbound folder and send with message(... filePath=...). Gateway reported success, but nothing appeared in WhatsApp.

Attempt 3

Send with alternate media/caption style. Again reported success, still nothing visible.

Attempt 4

Inspect and re-encode to a more WhatsApp-safe MP4, then resend. Still reported success, still nothing visible.

File inspection

Original generated file had:

  • H.264 video
  • AAC audio
  • an extra attached picture stream (mjpeg, attached_pic=1)

That extra stream looked suspicious, so the file was re-encoded to a cleaner output:

  • H.264 Constrained Baseline
  • yuv420p
  • AAC audio
  • +faststart
  • only primary video + audio streams

Re-encoded file still did not appear in WhatsApp.

Observed behavior

OpenClaw/gateway returns successful outbound send metadata, for example a WhatsApp messageId, but no actual visible video message reaches the recipient.

This suggests one of:

  • WhatsApp outbound video delivery regression
  • send path reports success before provider confirms actual media delivery
  • MP4/video messages are being dropped silently somewhere in the WhatsApp adapter path

Expected behavior

If outbound send returns success for WhatsApp video, the recipient should receive a visible playable video attachment. If delivery fails, OpenClaw should surface a real error instead of reporting success.

Helpful context

A clean re-encoded MP4 under 1 MB was also tested and still failed to appear, so this does not look like just a container oddity or size issue.

If helpful, I can add exact ffprobe output and/or help test a minimal synthetic MP4 repro.

extent analysis

TL;DR

Verify the WhatsApp adapter's handling of video messages to ensure it correctly processes and delivers MP4 files.

Guidance

  • Review the WhatsApp adapter's code to check if it properly handles the filePath parameter and sends the video file correctly.
  • Inspect the network traffic or gateway logs to see if the video file is being sent to WhatsApp and if there are any errors or issues during the sending process.
  • Test sending a video file using a different method, such as the media/caption style, to see if the issue is specific to the filePath parameter.
  • Check if there are any specific requirements or restrictions for sending video files on WhatsApp, such as file size or format limitations.

Example

No specific code example can be provided without more information about the WhatsApp adapter's code and the exact implementation of the message tool.

Notes

The issue may be related to the WhatsApp adapter's handling of video messages, or it could be a problem with the message tool or the gateway. Further investigation and debugging are needed to determine the root cause of the issue.

Recommendation

Apply a workaround by testing different methods of sending video files, such as using the media/caption style, to see if the issue is specific to the filePath parameter. This can help determine if the problem is with the WhatsApp adapter or the message tool.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

If outbound send returns success for WhatsApp video, the recipient should receive a visible playable video attachment. If delivery fails, OpenClaw should surface a real error instead of reporting success.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING