PDF ツール

​

利用可能性

1. agents.defaults.pdfModel（明示的なプライマリ／フォールバック）
2. agents.defaults.imageModel（明示的なプライマリ／フォールバック）
3. プロバイダーがネイティブ PDF 入力（Anthropic、Google）をサポートしているか、ビジョンモデルがすでに設定されている場合は、エージェントで解決されたセッション／デフォルトモデル
4. 使用可能な認証を持つ、自動検出された画像／ビジョン対応プロバイダー（ネイティブ PDF 対応プロバイダーを優先）

​

入力リファレンス

• pdf と pdfs は、読み込み前に統合および重複排除されます。少なくとも一方が必要です。
• pages は 1 始まりのページ番号として解析され、重複排除、並べ替えの後、agents.defaults.pdfMaxPages（デフォルト 20）の範囲内に制限されます。範囲内のページに 1 つも一致しない場合、モデル呼び出し前にエラーになります。

​

サポートされる PDF リファレンス

• ローカルファイルパス（~ の展開を含む）
• file:// URL
• http:// および https:// URL
• media://inbound/<id> など、OpenClaw が管理する受信リファレンス

​

実行モード

​

ネイティブプロバイダーモード

• pages はサポートされません。設定されている場合、ツールは pages is not supported with native PDF providers をスローします。
• password はサポートされません。設定されている場合、ツールは password is not supported with native PDF providers をスローします。暗号化された PDF には非ネイティブモデルを使用してください。

​

抽出フォールバックモード

1. バンドルされた document-extract Plugin を介して、選択されたページ（最大 agents.defaults.pdfMaxPages、デフォルト 20）からテキストを抽出します。この Plugin は、テキストおよび画像の抽出に 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 入力：pdf エントリを持つ details.pdfs[]
• サンドボックスのパス書き換えメタデータ（該当する場合）：rewrittenFrom

​

エラー動作

​

例

{
  "pdf": "/tmp/report.pdf",
  "prompt": "このレポートを 5 つの箇条書きで要約してください"
}

{
  "pdfs": ["/tmp/q1.pdf", "/tmp/q2.pdf"],
  "prompt": "両方のドキュメントにおけるリスクとタイムラインの変更を比較してください"
}

{
  "pdf": "https://example.com/report.pdf",
  "pages": "1-3,7",
  "model": "openai/gpt-5.4-mini",
  "prompt": "顧客に影響するインシデントのみを抽出してください"
}

{
  "pdf": "/tmp/locked.pdf",
  "password": "example-password",
  "model": "openai/gpt-5.4-mini",
  "prompt": "この契約書を要約してください"
}

​

関連項目

• ツールの概要 - 利用可能なすべてのエージェントツール
• 設定リファレンス - pdfMaxBytesMb および pdfMaxPages の設定