PDF aracı

pdf bir veya daha fazla PDF belgesini analiz eder ve metin döndürür. Anthropic ve Google modellerinde yerel belge girdisini kullanır; diğer tüm sağlayıcılarda ise metin/görüntü ayıklamaya geri döner.

Kullanılabilirlik

Araç yalnızca OpenClaw, agent için PDF destekli bir model çözümleyebildiğinde kaydedilir. Çözümleme sırası:

1. agents.defaults.pdfModel (açıkça belirtilen birincil/yedekler)
2. agents.defaults.imageModel (açıkça belirtilen birincil/yedekler)
3. Sağlayıcısı yerel PDF girdisini (Anthropic, Google) destekliyorsa veya zaten yapılandırılmış bir görüntü modeli varsa agent'ın çözümlenen oturum/varsayılan modeli
4. Önce yerel PDF sağlayıcıları tercih edilerek, kullanılabilir kimlik doğrulamasına sahip otomatik algılanmış görüntü/görsel destekli sağlayıcılar

Her yedek adayın kimlik doğrulaması kullanımdan önce denetlenir; bu nedenle yapılandırılmış bir provider/model, yalnızca OpenClaw agent için söz konusu sağlayıcıda kimlik doğrulaması yapabiliyorsa dikkate alınır. Kullanılabilir bir model çözümlenemezse pdf aracı sunulmaz.

Girdi referansı

Notlar:

• pdf ve pdfs yüklemeden önce birleştirilir ve yinelenenler kaldırılır; en az biri gereklidir.
• pages, 1 tabanlı sayfa numaraları olarak ayrıştırılır, yinelenenler kaldırılır, sıralanır ve agents.defaults.pdfMaxPages (varsayılan 20) ile sınırlandırılır. Sınırlar içindeki hiçbir sayfayla eşleşmeyen bir aralık, model çağrısından önce hataya neden olur.

Desteklenen PDF referansları

• Yerel dosya yolu (~ genişletmesi dâhil)
• file:// URL'si
• http:// ve https:// URL'si
• media://inbound/<id> gibi OpenClaw tarafından yönetilen gelen referanslar

Diğer URI şemaları (örneğin ftp://) details.error = "unsupported_pdf_reference" döndürür. Araç korumalı alanda çalışırken uzak http(s) URL'leri reddedilir. Yalnızca çalışma alanına izin veren dosya politikası etkinleştirildiğinde, izin verilen köklerin dışındaki yerel yollar reddedilir; OpenClaw'ın gelen medya deposundaki yönetilen gelen referanslara ve yeniden oynatılan yollara yine izin verilir.

Yürütme modları

Yerel sağlayıcı modu

anthropic ve google sağlayıcıları için kullanılır (şu anda yerel PDF belgesi desteği bildiren tek sağlayıcılar). Ham PDF baytları, dosya başına yerel belge/satır içi PDF parçası olarak doğrudan sağlayıcı API'sine gönderilir.

Sınırlar:

• pages desteklenmez; ayarlanırsa araç pages is not supported with native PDF providers hatasını fırlatır.
• password desteklenmez; ayarlanırsa araç password is not supported with native PDF providers hatasını fırlatır. Şifrelenmiş PDF'ler için yerel olmayan bir model kullanın.

Ayıklama yedek modu

Diğer tüm sağlayıcılar için kullanılır.

1. Metin ve görüntü ayıklamak için clawpdf paketini (PDFium WebAssembly) kullanan paketlenmiş document-extract Plugin'i aracılığıyla seçili sayfalardan (agents.defaults.pdfMaxPages değerine kadar, varsayılan 20) metin ayıklayın.
2. Ayıklanan metin 200 karakterden kısaysa aynı sayfaları PNG görüntüleri olarak işleyin. İşleme bütçesi toplam 4,000,000 pikseldir ve görüntü gerektiren tüm sayfalar arasında paylaşılır (sayfa başına değil, kalan sayfa başına orantılı olarak tahsis edilir); bu nedenle zaten yeterli metin içeren metin sayfalarının işlenmesi tamamen atlanır.
3. Ayıklanan metni (ve işlenen tüm görüntüleri) istemle birlikte seçili modele gönderin.

Ayrıntılar:

• Şifrelenmiş PDF'ler üst düzey password parametresiyle açılır.
• Model görüntü girdisini desteklemiyorsa ve ayıklanabilir metin yoksa araç hata verir.
• Görüntü işleme başarısız olursa OpenClaw görüntüleri çıkarır ve ayıklanan metinle devam eder.
• Hedef model yalnızca metin destekliyorsa ve ayıklama görüntü ürettiyse OpenClaw görüntüleri çıkarır ve yalnızca metni gönderir.

Yapılandırma

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

Alanların tüm ayrıntıları için Yapılandırma Referansı bölümüne bakın.

Çıktı ayrıntıları

Araç, content[0].text içinde metin ve details içinde yapılandırılmış meta veriler döndürür.

Yaygın details alanları:

• model: çözümlenen model referansı (provider/model)
• native: yerel sağlayıcı modu için true, yedek mod için false
• attempts: başarıdan önce başarısız olan yedek denemeleri

Yol alanları:

• Tek PDF girdisi: details.pdf
• Birden fazla PDF girdisi: pdf girdileriyle details.pdfs[]
• Korumalı alan yol yeniden yazma meta verileri (uygun olduğunda): rewrittenFrom

Hata davranışı

Örnekler

Tek PDF:

{  "pdf": "/tmp/report.pdf",  "prompt": "Bu raporu 5 maddeyle özetleyin"}

Birden fazla PDF:

{  "pdfs": ["/tmp/q1.pdf", "/tmp/q2.pdf"],  "prompt": "Her iki belgedeki riskleri ve zaman çizelgesi değişikliklerini karşılaştırın"}

Sayfa filtreli yedek model:

{  "pdf": "https://example.com/report.pdf",  "pages": "1-3,7",  "model": "openai/gpt-5.4-mini",  "prompt": "Yalnızca müşterileri etkileyen olayları ayıklayın"}

Ayıklama yedeğiyle şifrelenmiş PDF:

{  "pdf": "/tmp/locked.pdf",  "password": "example-password",  "model": "openai/gpt-5.4-mini",  "prompt": "Bu sözleşmeyi özetleyin"}

İlgili

• Araçlara Genel Bakış - kullanılabilir tüm agent araçları
• Yapılandırma Referansı - pdfMaxBytesMb ve pdfMaxPages yapılandırması