Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix [Bug]: pdf tool / model not being used [3 comments, 4 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#58962•Fetched 2026-04-08 02:30:40
View on GitHub
Comments
3
Participants
4
Timeline
11
Reactions
0
Author
ThomSMGThomSMG
Participants
11687841168784Lrs-GreenBottleLrs-GreenBottletanys123tanys123ThomSMGThomSMG
Timeline (top)
commented ×3mentioned ×3subscribed ×3labeled ×2

Configured PDF model is not used resulting in low quality pdf processing.

Root Cause

Configured PDF model is not used resulting in low quality pdf processing.

Code Example

pdfModel: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5-mini"],
      },

---
RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

Configured PDF model is not used resulting in low quality pdf processing.

Steps to reproduce

Setup according to docs

pdfModel: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5-mini"],
      },

give it longer pdf (10 pages enough for the bug).

ask how many pages it read - in my case constantly only 4. I asked it if it has access to only pdf read tool and it answered it has not.

I'm not sure how to debug this.

Expected behavior

It will read the full document and actually use pdfModel.primary.

Actual behavior

It's only reading the first 4 pages

OpenClaw version

OpenClaw 2026.3.31 (213a704)

Operating system

macOS 26.3.1

Install method

npm global

Model

openrouter/kwaipilot/kat-coder-pro-v2, openrouter/anthropic/claude-opus-4-6

Provider / routing chain

openclaw -> openrouter

Additional provider/model setup details

main agent i use signal

Logs, screenshots, and evidence

Impact and severity

Affected: pdf scans

Additional information

i only started testing this now. not sure if it ever worked.

extent analysis

TL;DR

Verify the PDF model configuration and check if the issue persists when using a different PDF model or a smaller PDF file.

Guidance

  • Check the documentation for the pdfModel configuration to ensure it is set up correctly, paying attention to any page limits or restrictions.
  • Test the PDF processing with a smaller PDF file (less than 4 pages) to see if the issue is related to the file size.
  • Try using a different primary PDF model, such as one of the fallback models, to see if the issue is specific to the current primary model.
  • Verify that the openclaw and openrouter versions are compatible and up-to-date.

Example

No code example is provided as the issue does not require a code change, but rather a configuration or setup verification.

Notes

The issue may be related to a limitation or bug in the openclaw or openrouter libraries, or a misconfiguration of the PDF model. Further debugging and testing are needed to determine the root cause.

Recommendation

Apply workaround: Try using a different primary PDF model or a smaller PDF file to see if the issue persists, as this may help identify the root cause of the problem.

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

It will read the full document and actually use pdfModel.primary.

#model download#tokenizer error#prompt formatting#chain error#conversation history

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]: pdf tool / model not being used [3 comments, 4 participants]