OpenClaw 2026.3.3 版本新增原生 PDF 分析工具，支持单/多文件输入及页面筛选。通过 Anthropic/Google 模型实现原生模式直接解析 PDF 字节，其他模型采用文本提取加图像渲染的回退方案。适用于报告总结、合同对比、论文速读等场景。需配置 pdfModel 或 imageModel 方可启用，默认限制 10MB 和 20 页。相比独立工具，其优势在于与 AI Agent 工作流无缝集成，可结合对话持续追问文档细节。
你是否遇到过这些场景？
PDF，可能是大多数人日常工作中最"难搞"的文件格式。
它看似简单——不过是 pages + text 的组合。但正是因为"简单"，反而带来了无尽的麻烦：
长期以来，我们处理 PDF 的方式基本只有两种：手动复制粘贴，或者花钱买专门的 PDF 解析服务。
但现在，OpenClaw 给了我们第三种选择。
在最新版本 v2026.03.03 Immutable 中，OpenClaw 正式推出了 PDF 分析工具（以下简称 PDF 工具）。
这是 OpenClaw 首次提供的一级原生工具，专门用于分析 PDF 文档并返回文本内容。
根据官方文档，PDF 工具支持以下能力：
| 功能 | 说明 |
|---|---|
| 单/多 PDF 输入 | 支持单文件（pdf）或多文件（pdfs），最多 10 个 |
| 页面筛选 | 可指定页面范围，如 1-5 或 1,3,7-9 |
| 自定义提示词 | 支持自定义分析指令，默认 Analyze this PDF document. |
| 模型选择 | 可覆盖默认模型，支持多提供商 |
| 大小限制 | 默认 10MB/文件，可配置 |
| 页数限制 | 默认最多 20 页，可配置 |
PDF 工具支持多种文件引用方式：
- 本地文件路径（支持 ~ 展开） - file:// URL - http:// 和 https:// URL
这意味着你可以直接让 AI 分析本地 PDF，也能让它读取在线文档。
这是最值得关注的部分。OpenClaw PDF 工具的实现分两种模式：
当使用 Anthropic 或 Google 模型时，PDF 工具会直接发送原始 PDF 字节给模型 API。
这意味着：
对于其他模型提供商（如 OpenAI），PDF 工具采用提取回退方案：
这个设计确保了无论使用什么模型，都能完成 PDF 分析任务。
PDF 工具会自动选择可用的模型，优先级如下：
1. agents.defaults.pdfModel（自定义配置）
2. agents.defaults.imageModel（回退到图片模型）
3. 提供商默认模型（基于可用认证自动选择）
默认配置使用 Claude Opus 4-6 作为主要模型，GPT-5 Mini 作为回退。
光看功能列表可能不够直观。让我列举几个真实使用场景：
假设你收到了一份 30 页的行业报告，只需要：
pdf: "/tmp/report.pdf"
prompt: "总结这份报告的 5 个核心观点"
AI 会在几秒钟内给出结构化的总结，比自己慢慢翻快几十倍。
如果你需要对比看几份类似的合同或方案：
pdfs: ["/tmp/contract_a.pdf", "/tmp/contract_b.pdf"]
prompt: "对比这两份合同的主要区别，特别是付款方式和违约条款"
这在以前需要人工逐页对比，现在 AI 一次性搞定。
如果你只关心 PDF 的某个部分：
pdf: "/tmp/paper.pdf"
pages: "1-5"
prompt: "提取这一部分的方法论章节"
页面筛选功能让你只分析需要的内容，节省 tokens 和时间。
研究生或研究人员可以用它来快速筛选论文：
pdf: "https://arxiv.org/paper/xxxx.pdf"
prompt: "用中文列出这篇论文的研究问题、方法和主要结论"
虽然是英文论文，但可以用中文提问，AI 会用中文回答。
PDF 工具不是默认一直可用的。它需要 OpenClaw 能解析到一个支持 PDF 的模型配置。
换句话说，你需要：
agents.defaults.pdfModel，或agents.defaults.imageModel，或如果以上都没有，PDF 工具不会被注册。
{"agents":{"defaults":{"pdfModel":{"primary":"anthropic/claude-opus-4-6","fallbacks":["openai/gpt-5-mini"]},"pdfMaxBytesMb":10,"pdfMaxPages":20}}}
工具会给出清晰的错误信息：
| 错误类型 | 说明 |
|---|---|
pdf required | 未提供 PDF 文件 |
too_many_pdfs | 超过 10 个文件限制 |
unsupported_pdf_reference | 不支持的 URI 方案 |
pages is not supported with native PDF providers | 原生模式不支持页面筛选 |
市面上已经有一些 PDF AI 分析工具，OpenClaw 的优势在哪里？
| 维度 | OpenClaw PDF 工具 | 其他方案 |
|---|---|---|
| 集成度 | 与 AI Agent 无缝集成 | 往往需要单独的工具/服务 |
| 多模型支持 | 原生 + 回退模式 | 通常只支持特定模型 |
| 灵活性 | 可自定义提示词、页面筛选 | 功能相对固定 |
| 成本 | 依赖已有模型配置 | 可能需要额外付费 |
| 隐私 | 可本地部署 | 数据可能上传第三方 |
最大的差异化在于：OpenClaw PDF 工具不是一个独立的产品，而是整个 AI Agent 能力的一部分。这意味着你可以：
答：支持。在提取回退模式下，如果文本提取失败（少于 200 字符），工具会自动将页面渲染为图片发送给模型。这意味着即使是扫描件，只要图片足够清晰，AI 也能"看到"内容。
答：目前不支持。如果 PDF 有密码保护，工具会返回错误。建议先解密后再使用。
答：默认 10MB，可通过 pdfMaxBytesMb 配置。如果文件过大，建议先拆分或压缩。
答：可以。工具本身不限制语言，关键是模型支持中文。建议使用 Claude Opus 4 或 GPT-5 等支持中文的模型。
答：区别很大。直接复制文字会丢失 PDF 的原始结构信息（标题层级、表格格式、图表位置等），而 PDF 工具在原生模式下可以直接理解文档结构，在回退模式下也会尽可能保留格式信息。
OpenClaw PDF 工具的推出，不仅仅是"多了一个功能"。
它代表的是：AI Agent 从"处理对话文本"进化到"理解各种格式的文档"。
以前，我们需要手动把 PDF 里的内容复制出来，发给 AI。现在，只需要把文件路径给到 AI，它自己就能读取、分析、总结。
这种变化看起来微小，但实际使用中会大幅提升效率。
想象一下：
这才是 AI 真正应该做的事情——成为你和文档之间的智能桥梁。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online