PDF-tool

pdf analyseert een of meer PDF-documenten en retourneert tekst. De tool gebruikt native documentinvoer bij Anthropic- en Google-modellen en valt bij alle andere providers terug op tekst-/afbeeldingsextractie.

Beschikbaarheid

De tool wordt alleen geregistreerd wanneer OpenClaw een PDF-geschikt model voor de agent kan vinden. Zoekvolgorde:

1. agents.defaults.pdfModel (expliciete primaire modellen/terugvalmodellen)
2. agents.defaults.imageModel (expliciete primaire modellen/terugvalmodellen)
3. Het gevonden sessie-/standaardmodel van de agent, als de provider native PDF-invoer ondersteunt (Anthropic, Google) of al een geconfigureerd visionmodel heeft
4. Automatisch gedetecteerde providers die afbeeldingen/vision ondersteunen en bruikbare authenticatie hebben, waarbij providers met native PDF-ondersteuning voorrang krijgen

Voor gebruik wordt de authenticatie van elke kandidaat voor terugval gecontroleerd. Een geconfigureerde provider/model telt dus alleen mee als OpenClaw de agent bij die provider kan authenticeren. Als er geen bruikbaar model wordt gevonden, wordt de tool pdf niet beschikbaar gesteld.

Invoerverwijzing

Opmerkingen:

• pdf en pdfs worden vóór het laden samengevoegd en gededupliceerd; ten minste één ervan is vereist.
• pages wordt geïnterpreteerd als paginanummers die bij 1 beginnen, gededupliceerd, gesorteerd en begrensd tot agents.defaults.pdfMaxPages (standaard 20). Een bereik dat geen enkele pagina binnen de grenzen bevat, veroorzaakt vóór de modelaanroep een fout.

Ondersteunde PDF-verwijzingen

• Lokaal bestandspad (inclusief uitbreiding van ~)
• file://-URL
• http://- en https://-URL
• Door OpenClaw beheerde inkomende verwijzingen, zoals media://inbound/<id>

Andere URI-schema's (bijvoorbeeld ftp://) retourneren details.error = "unsupported_pdf_reference". Externe http(s)-URL's worden geweigerd wanneer de tool in een sandbox wordt uitgevoerd. Als het bestandsbeleid voor alleen de workspace is ingeschakeld, worden lokale paden buiten de toegestane hoofdmappen geweigerd; beheerde inkomende verwijzingen en opnieuw afgespeelde paden in OpenClaws opslag voor inkomende media blijven toegestaan.

Uitvoeringsmodi

Native providermodus

Gebruikt voor provider anthropic en google (de enige providers die momenteel native ondersteuning voor PDF-documenten declareren). De onbewerkte PDF-bytes gaan per bestand rechtstreeks naar de provider-API als native document-/inline-PDF-onderdeel.

Limieten:

• pages wordt niet ondersteund; indien ingesteld, genereert de tool pages is not supported with native PDF providers.
• password wordt niet ondersteund; indien ingesteld, genereert de tool password is not supported with native PDF providers. Gebruik voor versleutelde PDF's een niet-native model.

Extractieterugvalmodus

Gebruikt voor alle andere providers.

1. Extraheer tekst uit de geselecteerde pagina's (maximaal agents.defaults.pdfMaxPages, standaard 20) via de meegeleverde Plugin document-extract, die het pakket clawpdf (PDFium WebAssembly) gebruikt voor tekst- en afbeeldingsextractie.
2. Als de geëxtraheerde tekst korter is dan 200 tekens, worden dezelfde pagina's als PNG-afbeeldingen gerenderd. Het renderbudget bedraagt in totaal 4,000,000 pixels en wordt gedeeld door alle pagina's waarvoor afbeeldingen nodig zijn (evenredig toegewezen per resterende pagina, niet per pagina). Tekstpagina's die al voldoende tekst bevatten, worden dus helemaal niet gerenderd.
3. Stuur de geëxtraheerde tekst (en eventuele gerenderde afbeeldingen) samen met de prompt naar het geselecteerde model.

Details:

• Versleutelde PDF's worden geopend met de parameter password op het hoogste niveau.
• Als het model geen afbeeldingsinvoer ondersteunt en er geen tekst kan worden geëxtraheerd, genereert de tool een fout.
• Als het renderen van afbeeldingen mislukt, laat OpenClaw de afbeeldingen weg en gaat het verder met de geëxtraheerde tekst.
• Als het doelmodel alleen tekst ondersteunt en de extractie afbeeldingen heeft opgeleverd, laat OpenClaw de afbeeldingen weg en verzendt het alleen tekst.

Configuratie

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

Zie Configuratiereferentie voor alle veldgegevens.

Uitvoerdetails

De tool retourneert tekst in content[0].text en gestructureerde metagegevens in details.

Veelvoorkomende details-velden:

• model: gevonden modelverwijzing (provider/model)
• native: true voor de native providermodus, false voor terugval
• attempts: mislukte terugvalpogingen vóór het slagen

Padvelden:

• Invoer van één PDF: details.pdf
• Invoer van meerdere PDF's: details.pdfs[] met pdf-items
• Metagegevens over het herschrijven van sandboxpaden (indien van toepassing): rewrittenFrom

Foutgedrag

Voorbeelden

Eén PDF:

{  "pdf": "/tmp/report.pdf",  "prompt": "Vat dit rapport samen in 5 opsommingstekens"}

Meerdere PDF's:

{  "pdfs": ["/tmp/q1.pdf", "/tmp/q2.pdf"],  "prompt": "Vergelijk risico's en wijzigingen in de tijdlijn tussen beide documenten"}

Terugvalmodel met paginafilter:

{  "pdf": "https://example.com/report.pdf",  "pages": "1-3,7",  "model": "openai/gpt-5.4-mini",  "prompt": "Extraheer alleen incidenten die gevolgen hebben voor klanten"}

Versleutelde PDF met extractieterugval:

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

Gerelateerd

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