OpenClaw从入门到应用——工具（Tools）：PDF

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》pdfpdf用于分析一个或多个 PDF 文档并返回文本内容。快速行为概览对于 Anthropic 和 Google 模型提供商使用原生提供商模式。对于其他提供商使用提取回退模式先提取文本需要时再提取页面图像。支持单次pdf或多次pdfs输入每次调用最多处理 10 个 PDF 文件。可用性仅当 OpenClaw 能够为代理解析出支持 PDF 的模型配置时此工具才会被注册agents.defaults.pdfModel回退到agents.defaults.imageModel回退到基于可用认证的尽力而为的提供商默认值如果无法解析出可用的模型则不会公开pdf工具。输入参考pdfstring单个 PDF 路径或 URLpdfsstring[]多个 PDF 路径或 URL最多总共 10 个promptstring分析提示词默认为Analyze this PDF document.pagesstring页面筛选器例如1-5或1,3,7-9modelstring可选的模型覆盖格式为provider/modelmaxBytesMbnumber每个 PDF 的大小上限单位MB输入注意事项pdf和pdfs在加载前会被合并并去重。如果未提供 PDF 输入工具会报错。pages会被解析为从 1 开始的页码经过去重、排序后限制在配置的最大页数范围内。maxBytesMb默认为agents.defaults.pdfMaxBytesMb或10。支持的 PDF 引用本地文件路径包括~展开file://URLhttp://和https://URL引用注意事项其他 URI 方案例如ftp://会被拒绝并返回unsupported_pdf_reference。在沙盒模式下远程http(s)URL 会被拒绝。启用仅工作区文件策略时位于允许根目录之外的本地文件路径会被拒绝。执行模式原生提供商模式原生模式适用于anthropic和google提供商。该工具将原始 PDF 字节直接发送到提供商 API。原生模式限制不支持pages。如果设置了pages工具会返回错误。提取回退模式回退模式适用于非原生提供商。流程从选定的页面提取文本最多agents.defaults.pdfMaxPages页默认20页。如果提取的文本长度少于200个字符则将选定页面渲染为 PNG 图像并将其包含在内。将提取的内容加上提示词发送到选定的模型。回退模式详情页面图像提取使用4,000,000的像素预算。如果目标模型不支持图像输入并且没有可提取的文本工具会报错。提取回退需要pdfjs-dist以及用于图像渲染的napi-rs/canvas。配置{ agents: { defaults: { pdfModel: { primary: anthropic/claude-opus-4-6, fallbacks: [openai/gpt-5-mini], }, pdfMaxBytesMb: 10, pdfMaxPages: 20, }, }, }有关完整的字段详细信息请参阅配置参考。输出详情该工具在content[0].text中返回文本并在details中返回结构化元数据。常见的details字段model解析后的模型引用provider/modelnative原生提供商模式为true回退模式为falseattempts成功前失败的回退尝试次数路径字段单个 PDF 输入details.pdf多个 PDF 输入details.pdfs[]包含pdf条目沙盒路径重写元数据适用时rewrittenFrom错误行为缺少 PDF 输入抛出pdf required: provide a path or URL to a PDF document错误PDF 数量过多在details.error too_many_pdfs中返回结构化错误不支持的引用方案返回details.error unsupported_pdf_reference原生模式使用了pages抛出清晰的pages is not supported with native PDF providers错误示例单个 PDF{pdf:/tmp/report.pdf,prompt:Summarize this report in 5 bullets}多个 PDF{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-mini,prompt:Extract only customer-impacting incidents}