openclaw - 💡(How to fix) Fix WhatsApp: PDF/document media sends silently deliver text-only (v2026.4.5) [1 participants]

Only caption text arrives. No error in gateway output.

TL;DR

The issue may be resolved by adjusting the media security hardening settings in the gateway configuration to properly handle document attachments.

Guidance

• Review the media security hardening settings introduced in v2026.4.5, specifically the UNC/network path blocking and localRoots strictness, to ensure they are not interfering with document attachments.
• Verify that the media pipeline is correctly handling document attachments by checking the gateway logs for any errors or warnings related to media processing.
• Test sending image attachments to see if the issue is specific to PDFs or affects all document types.
• Investigate the createWebSendApi.sendMessage payload construction to ensure that the document buffer and metadata are correctly formatted for WhatsApp.

Example

No specific code snippet is provided as the issue seems to be related to configuration and media pipeline processing rather than code syntax.

Notes

The issue may be specific to the Windows environment and the version of OpenClaw and Baileys being used. Further investigation is needed to determine the root cause and to find a solution that works for all environments and versions.

Recommendation

Apply a workaround by adjusting the media security hardening settings to allow document attachments to be sent correctly, as the root cause seems to be related to these settings.