Công cụ PDF

• Chế độ nhà cung cấp gốc cho nhà cung cấp mô hình Anthropic và Google.
• Chế độ dự phòng trích xuất cho các nhà cung cấp khác (trích xuất văn bản trước, rồi ảnh trang khi cần).
• Hỗ trợ đầu vào đơn (pdf) hoặc nhiều (pdfs), tối đa 10 PDF mỗi lần gọi.

​

Khả dụng

1. agents.defaults.pdfModel
2. dự phòng sang agents.defaults.imageModel
3. dự phòng sang mô hình phiên/mặc định đã phân giải của tác nhân
4. nếu các nhà cung cấp PDF gốc được hỗ trợ bằng xác thực, ưu tiên chúng trước các ứng viên dự phòng ảnh chung

• Chuỗi dự phòng nhận biết xác thực. Một provider/model đã cấu hình chỉ được tính nếu OpenClaw thực sự có thể xác thực nhà cung cấp đó cho tác nhân.
• Các nhà cung cấp PDF gốc hiện là Anthropic và Google.
• Nếu nhà cung cấp phiên/mặc định đã phân giải đã có mô hình thị giác/PDF được cấu hình, công cụ PDF sẽ tái sử dụng mô hình đó trước khi dự phòng sang các nhà cung cấp được hỗ trợ bằng xác thực khác.

​

Tham chiếu đầu vào

• pdf và pdfs được hợp nhất và loại bỏ trùng lặp trước khi tải.
• Nếu không cung cấp đầu vào PDF, công cụ sẽ báo lỗi.
• pages được phân tích dưới dạng số trang bắt đầu từ 1, được loại bỏ trùng lặp, sắp xếp và giới hạn theo số trang tối đa đã cấu hình.
• password áp dụng cho mọi PDF trong yêu cầu và chỉ được chế độ dự phòng trích xuất sử dụng.
• maxBytesMb mặc định là agents.defaults.pdfMaxBytesMb hoặc 10.

​

Tham chiếu PDF được hỗ trợ

• đường dẫn tệp cục bộ (bao gồm mở rộng ~)
• URL file://
• URL http:// và https://
• tham chiếu đầu vào do OpenClaw quản lý như media://inbound/<id>

• Các lược đồ URI khác (ví dụ ftp://) bị từ chối với unsupported_pdf_reference.
• Trong chế độ hộp cát, URL http(s) từ xa bị từ chối.
• Khi bật chính sách tệp chỉ trong không gian làm việc, các đường dẫn tệp cục bộ bên ngoài gốc được phép sẽ bị từ chối.
• Tham chiếu đầu vào được quản lý và đường dẫn được phát lại trong kho phương tiện đầu vào của OpenClaw được cho phép với chính sách tệp chỉ trong không gian làm việc.

​

Chế độ thực thi

​

Chế độ nhà cung cấp gốc

• pages không được hỗ trợ. Nếu đặt, công cụ sẽ trả về lỗi.
• password không được hỗ trợ. Dùng mô hình không gốc để phân tích PDF được mã hóa.
• Đầu vào nhiều PDF được hỗ trợ; mỗi PDF được gửi dưới dạng khối tài liệu gốc / phần PDF nội tuyến trước lời nhắc.

​

Chế độ dự phòng trích xuất

1. Trích xuất văn bản từ các trang đã chọn (tối đa agents.defaults.pdfMaxPages, mặc định 20).
2. Nếu độ dài văn bản đã trích xuất dưới 200 ký tự, kết xuất các trang đã chọn thành ảnh PNG và đưa chúng vào.
3. Gửi nội dung đã trích xuất cùng lời nhắc đến mô hình đã chọn.

• Trích xuất ảnh trang dùng ngân sách pixel là 4,000,000.
• PDF được mã hóa có thể được mở bằng tham số cấp cao nhất password.
• Nếu mô hình đích không hỗ trợ đầu vào ảnh và không có văn bản có thể trích xuất, công cụ sẽ báo lỗi.
• Nếu trích xuất văn bản thành công nhưng trích xuất ảnh sẽ yêu cầu thị giác trên một mô hình chỉ văn bản, OpenClaw sẽ bỏ ảnh đã kết xuất và tiếp tục với văn bản đã trích xuất.
• Dự phòng trích xuất dùng Plugin document-extract được đóng gói. Plugin sở hữu clawpdf, cung cấp trích xuất văn bản và kết xuất ảnh thông qua PDFium WebAssembly.

​

Cấu hình

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

​

Chi tiết đầu ra

• model: tham chiếu mô hình đã phân giải (provider/model)
• native: true cho chế độ nhà cung cấp gốc, false cho dự phòng
• attempts: các lần thử dự phòng thất bại trước khi thành công

• đầu vào một PDF: details.pdf
• đầu vào nhiều PDF: details.pdfs[] với các mục pdf
• siêu dữ liệu ghi lại đường dẫn hộp cát (khi áp dụng): rewrittenFrom

​

Hành vi lỗi

• Thiếu đầu vào PDF: ném pdf required: provide a path or URL to a PDF document
• Quá nhiều PDF: trả về lỗi có cấu trúc trong details.error = "too_many_pdfs"
• Lược đồ tham chiếu không được hỗ trợ: trả về details.error = "unsupported_pdf_reference"
• Chế độ gốc với pages: ném lỗi rõ ràng pages is not supported with native PDF providers

​

Ví dụ

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

​

Liên quan

• Tổng quan công cụ - tất cả công cụ tác nhân hiện có
• Tham chiếu cấu hình - cấu hình pdfMaxBytesMb và pdfMaxPages