OpenClaw 2026.3.3 新增 AI 解析 PDF 功能实测

提取回退模式（Extraction Fallback Mode）

对于其他模型提供商（如 OpenAI），PDF 工具采用提取回退方案：

1. 文本提取：首先尝试从指定页面提取文本（最多 20 页）
2. 图像渲染：如果提取的文本少于 200 字符，则将页面渲染为 PNG 图片
3. 发送给模型：将提取的内容连同提示词一起发送给模型

这个设计确保了无论使用什么模型，都能完成 PDF 分析任务。

模型优先级

PDF 工具会自动选择可用的模型，优先级如下：

1. agents.defaults.pdfModel（自定义配置）
2. agents.defaults.imageModel（回退到图片模型）
3. 提供商默认模型（基于可用认证自动选择）

默认配置使用 Claude Opus 4-6 作为主要模型，GPT-5 Mini 作为回退。

实测：用 PDF 工具能做什么？

光看功能列表可能不够直观。让我列举几个真实使用场景：

场景一：快速提取报告核心观点

假设你收到了一份 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，或
• 有可用的 Anthropic/Google/OpenAI API 认证

如果以上都没有，PDF 工具不会被注册。

配置示例

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

错误处理

工具会给出清晰的错误信息：

对比同类工具

市面上已经有一些 PDF AI 分析工具，OpenClaw 的优势在哪里？

最大的差异化在于：OpenClaw PDF 工具不是一个独立的产品，而是整个 AI Agent 能力的一部分。这意味着你可以：

• 在分析 PDF 的同时，让 AI 执行其他任务
• 将 PDF 内容融入更大的工作流
• 用对话的方式持续追问 PDF 中的细节

常见问题解答

Q1：PDF 工具支持扫描件吗？

答：支持。在提取回退模式下，如果文本提取失败（少于 200 字符），工具会自动将页面渲染为图片发送给模型。这意味着即使是扫描件，只要图片足够清晰，AI 也能"看到"内容。

Q2：可以分析加密的 PDF 吗？

答：目前不支持。如果 PDF 有密码保护，工具会返回错误。建议先解密后再使用。

Q3：最大支持多大的文件？

答：默认 10MB，可通过 pdfMaxBytesMb 配置。如果文件过大，建议先拆分或压缩。

Q4：可以分析中文 PDF 吗？

答：可以。工具本身不限制语言，关键是模型支持中文。建议使用 Claude Opus 4 或 GPT-5 等支持中文的模型。

Q5：和直接复制文字到对话中有什么区别？

答：区别很大。直接复制文字会丢失 PDF 的原始结构信息（标题层级、表格格式、图表位置等），而 PDF 工具在原生模式下可以直接理解文档结构，在回退模式下也会尽可能保留格式信息。

总结：PDF 工具意味着什么？

OpenClaw PDF 工具的推出，不仅仅是"多了一个功能"。

它代表的是：AI Agent 从"处理对话文本"进化到"理解各种格式的文档"。

以前，我们需要手动把 PDF 里的内容复制出来，发给 AI。现在，只需要把文件路径给到 AI，它自己就能读取、分析、总结。

这种变化看起来微小，但实际使用中会大幅提升效率。

想象一下：

• 以后收到一份 PDF，不再需要"先看一遍再问 AI"
• 直接让 AI 分析 PDF，然后针对具体内容提问
• 甚至可以让 AI 在后台批量处理多个 PDF，提取你需要的信息

这才是 AI 真正应该做的事情——成为你和文档之间的智能桥梁。