PDF aracı

• Anthropic ve Google model sağlayıcıları için yerel sağlayıcı modu.
• Diğer sağlayıcılar için çıkarma geri dönüş modu (önce metni, gerektiğinde sayfa görüntülerini çıkarır).
• Tek (pdf) veya çoklu (pdfs) girişi destekler; çağrı başına en fazla 10 PDF.

​

Kullanılabilirlik

1. agents.defaults.pdfModel
2. agents.defaults.imageModel değerine geri dönüş
3. ajanın çözümlenmiş oturum/varsayılan modeline geri dönüş
4. yerel PDF sağlayıcıları kimlik doğrulama destekliyse, genel görüntü geri dönüş adaylarından önce onları tercih et

• Geri dönüş zinciri kimlik doğrulamanın farkındadır. Yapılandırılmış bir provider/model yalnızca OpenClaw o sağlayıcıda ajan için gerçekten kimlik doğrulayabiliyorsa sayılır.
• Yerel PDF sağlayıcıları şu anda Anthropic ve Googledır.
• Çözümlenmiş oturum/varsayılan sağlayıcının zaten yapılandırılmış bir görme/PDF modeli varsa PDF aracı, diğer kimlik doğrulama destekli sağlayıcılara geri dönmeden önce bunu yeniden kullanır.

​

Girdi referansı

• pdf ve pdfs, yüklemeden önce birleştirilir ve yinelenenler kaldırılır.
• PDF girdisi sağlanmazsa araç hata verir.
• pages, 1 tabanlı sayfa numaraları olarak ayrıştırılır; yinelenenler kaldırılır, sıralanır ve yapılandırılmış maksimum sayfa sayısına sınırlandırılır.
• password, istekteki her PDF için geçerlidir ve yalnızca çıkarma geri dönüş modu tarafından kullanılır.
• maxBytesMb varsayılan olarak agents.defaults.pdfMaxBytesMb veya 10 kullanır.

​

Desteklenen PDF referansları

• yerel dosya yolu (~ genişletmesi dahil)
• 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://) unsupported_pdf_reference ile reddedilir.
• Sandbox modunda, uzak http(s) URL’leri reddedilir.
• Yalnızca çalışma alanı dosya ilkesi etkinleştirildiğinde, izin verilen köklerin dışındaki yerel dosya yolları reddedilir.
• OpenClaw’ın gelen medya deposu altındaki yönetilen gelen referanslara ve yeniden oynatılan yollara, yalnızca çalışma alanı dosya ilkesiyle izin verilir.

​

Çalıştırma modları

​

Yerel sağlayıcı modu

• pages desteklenmez. Ayarlanırsa araç hata döndürür.
• password desteklenmez. Şifrelenmiş PDF’leri analiz etmek için yerel olmayan bir model kullanın.
• Çoklu PDF girdisi desteklenir; her PDF, istemden önce yerel belge bloğu / satır içi PDF parçası olarak gönderilir.

​

Çıkarma geri dönüş modu

1. Seçilen sayfalardan metin çıkar (agents.defaults.pdfMaxPages değerine kadar, varsayılan 20).
2. Çıkarılan metin uzunluğu 200 karakterin altındaysa, seçilen sayfaları PNG görüntülerine dönüştür ve dahil et.
3. Çıkarılan içeriği ve istemi seçilen modele gönder.

• Sayfa görüntüsü çıkarma, 4,000,000 piksel bütçesi kullanır.
• Şifrelenmiş PDF’ler üst düzey password parametresiyle açılabilir.
• Hedef model görüntü girişini desteklemiyorsa ve çıkarılabilir metin yoksa araç hata verir.
• Metin çıkarma başarılı olursa ancak görüntü çıkarma yalnızca metin destekleyen bir modelde görme gerektirirse, OpenClaw oluşturulan görüntüleri bırakır ve çıkarılan metinle devam eder.
• Çıkarma geri dönüşü, paketlenmiş document-extract Plugin’ini kullanır. Plugin, PDFium WebAssembly aracılığıyla metin çıkarma ve görüntü oluşturma sağlayan clawpdf öğesinin sahibidir.

​

Yapılandırma

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

​

Çıktı ayrıntıları

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

• tek PDF girdisi: details.pdf
• birden fazla PDF girdisi: pdf girdileriyle details.pdfs[]
• sandbox yolu yeniden yazma meta verileri (geçerli olduğunda): rewrittenFrom

​

Hata davranışı

• Eksik PDF girdisi: pdf required: provide a path or URL to a PDF document fırlatır
• Çok fazla PDF: details.error = "too_many_pdfs" içinde yapılandırılmış hata döndürür
• Desteklenmeyen referans şeması: details.error = "unsupported_pdf_reference" döndürür
• pages ile yerel mod: açık bir pages is not supported with native PDF providers hatası fırlatır

​

Örnekler

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

​

İlgili

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