openclaw - 💡(How to fix) Fix Webchat: 图片上传后回复 HEARTBEAT_OK,图片消息被吞掉 [1 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#62336Fetched 2026-04-08 03:05:47
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants
RAW_BUFFERClick to expand / collapse

Bug 描述

Webchat Control UI 上传图片后,AI 回复 HEARTBEAT_OK,图片消息未被正常处理。

复现步骤

  1. 打开 OpenClaw webchat Control UI
  2. 点击上传图片按钮
  3. 选择任意图片发送
  4. 预期:AI 应识别并分析图片
  5. 实际:回复 HEARTBEAT_OK,图片未被处理

环境信息

  • OpenClaw 版本:2026.4.5(本地 npm 全局安装)
  • macOS:26.4 (arm64)
  • Node:v24.14.0
  • Gateway 版本:OpenClaw 2026.3.28
  • Channel:webchat(直接通过浏览器访问 http://127.0.0.1:18789/)
  • Gateway 状态:运行正常,其他文字消息处理正常

排查经过

  • openclaw status 显示 Gateway 运行正常,sessions 正常
  • 图片消息触发 HEARTBEAT_OK 而非图片分析
  • 初步判断:图片上传时 metadata 或格式未符合标准 Inbound 格式,触发心跳 ack 逻辑而非图片处理逻辑
  • HEARTBEAT_PROMPT 内容为默认内容,未做任何修改

附加信息

需要提供浏览器控制台截图和 network 请求日志才能进一步定位。建议在 webchat 代码中检查图片上传消息的路由逻辑。

extent analysis

TL;DR

Check the image upload message routing logic in the webchat code to ensure it conforms to the standard Inbound format.

Guidance

  • Verify the image upload message format to ensure it matches the expected standard Inbound format.
  • Check the webchat code for any discrepancies in the image upload routing logic.
  • Provide browser console screenshots and network request logs to further diagnose the issue.
  • Review the Gateway logs to see if there are any errors or warnings related to image processing.

Notes

The issue may be related to a mismatch between the image upload message format and the expected standard Inbound format, causing the HEARTBEAT_OK response instead of image processing.

Recommendation

Apply workaround: Check and modify the image upload message routing logic in the webchat code to ensure it conforms to the standard Inbound format, as this is the most likely cause of the issue.

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