أداة PDF

​

التوفّر

1. agents.defaults.pdfModel (النموذج الأساسي/البدائل المحددة صراحةً)
2. agents.defaults.imageModel (النموذج الأساسي/البدائل المحددة صراحةً)
3. نموذج الجلسة/النموذج الافتراضي المحدد للوكيل، إذا كان مزوّده يدعم إدخال PDF الأصلي (Anthropic وGoogle) أو لديه بالفعل نموذج رؤية مُهيّأ
4. المزوّدون المكتشفون تلقائيًا والقادرون على معالجة الصور/الرؤية ولديهم مصادقة صالحة، مع تفضيل المزوّدين الذين يدعمون PDF الأصلي أولًا

​

مرجع الإدخال

• تُدمج pdf وpdfs وتُزال التكرارات قبل التحميل؛ ويجب توفير واحدة منهما على الأقل.
• تُحلّل pages بوصفها أرقام صفحات تبدأ من 1، ثم تُزال التكرارات وتُرتّب وتُقيّد بحد agents.defaults.pdfMaxPages (القيمة الافتراضية 20). يؤدي النطاق الذي لا يطابق أي صفحات ضمن الحدود إلى خطأ قبل استدعاء النموذج.

​

مراجع PDF المدعومة

• مسار ملف محلي (بما في ذلك توسيع ~)
• عنوان URL من نوع file://
• عنوان URL من نوع http:// أو https://
• المراجع الواردة التي يديرها OpenClaw، مثل media://inbound/<id>

​

أوضاع التنفيذ

​

وضع المزوّد الأصلي

• pages غير مدعومة؛ وإذا ضُبطت، ترمي الأداة الخطأ pages is not supported with native PDF providers.
• password غير مدعومة؛ وإذا ضُبطت، ترمي الأداة الخطأ password is not supported with native PDF providers. استخدم نموذجًا غير أصلي لملفات PDF المشفّرة.

​

وضع الاستخراج الاحتياطي

1. استخراج النص من الصفحات المحددة (حتى agents.defaults.pdfMaxPages، والقيمة الافتراضية 20) عبر Plugin document-extract المضمّن، الذي يستخدم حزمة clawpdf ‏(PDFium WebAssembly) لاستخراج النصوص والصور.
2. إذا كان النص المستخرج أقصر من 200 حرف، تُصيَّر الصفحات نفسها إلى صور PNG. تبلغ ميزانية التصيير الإجمالية 4,000,000 بكسل، وهي مشتركة بين جميع الصفحات التي تحتاج إلى صور (وتُخصّص تناسبيًا لكل صفحة متبقية، وليس لكل صفحة على حدة)، لذلك تتخطى الصفحات النصية التي تحتوي بالفعل على نص كافٍ عملية التصيير بالكامل.
3. إرسال النص المستخرج (وأي صور مُصيَّرة) مع الموجّه إلى النموذج المحدد.

• تُفتح ملفات PDF المشفّرة باستخدام المَعلم password ذي المستوى الأعلى.
• إذا كان النموذج لا يدعم إدخال الصور ولا يوجد نص قابل للاستخراج، تُرجع الأداة خطأ.
• إذا فشل تصيير الصور، يتجاهل OpenClaw الصور ويتابع باستخدام النص المستخرج.
• إذا كان النموذج المستهدف نصيًا فقط وأنتج الاستخراج صورًا، يتجاهل OpenClaw الصور ويرسل النص فقط.

​

الإعداد

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

​

تفاصيل الإخراج

• model: مرجع النموذج المحدد (provider/model)
• native: القيمة true لوضع المزوّد الأصلي، وfalse للوضع الاحتياطي
• attempts: محاولات البدائل التي فشلت قبل النجاح

• إدخال ملف PDF واحد: details.pdf
• إدخال عدة ملفات PDF: ‏details.pdfs[] مع إدخالات pdf
• البيانات الوصفية لإعادة كتابة المسار في البيئة المعزولة (عند انطباق ذلك): rewrittenFrom

​

سلوك الأخطاء

​

أمثلة

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

​

ذو صلة

• نظرة عامة على الأدوات - جميع أدوات الوكيل المتاحة
• مرجع الإعداد - إعدادا pdfMaxBytesMb وpdfMaxPages