PDF-tool

• Native providermodus voor Anthropic- en Google-modelproviders.
• Terugvalmodus voor extractie voor andere providers (extraheer eerst tekst, daarna pagina-afbeeldingen wanneer nodig).
• Ondersteunt enkele (pdf) of meervoudige (pdfs) invoer, maximaal 10 PDF’s per aanroep.

​

Beschikbaarheid

1. agents.defaults.pdfModel
2. terugval naar agents.defaults.imageModel
3. terugval naar het opgeloste sessie-/standaardmodel van de agent
4. als native-PDF-providers door auth worden ondersteund, geef deze dan de voorkeur boven generieke kandidaten voor afbeeldingsterugval

• De terugvalketen is auth-bewust. Een geconfigureerde provider/model telt alleen als OpenClaw die provider daadwerkelijk voor de agent kan authenticeren.
• Native PDF-providers zijn momenteel Anthropic en Google.
• Als de opgeloste sessie-/standaardprovider al een geconfigureerd vision-/PDF- model heeft, hergebruikt de PDF-tool dat voordat wordt teruggevallen op andere door auth ondersteunde providers.

​

Invoerreferentie

• pdf en pdfs worden samengevoegd en ontdubbeld voordat ze worden geladen.
• Als er geen PDF-invoer is opgegeven, geeft de tool een fout.
• pages wordt geparsed als paginanummers vanaf 1, ontdubbeld, gesorteerd en begrensd op het geconfigureerde maximumaantal pagina’s.
• password is van toepassing op elke PDF in het verzoek en wordt alleen gebruikt door de terugvalmodus voor extractie.
• maxBytesMb is standaard ingesteld op agents.defaults.pdfMaxBytesMb of 10.

​

Ondersteunde PDF-referenties

• lokaal bestandspad (inclusief ~-uitbreiding)
• file://-URL
• http://- en https://-URL
• door OpenClaw beheerde inkomende refs zoals media://inbound/<id>

• Andere URI-schema’s (bijvoorbeeld ftp://) worden geweigerd met unsupported_pdf_reference.
• In sandboxmodus worden externe http(s)-URL’s geweigerd.
• Met beleid voor alleen-werkruimtebestanden ingeschakeld, worden lokale bestandspaden buiten toegestane roots geweigerd.
• Beheerde inkomende refs en opnieuw afgespeelde paden onder de inkomende mediaopslag van OpenClaw zijn toegestaan met beleid voor alleen-werkruimtebestanden.

​

Uitvoeringsmodi

​

Native providermodus

• pages wordt niet ondersteund. Indien ingesteld, retourneert de tool een fout.
• password wordt niet ondersteund. Gebruik een niet-native model om versleutelde PDF’s te analyseren.
• Meervoudige PDF-invoer wordt ondersteund; elke PDF wordt als native documentblok / inline PDF-onderdeel vóór de prompt verzonden.

​

Terugvalmodus voor extractie

1. Extraheer tekst uit geselecteerde pagina’s (tot agents.defaults.pdfMaxPages, standaard 20).
2. Als de geëxtraheerde tekstlengte minder dan 200 tekens is, render geselecteerde pagina’s naar PNG-afbeeldingen en neem ze op.
3. Verstuur geëxtraheerde inhoud plus prompt naar het geselecteerde model.

• Extractie van pagina-afbeeldingen gebruikt een pixelbudget van 4,000,000.
• Versleutelde PDF’s kunnen worden geopend met de parameter password op topniveau.
• Als het doelmodel geen afbeeldingsinvoer ondersteunt en er geen extraheerbare tekst is, geeft de tool een fout.
• Als tekstextractie slaagt maar afbeeldingsextractie vision zou vereisen op een tekstmodel, laat OpenClaw de gerenderde afbeeldingen weg en gaat verder met de geëxtraheerde tekst.
• Terugval voor extractie gebruikt de gebundelde document-extract-Plugin. De Plugin beheert clawpdf, dat tekstextractie en afbeeldingsrendering biedt via PDFium WebAssembly.

​

Configuratie

{
  agents: {
    defaults: {
      pdfModel: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5.4-mini"],
      },
      pdfMaxBytesMb: 10,
      pdfMaxPages: 20,
    },
  },
}

​

Uitvoerdetails

• model: opgeloste modelreferentie (provider/model)
• native: true voor native providermodus, false voor terugval
• attempts: terugvalpogingen die vóór succes zijn mislukt

• enkele PDF-invoer: details.pdf
• meervoudige PDF-invoer: details.pdfs[] met pdf-items
• metadata voor herschrijving van sandboxpaden (indien van toepassing): rewrittenFrom

​

Foutgedrag

• Ontbrekende PDF-invoer: gooit pdf required: provide a path or URL to a PDF document
• Te veel PDF’s: retourneert gestructureerde fout in details.error = "too_many_pdfs"
• Niet-ondersteund referentieschema: retourneert details.error = "unsupported_pdf_reference"
• Native modus met pages: gooit duidelijke fout pages is not supported with native PDF providers

​

Voorbeelden

{
  "pdf": "/tmp/report.pdf",
  "prompt": "Summarize this report in 5 bullets"
}

{
  "pdfs": ["/tmp/q1.pdf", "/tmp/q2.pdf"],
  "prompt": "Compare risks and timeline changes across both documents"
}

{
  "pdf": "https://example.com/report.pdf",
  "pages": "1-3,7",
  "model": "openai/gpt-5.4-mini",
  "prompt": "Extract only customer-impacting incidents"
}

{
  "pdf": "/tmp/locked.pdf",
  "password": "example-password",
  "model": "openai/gpt-5.4-mini",
  "prompt": "Summarize this contract"
}

​

Gerelateerd

• Toolsoverzicht - alle beschikbare agenttools
• Configuratiereferentie - configuratie voor pdfMaxBytesMb en pdfMaxPages