PDF-hulpmiddel

pdf analyseert een of meer PDF-documenten en retourneert tekst. Het gebruikt native documentinvoer bij modellen van Anthropic en Google en valt voor elke andere provider terug op tekst- en afbeeldingsextractie.

Beschikbaarheid

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

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

Elke kandidaat-terugvaloptie wordt vóór gebruik gecontroleerd op authenticatie. Een geconfigureerde provider/model telt dus alleen mee als OpenClaw die provider voor de agent kan authenticeren. Als er geen bruikbaar model kan worden gevonden, wordt de tool pdf niet beschikbaar gesteld.

Invoerverwijzing

Opmerkingen:

• pdf en pdfs worden vóór het laden samengevoegd en gededupliceerd; ten minste één van beide is vereist.
• pages wordt verwerkt als paginanummers die bij 1 beginnen, vervolgens gededupliceerd en gesorteerd, en begrensd op agents.defaults.pdfMaxPages (standaard 20). Een bereik dat geen enkele geldige pagina bevat, veroorzaakt een fout voordat het model wordt aangeroepen.

Ondersteunde PDF-verwijzingen

• Lokaal bestandspad (inclusief uitbreiding van ~)
• file://-URL
• http://- en https://-URL
• Door OpenClaw beheerde verwijzingen naar inkomende bestanden, 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 alleen de werkruimte toestaat, worden lokale paden buiten de toegestane hoofdmappen geweigerd; beheerde verwijzingen naar inkomende bestanden en opnieuw afgespeelde paden binnen OpenClaws opslag voor inkomende media blijven toegestaan.

Uitvoeringsmodi

Native providermodus

Wordt gebruikt voor de providers 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 een native document- of inline-PDF-onderdeel.

Limieten:

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

Extractieterugvalmodus

Wordt gebruikt voor elke andere provider.

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 over alle pagina's waarvoor afbeeldingen nodig zijn (evenredig verdeeld per resterende pagina, niet per afzonderlijke pagina). Tekstpagina's die al voldoende tekst bevatten, worden dus helemaal niet gerenderd.
3. Stuur de geëxtraheerde tekst (en eventueel 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, retourneert 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 stuurt 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 volledige details over de velden.

Uitvoerdetails

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

Veelvoorkomende velden in details:

• model: opgeloste modelverwijzing (provider/model)
• native: true voor de native providermodus, false voor de terugvalmodus
• attempts: terugvalpogingen die vóór het slagen zijn mislukt

Padvelden:

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

Foutgedrag

Voorbeelden

Eén PDF:

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

Meerdere PDF's:

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

Terugvalmodel met paginafilter:

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

Versleutelde PDF met extractieterugval:

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

Gerelateerd

• Overzicht van tools - alle beschikbare agenttools
• Configuratiereferentie - configuratie van pdfMaxBytesMb en pdfMaxPages