Alat PDF

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​

Ketersediaan

1. agents.defaults.pdfModel
2. fallback ke agents.defaults.imageModel
3. fallback ke model sesi/default agen yang diselesaikan
4. jika penyedia PDF native didukung autentikasi, prioritaskan penyedia tersebut sebelum kandidat fallback gambar generik

• Rantai fallback peka autentikasi. provider/model yang dikonfigurasi hanya dihitung jika OpenClaw benar-benar dapat mengautentikasi penyedia tersebut untuk agen.
• Penyedia PDF native saat ini adalah Anthropic dan Google.
• Jika penyedia sesi/default yang diselesaikan sudah memiliki model vision/PDF yang dikonfigurasi, alat PDF akan menggunakannya kembali sebelum fallback ke penyedia lain yang didukung autentikasi.

​

Referensi input

• pdf dan pdfs digabungkan dan dideduplikasi sebelum dimuat.
• Jika tidak ada input PDF yang diberikan, alat akan menghasilkan error.
• pages diparse sebagai nomor halaman berbasis 1, dideduplikasi, diurutkan, dan dibatasi ke jumlah halaman maksimal yang dikonfigurasi.
• maxBytesMb default ke agents.defaults.pdfMaxBytesMb atau 10.

​

Referensi PDF yang didukung

• path file lokal (termasuk ekspansi ~)
• URL file://
• URL http:// dan https://
• referensi inbound 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 hanya-workspace diaktifkan, path file lokal di luar root yang diizinkan ditolak.
• Referensi inbound terkelola dan path yang diputar ulang di bawah penyimpanan media inbound OpenClaw diizinkan dengan kebijakan file hanya-workspace.

​

Mode eksekusi

​

Mode penyedia native

• pages tidak didukung. Jika diatur, alat mengembalikan error.
• Input multi-PDF didukung; setiap PDF dikirim sebagai blok dokumen native / bagian PDF inline sebelum prompt.

​

Mode fallback 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.
• Jika model target tidak mendukung input gambar dan tidak ada teks yang dapat diekstrak, alat menghasilkan error.
• Jika ekstraksi teks berhasil tetapi ekstraksi gambar memerlukan vision pada model hanya-teks, OpenClaw membuang gambar yang dirender dan melanjutkan dengan teks yang diekstrak.
• Fallback ekstraksi menggunakan Plugin document-extract bawaan. Plugin memiliki pdfjs-dist; @napi-rs/canvas hanya digunakan ketika fallback rendering gambar tersedia.

​

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 diselesaikan (provider/model)
• native: true untuk mode penyedia native, false untuk fallback
• attempts: percobaan fallback yang gagal sebelum berhasil

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

​

Perilaku error

• Input PDF hilang: melempar pdf required: provide a path or URL to a PDF document
• Terlalu banyak PDF: mengembalikan error terstruktur di details.error = "too_many_pdfs"
• Skema referensi tidak didukung: mengembalikan details.error = "unsupported_pdf_reference"
• Mode native dengan pages: melempar error 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"
}

​

Terkait

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