openclaw - 💡(How to fix) Fix pdf tool: MiniMax provider blocked from extraction fallback mode

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…

The pdf tool excludes MiniMax providers (minimax and minimax-portal) from both native and extraction fallback modes, returning "Unknown model" even when valid MiniMax models are configured as pdfModel or imageModel.

Error Message

  1. Error: "Unknown model: minimax-portal/MiniMax-M2.7"

Root Cause

In minimax-vlm-BcnwK449.js, isMinimaxVlmModel() check at line 74 explicitly throws "Unknown model" for MiniMax provider/model combinations. This hard block prevents the extraction fallback path from ever being reached.

The model resolution flow:

  1. resolveProviderVisionModelFromConfig correctly finds MiniMax-VL-01
  2. isMinimaxVlmModel blocks it before extraction fallback
  3. Text-only M2.7 is not found by vision model search at all
RAW_BUFFERClick to expand / collapse

Summary

The pdf tool excludes MiniMax providers (minimax and minimax-portal) from both native and extraction fallback modes, returning "Unknown model" even when valid MiniMax models are configured as pdfModel or imageModel.

Steps to reproduce

  1. Configure MiniMax OAuth (minimax-portal) with M2.7 model
  2. Set agents.defaults.pdfModel.primary = "minimax-portal/MiniMax-M2.7"
  3. Call pdf tool with a local PDF file
  4. Error: "Unknown model: minimax-portal/MiniMax-M2.7"

Root cause

In minimax-vlm-BcnwK449.js, isMinimaxVlmModel() check at line 74 explicitly throws "Unknown model" for MiniMax provider/model combinations. This hard block prevents the extraction fallback path from ever being reached.

The model resolution flow:

  1. resolveProviderVisionModelFromConfig correctly finds MiniMax-VL-01
  2. isMinimaxVlmModel blocks it before extraction fallback
  3. Text-only M2.7 is not found by vision model search at all

Expected behavior

For non-VL-01 MiniMax models (like M2.7), or even for VL-01, the extraction fallback should work:

  1. Extract PDF text via bundled pdfjs-dist
  2. Send extracted text to the model
  3. Skip image rendering for text-only models

Impact

Users with only MiniMax (Coding Plan/OAuth) auth cannot use the pdf tool, even though:

  • Chat works (M2.7 via Anthropic-compatible)
  • Image understanding works (VL-01 via VLM endpoint)
  • Music generation works (music-2.6 via OAuth)
  • Web search works (plugin)

Environment

  • OpenClaw 2026.5.12 (f066dd2)
  • MiniMax Coding Plan (OAuth, minimax-portal)
  • macOS + webchat channel

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…

FAQ

Expected behavior

For non-VL-01 MiniMax models (like M2.7), or even for VL-01, the extraction fallback should work:

  1. Extract PDF text via bundled pdfjs-dist
  2. Send extracted text to the model
  3. Skip image rendering for text-only models

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 pdf tool: MiniMax provider blocked from extraction fallback mode