Alat PDF

• Mode penyedia bawaan untuk penyedia model Anthropic dan Google.
• Mode cadangan ekstraksi untuk penyedia lain (ekstrak teks terlebih dahulu, lalu gambar halaman bila diperlukan).
• Mendukung input tunggal (pdf) atau multi (pdfs), maksimum 10 PDF per panggilan.

​

Ketersediaan

1. agents.defaults.pdfModel
2. cadangan ke agents.defaults.imageModel
3. cadangan ke model sesi/default agen yang terselesaikan
4. jika penyedia PDF bawaan didukung autentikasi, prioritaskan mereka sebelum kandidat cadangan gambar generik

• Rantai cadangan sadar autentikasi. provider/model yang dikonfigurasi hanya dihitung jika OpenClaw benar-benar dapat mengautentikasi penyedia tersebut untuk agen.
• Penyedia PDF bawaan saat ini adalah Anthropic dan Google.
• Jika penyedia sesi/default yang terselesaikan sudah memiliki model visi/PDF yang dikonfigurasi, alat PDF menggunakan ulang model itu sebelum beralih ke penyedia lain yang didukung autentikasi.

​

Referensi input

• pdf dan pdfs digabungkan dan dideduplikasi sebelum dimuat.
• Jika tidak ada input PDF yang diberikan, alat menghasilkan galat.
• pages diurai sebagai nomor halaman berbasis 1, dideduplikasi, diurutkan, dan dibatasi ke maksimum halaman yang dikonfigurasi.
• password berlaku untuk setiap PDF dalam permintaan dan hanya digunakan oleh mode cadangan ekstraksi.
• maxBytesMb default ke agents.defaults.pdfMaxBytesMb atau 10.

​

Referensi PDF yang didukung

• jalur file lokal (termasuk ekspansi ~)
• URL file://
• URL http:// dan https://
• referensi masuk yang dikelola OpenClaw seperti media://inbound/<id>

• Skema URI lain (misalnya ftp://) ditolak dengan unsupported_pdf_reference.
• Dalam mode sandbox, URL http(s) jarak jauh ditolak.
• Dengan kebijakan file khusus ruang kerja diaktifkan, jalur file lokal di luar root yang diizinkan ditolak.
• Referensi masuk terkelola dan jalur yang diputar ulang di bawah penyimpanan media masuk OpenClaw diizinkan dengan kebijakan file khusus ruang kerja.

​

Mode eksekusi

​

Mode penyedia bawaan

• pages tidak didukung. Jika diatur, alat mengembalikan galat.
• password tidak didukung. Gunakan model non-bawaan untuk menganalisis PDF terenkripsi.
• Input multi-PDF didukung; setiap PDF dikirim sebagai blok dokumen bawaan / bagian PDF inline sebelum prompt.

​

Mode cadangan ekstraksi

1. Ekstrak teks dari halaman yang dipilih (hingga agents.defaults.pdfMaxPages, default 20).
2. Jika panjang teks yang diekstrak di bawah 200 karakter, render halaman yang dipilih menjadi gambar PNG dan sertakan gambar tersebut.
3. Kirim konten yang diekstrak beserta prompt ke model yang dipilih.

• Ekstraksi gambar halaman menggunakan anggaran piksel 4,000,000.
• PDF terenkripsi dapat dibuka dengan parameter tingkat atas password.
• Jika model target tidak mendukung input gambar dan tidak ada teks yang dapat diekstrak, alat menghasilkan galat.
• Jika ekstraksi teks berhasil tetapi ekstraksi gambar akan membutuhkan visi pada model khusus teks, OpenClaw membuang gambar yang dirender dan melanjutkan dengan teks yang diekstrak.
• Cadangan ekstraksi menggunakan Plugin document-extract bawaan. Plugin memiliki clawpdf, yang menyediakan ekstraksi teks dan rendering gambar melalui PDFium WebAssembly.

​

Konfigurasi

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

​

Detail output

• model: referensi model yang terselesaikan (provider/model)
• native: true untuk mode penyedia bawaan, false untuk cadangan
• attempts: upaya cadangan yang gagal sebelum berhasil

• input PDF tunggal: details.pdf
• input beberapa PDF: details.pdfs[] dengan entri pdf
• metadata penulisan ulang jalur sandbox (bila berlaku): rewrittenFrom

​

Perilaku galat

• Input PDF hilang: melempar pdf required: provide a path or URL to a PDF document
• Terlalu banyak PDF: mengembalikan galat terstruktur di details.error = "too_many_pdfs"
• Skema referensi tidak didukung: mengembalikan details.error = "unsupported_pdf_reference"
• Mode bawaan dengan pages: melempar galat jelas pages is not supported with native PDF providers

​

Contoh

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

​

Terkait

• Ikhtisar Alat - semua alat agen yang tersedia
• Referensi Konfigurasi - konfigurasi pdfMaxBytesMb dan pdfMaxPages