OpenClaw 图片解析问题复盘
1. 问题现象
图片相关问题主要表现为两类：
Failed to download media. Please try again.- 图片收到了，但无法分析（视觉模型调用失败）
2. 根因拆分
2.1 传输层问题（下载失败）
常见与 Telegram 下载链路、代理、防火墙、网络波动相关。
2.2 推理层问题（模型不可用）
图片已经进入系统，但 image 模型不可用：
- 模型不支持图片输入
- provider 的 API key 不可用/额度不足
- provider 网络不可达
- image model 未正确配置
3. 关键认识
图片失败不是单一原因，必须先区分是"下载链路"还是"模型链路"。
4. 标准排查顺序
- 先看传输层 ：是否出现
Failed to download media - 再看模型层 ：
/status的模型是否支持image - 看配置 ：agent 的
image model是否已设置 - 看密钥与额度：对应 provider key 是否可用、是否超额
- 看网络：代理是否影响 Telegram/API 访问
5. 稳定运行建议
- 统一多 bot 的 image 模型策略（避免一个能看图、另一个不能）。
- 保持视觉模型所需 key 始终可用。
- 发生失败时先定性层级，再定位，不要混查。
- 对外回复时区分：下载失败 vs 模型失败，避免误导。
6. 一句话结论
图片问题需要双轨处理：
- 下载失败走网络/代理链路排查
- 分析失败走视觉模型
图例：
第一种情况
第二种情况
本篇小编个人记录在养虾 过程中的一些问题，仅供参考。