openclaw - 💡(How to fix) Fix WebChat: Drag-and-drop file upload not received by agent [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#71532Fetched 2026-04-26 05:11:47
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
0
Author
Participants
Timeline (top)
closed ×1commented ×1

Fix Action

Workaround

Sending file path (e.g., /Users/xxx/image.jpg) works correctly - agent can read the file.

RAW_BUFFERClick to expand / collapse

Bug Description

When a user drags and drops an image file directly into the WebChat dialog, the file appears briefly in the chat UI but then disappears. The agent receives only the text message, not the attached image.

Steps to Reproduce

  1. Open OpenClaw Control UI (webchat)
  2. Drag an image file from desktop into the chat input area
  3. Send the message (with or without accompanying text)
  4. Observe: Image appears briefly in chat, then vanishes
  5. Agent's response: "I didn't receive any image" or similar

Expected Behavior

  • The image should be attached to the message sent to the agent
  • Agent should be able to access the image via its media path

Actual Behavior

  • File IS uploaded to ~/.openclaw/media/inbound/ (confirmed by checking directory)
  • But the message reaching the agent contains only text, no media attachment
  • The media/inbound directory contains files with UUID names, confirming upload succeeded

Environment

  • OpenClaw version: 2026.4.15
  • Channel: webchat (Control UI)
  • OS: macOS

Workaround

Sending file path (e.g., /Users/xxx/image.jpg) works correctly - agent can read the file.

Additional Context

This bug makes the drag-and-drop file upload feature unusable. Users must manually provide file paths instead.

extent analysis

TL;DR

The issue can be worked around by sending the file path instead of relying on drag-and-drop, but a proper fix likely involves modifying the file upload handling in the WebChat dialog to correctly attach the uploaded image to the message.

Guidance

  • Verify that the uploaded file is correctly stored in the ~/.openclaw/media/inbound/ directory and that the file name follows the expected UUID pattern.
  • Investigate the WebChat dialog's JavaScript code responsible for handling drag-and-drop events and file uploads to ensure it correctly constructs the message with the attached image.
  • Check the server-side logic for processing incoming messages to confirm it correctly handles messages with media attachments.
  • Consider adding logging or debugging statements to track the flow of the uploaded file from the client-side upload to the server-side processing to identify where the attachment is lost.

Example

No specific code example can be provided without more details on the implementation, but the fix would involve ensuring the message object sent to the agent includes a reference to the uploaded image, such as a media path or ID.

Notes

The provided workaround of sending the file path manually indicates that the issue is specific to the drag-and-drop upload mechanism rather than a problem with file upload handling in general. The fix may require changes to both client-side (WebChat dialog) and server-side code.

Recommendation

Apply the workaround of sending the file path until a more permanent fix can be implemented, as it allows users to still share files with agents, albeit less conveniently than drag-and-drop.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix WebChat: Drag-and-drop file upload not received by agent [1 comments, 2 participants]