Narzedzie PDF w OpenClaw — analiza dokumentow

Wprowadzenie

Narzedzie PDF analizuje jeden lub wiecej dokumentow PDF i wyodrebnia tekst. Obsluguje do 10 plikow PDF na jedno wywolanie z inteligentna obsluga dostawcow.

Kluczowe mozliwosci

• Natywne wsparcie — dostawcy Anthropic i Google przetwarzaja pliki PDF bezposrednio
• Tryb fallback — inni dostawcy najpierw ekstrahuja tekst, a w razie potrzeby renderuja obrazy stron
• Elastyczne dane wejsciowe — pojedyncze lub wiele PDF przez sciezki lub adresy URL
• Filtrowanie stron — analiza konkretnych zakresow stron, np. 1-5 lub 1,3,7-9

Wymagania dostepnosci

Narzedzie aktywuje sie tylko gdy OpenClaw moze rozwiazac model zdolny do przetwarzania PDF wedlug tego lancucha priorytetow:

1. Skonfigurowany pdfModel
2. Fallback do imageModel
3. Fallback do modelu sesji/domyslnego
4. Preferowani natywni dostawcy PDF (jesli uwierzytelnieni)

Parametry wejsciowe

• pdf (string) — pojedyncza sciezka lub URL do pliku PDF
• pdfs (tablica) — wiele plikow PDF, maksymalnie 10
• prompt (string) — instrukcje analizy (domyslnie ogolna analiza)
• pages (string) — skladnia wyboru stron
• model (string) — opcjonalne nadpisanie modelu
• maxBytesMb (number) — limit rozmiaru per PDF

Obslugiwane referencje

• Lokalne sciezki plikow (z rozwijaniem ~)
• URL-e file://
• URL-e http:// i https://
• Tryb sandbox blokuje zdalne URL-e HTTP(s)

Tryby przetwarzania

Tryb natywny (Anthropic / Google)

• Wysyla surowe bajty PDF bezposrednio do API
• Nie obsluguje filtrowania stron
• Wspiera wiele plikow PDF na wejsciu

Tryb fallback (inni dostawcy)

• Ekstrahuje tekst ze stron (domyslnie max 20)
• Renderuje do obrazow PNG jesli tekst jest ubogi (mniej niz 200 znakow)
• Uzywa budzetu 4 000 000 pikseli na obrazy

Obsluga bledow

• Brak PDF — blad wymaganego pola
• Przekroczenie 10 PDF — blad strukturalny
• Nieprawidlowe schematy URL — blad nieobslugiwanej referencji
• Tryb natywny z filtrami stron — blad niezgodnosci