Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix Bug: Image tool reports 'Unknown model' for all custom providers [2 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#70180•Fetched 2026-04-23 07:28:11
View on GitHub
Comments
2
Participants
2
Timeline
2
Reactions
0
Author
Ezio0Ezio0
Participants
Ezio0Ezio0steipetesteipete
Timeline (top)
commented ×2

The image tool consistently returns Unknown model for any custom provider configured in models.json or openclaw.json. Only built-in providers (openai, anthropic, google) appear to work.

Error Message

  1. Observe the error: Unknown model: astroncodingplan/astron-code-latest

Root Cause

The image tool consistently returns Unknown model for any custom provider configured in models.json or openclaw.json. Only built-in providers (openai, anthropic, google) appear to work.

Fix Action

Workaround

Using Python to call the provider API directly for image analysis, bypassing the OpenClaw image tool.

Code Example

[media-understanding] image: failed (0/1) reason=Model does not support images
[tools] image failed: Unknown model: astroncodingplan/astron-code-latest
[tools] image failed: Unknown model: minimax-portal/MiniMax-M2.7-highspeed
[tools] image failed: Unknown model: volcengine-plan/doubao-seed-2.0-pro
[tools] image failed: Unknown model: bailian/kimi-k2.5
[tools] image failed: Unknown model: dashscope/qwen-vl-max

---

[tools] image failed: Unknown model: openai/astron-code-latest
RAW_BUFFERClick to expand / collapse

Description

The image tool consistently returns Unknown model for any custom provider configured in models.json or openclaw.json. Only built-in providers (openai, anthropic, google) appear to work.

Environment

  • OpenClaw version: 2026.4.21 (f788c88)
  • OS: macOS 15.4 (arm64)
  • Node: v24.5.0

Steps to Reproduce

  1. Configure a custom provider (e.g., astroncodingplan, minimax-portal, volcengine-plan, bailian) with input: ["text", "image"] in models.json
  2. Set agents.defaults.imageModel.primary to a custom provider model (e.g., astroncodingplan/astron-code-latest)
  3. Send an image to the agent
  4. Observe the error: Unknown model: astroncodingplan/astron-code-latest

Expected Behavior

The image tool should resolve and use custom provider models just like the text chat model does.

Actual Behavior

All custom provider models return Unknown model. The logs show:

[media-understanding] image: failed (0/1) reason=Model does not support images
[tools] image failed: Unknown model: astroncodingplan/astron-code-latest
[tools] image failed: Unknown model: minimax-portal/MiniMax-M2.7-highspeed
[tools] image failed: Unknown model: volcengine-plan/doubao-seed-2.0-pro
[tools] image failed: Unknown model: bailian/kimi-k2.5
[tools] image failed: Unknown model: dashscope/qwen-vl-max

When the model name is specified without a provider prefix (e.g., astron-code-latest), it defaults to openai/ prefix:

[tools] image failed: Unknown model: openai/astron-code-latest

Additional Context

  • The same custom providers work correctly for text chat (model failover works)
  • Direct API calls to these providers with image input work fine (tested with Python)
  • zai/glm-5v-turbo is recognized but fails with connection timeout (separate issue)
  • The models.json file in ~/.openclaw/agents/main/agent/models.json contains all providers with correct input: ["text", "image"] configuration
  • Running openclaw configure generates the models.json file with the providers listed

Workaround

Using Python to call the provider API directly for image analysis, bypassing the OpenClaw image tool.

extent analysis

TL;DR

The issue can be mitigated by verifying the custom provider configurations in models.json and ensuring they support image inputs.

Guidance

  • Review the models.json file to confirm that custom providers are correctly configured with input: ["text", "image"].
  • Verify that the custom providers support image analysis by checking their documentation or testing them directly via API calls.
  • Check the OpenClaw version and configuration to ensure it is compatible with the custom providers.
  • Test the custom providers with text chat to confirm they are working as expected, as mentioned in the additional context.

Example

No code snippet is provided as the issue seems to be related to configuration and compatibility rather than code.

Notes

The issue might be related to the compatibility of custom providers with the OpenClaw image tool or the configuration of the models.json file. Further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Use Python to call the provider API directly for image analysis, bypassing the OpenClaw image tool, as mentioned in the issue's workaround section, until the compatibility issue is resolved.

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…
#api#mixed precision#training loop#device allocation#model download

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 Bug: Image tool reports 'Unknown model' for all custom providers [2 comments, 2 participants]