PDF-Tool

• Nativer Provider-Modus für Anthropic- und Google-Model-Provider.
• Extraktions-Fallback-Modus für andere Provider (zuerst Text extrahieren, dann bei Bedarf Seitenbilder).
• Unterstützt einzelne (pdf) oder mehrere (pdfs) Eingaben, maximal 10 PDFs pro Aufruf.

​

Verfügbarkeit

1. agents.defaults.pdfModel
2. Fallback auf agents.defaults.imageModel
3. Fallback auf das aufgelöste Sitzungs-/Standardmodell des Agenten
4. Wenn native PDF-Provider authentifizierungsbasiert verfügbar sind, werden sie generischen Kandidaten für den Bild-Fallback vorgezogen

• Die Fallback-Kette berücksichtigt Authentifizierung. Ein konfiguriertes provider/model zählt nur, wenn OpenClaw diesen Provider für den Agenten tatsächlich authentifizieren kann.
• Native PDF-Provider sind derzeit Anthropic und Google.
• Wenn der aufgelöste Sitzungs-/Standard-Provider bereits ein konfiguriertes Vision-/PDF- Modell hat, verwendet das PDF-Tool dieses erneut, bevor es auf andere authentifizierungsbasierte Provider zurückfällt.

​

Eingabereferenz

• pdf und pdfs werden vor dem Laden zusammengeführt und dedupliziert.
• Wenn keine PDF-Eingabe angegeben ist, gibt das Tool einen Fehler aus.
• pages wird als 1-basierte Seitenzahlen geparst, dedupliziert, sortiert und auf die konfigurierte maximale Seitenanzahl begrenzt.
• password gilt für jedes PDF in der Anfrage und wird nur vom Extraktions-Fallback-Modus verwendet.
• maxBytesMb verwendet standardmäßig agents.defaults.pdfMaxBytesMb oder 10.

​

Unterstützte PDF-Referenzen

• lokaler Dateipfad (einschließlich ~-Erweiterung)
• file://-URL
• http://- und https://-URL
• von OpenClaw verwaltete eingehende Refs wie media://inbound/<id>

• Andere URI-Schemata (zum Beispiel ftp://) werden mit unsupported_pdf_reference abgelehnt.
• Im Sandbox-Modus werden Remote-http(s)-URLs abgelehnt.
• Bei aktivierter Workspace-only-Dateirichtlinie werden lokale Dateipfade außerhalb erlaubter Wurzeln abgelehnt.
• Verwaltete eingehende Refs und wiedergegebene Pfade unter OpenClaws Speicher für eingehende Medien sind mit Workspace-only-Dateirichtlinie erlaubt.

​

Ausführungsmodi

​

Nativer Provider-Modus

• pages wird nicht unterstützt. Wenn gesetzt, gibt das Tool einen Fehler zurück.
• password wird nicht unterstützt. Verwenden Sie ein nicht-natives Modell, um verschlüsselte PDFs zu analysieren.
• Mehrere PDF-Eingaben werden unterstützt; jedes PDF wird vor dem Prompt als nativer Dokumentblock / Inline-PDF-Teil gesendet.

​

Extraktions-Fallback-Modus

1. Text aus ausgewählten Seiten extrahieren (bis zu agents.defaults.pdfMaxPages, Standardwert 20).
2. Wenn die Länge des extrahierten Texts unter 200 Zeichen liegt, ausgewählte Seiten als PNG-Bilder rendern und einschließen.
3. Extrahierten Inhalt plus Prompt an das ausgewählte Modell senden.

• Die Extraktion von Seitenbildern verwendet ein Pixelbudget von 4,000,000.
• Verschlüsselte PDFs können mit dem Top-Level-Parameter password geöffnet werden.
• Wenn das Zielmodell keine Bildeingabe unterstützt und kein extrahierbarer Text vorhanden ist, gibt das Tool einen Fehler aus.
• Wenn die Textextraktion erfolgreich ist, die Bildextraktion auf einem reinen Textmodell jedoch Vision erfordern würde, verwirft OpenClaw die gerenderten Bilder und fährt mit dem extrahierten Text fort.
• Der Extraktions-Fallback verwendet das gebündelte Plugin document-extract. Das Plugin besitzt clawpdf, das Textextraktion und Bildrendering über PDFium WebAssembly bereitstellt.

​

Konfiguration

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

​

Ausgabedetails

• model: aufgelöste Modellreferenz (provider/model)
• native: true für nativen Provider-Modus, false für Fallback
• attempts: Fallback-Versuche, die vor dem Erfolg fehlgeschlagen sind

• einzelne PDF-Eingabe: details.pdf
• mehrere PDF-Eingaben: details.pdfs[] mit pdf-Einträgen
• Metadaten zur Sandbox-Pfadumschreibung (falls zutreffend): rewrittenFrom

​

Fehlerverhalten

• Fehlende PDF-Eingabe: wirft pdf required: provide a path or URL to a PDF document
• Zu viele PDFs: gibt strukturierten Fehler in details.error = "too_many_pdfs" zurück
• Nicht unterstütztes Referenzschema: gibt details.error = "unsupported_pdf_reference" zurück
• Nativer Modus mit pages: wirft eindeutigen Fehler pages is not supported with native PDF providers

​

Beispiele

{
  "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"
}

​

Verwandt

• Tools-Übersicht - alle verfügbaren Agent-Tools
• Konfigurationsreferenz - Konfiguration von pdfMaxBytesMb und pdfMaxPages