教程 17 — OpenClaw Nano PDF Skill 教程：用自然语言指令合并、拆分、压缩 PDF（2026）
目标：安装 Nano PDF Skill，让 OpenClaw 用自然语言处理 PDF：合并、拆分、提取页面、压缩、加水印，全部本地执行无需上传。
什么是 Nano PDF Skill？
nano-pdf skill 本地处理 不上传云端 是这个 Skill 的最大卖点。市面上的在线 PDF 工具（Smallpdf、iLovePDF 等）都需要把文件上传到服务器，存在数据隐私风险。
Nano PDF Skill 基于本地 CLI 工具运行，所有处理在你的设备完成，文件不离开本地。支持操作：
| 操作 | 说明 |
|---|---|
| 合并 | 多个 PDF 合并成一个 |
| 拆分 | 按页范围提取子文档 |
| 压缩 | 减小文件体积，可选质量等级 |
| 加水印 | 文字水印或图片水印 |
| 提取文字 | 读取 PDF 中的所有文本内容 |
| 批量处理 | 一条指令处理多个文件 |
ClawHub 第七热门 Skill（78k 下载），作者是 Peter Steinberger（@steipete），知名 iOS 开发者。
第一步：安装依赖 CLI 工具
Nano PDF Skill 依赖 nano-pdf CLI。先安装：
npm install -g nano-pdf验证安装：
nano-pdf --version
# 应输出版本号，如 2.1.0如果提示权限错误，使用：
sudo npm install -g nano-pdf或切换到 nvm 管理的 Node.js 环境：
nvm use 20
npm install -g nano-pdf第二步：安装 Skill
在 WebChat 或 Telegram 中发送：
/install @steipete/nano-pdf
验证安装：
pnpm openclaw skills list
# 列表中应出现 nano-pdf第三步：合并多个 PDF
openclaw 合并 pdf 文件 命令 是最常用的操作，直接用自然语言描述：
把 ~/Documents/第一章.pdf、~/Documents/第二章.pdf、~/Documents/第三章.pdf 合并成一个文件，保存到桌面，命名为 完整版.pdf
AI 会调用以下命令：
nano-pdf merge \
~/Documents/第一章.pdf \
~/Documents/第二章.pdf \
~/Documents/第三章.pdf \
-o ~/Desktop/完整版.pdf合并时还可以指定顺序和添加书签：
合并这三个 PDF 并为每个原始文件创建书签，方便跳转：
~/Documents/第一章.pdf ~/Documents/第二章.pdf ~/Documents/第三章.pdf
第四步：拆分 PDF（按页范围提取）
openclaw 提取 pdf 指定页 保存 支持灵活的页面选择方式：
把 ~/Downloads/报告.pdf 的第 5 到第 20 页提取出来，保存为 摘要部分.pdf
nano-pdf extract ~/Downloads/报告.pdf --pages 5-20 -o ~/Desktop/摘要部分.pdf也可以提取不连续的页面：
从 ~/Downloads/合同.pdf 提取第 1 页、第 3 页和第 7-10 页，合并保存
nano-pdf extract ~/Downloads/合同.pdf --pages 1,3,7-10 -o ~/Desktop/关键条款.pdf把一份 100 页的 PDF 拆成每 10 页一个文件：
把 ~/Downloads/手册.pdf 每 10 页拆成一个文件，保存到 ~/Desktop/手册分册/ 目录
第五步：压缩 PDF
openclaw 压缩 pdf 不损画质 支持四个质量等级：
压缩 ~/Downloads/演示文稿.pdf，保持高画质，压缩后保存到同目录
nano-pdf compress ~/Downloads/演示文稿.pdf --quality high -o ~/Downloads/演示文稿_compressed.pdf四个质量等级对比：
| 等级 | 参数 | 体积缩减 | 适合场景 |
|---|---|---|---|
| 高清 | --quality high |
约 20-30% | 印刷、存档 |
| 标准 | --quality medium |
约 50-60% | 日常分享 |
| 网页 | --quality screen |
约 70-80% | 网页展示、邮件附件 |
| 极小 | --quality low |
约 85-90% | 仅需文字可读 |
第六步：加水印
openclaw 给 pdf 加水印 自动化 支持文字和图片两种水印：
文字水印：
给 ~/Documents/报价单.pdf 加上"机密文件"水印，灰色半透明，斜 45 度，每页都有
nano-pdf watermark ~/Documents/报价单.pdf \
--text "机密文件" \
--color gray \
--opacity 0.3 \
--angle 45 \
-o ~/Documents/报价单_watermarked.pdf图片水印（如公司 Logo）：
给 ~/Documents/合同.pdf 每页右下角加上公司 Logo 水印：~/Assets/logo.png
nano-pdf watermark ~/Documents/合同.pdf \
--image ~/Assets/logo.png \
--position bottom-right \
--opacity 0.5 \
-o ~/Documents/合同_watermarked.pdf第七步：提取 PDF 中的文字内容
把 PDF 中的文字导出为纯文本，方便后续处理：
读取 ~/Downloads/年报.pdf 的全部文字内容，整理成 Markdown 格式
nano-pdf extract-text ~/Downloads/年报.pdf -o ~/Desktop/年报内容.md提取后可以直接让 AI 分析：
提取 ~/Downloads/合同.pdf 的所有文字，找出其中的违约责任条款
第八步：批量处理多个文件
一次处理多个文件，无需逐个操作：
把 ~/Downloads/发票/ 目录下所有 PDF 文件都压缩一遍，覆盖原文件
nano-pdf compress ~/Downloads/发票/*.pdf --quality medium --overwrite把桌面上所有 PDF 加上"草稿"水印
nano-pdf watermark ~/Desktop/*.pdf --text "草稿" --opacity 0.2 --overwrite常见问题
OpenClaw 能处理加密的 PDF 吗？
可以，但需要提供密码。告诉 AI "这个 PDF 有密码，密码是 12345" 即可，Skill 会在命令中带入密码参数：nano-pdf merge file.pdf --password 12345。如果你想去除 PDF 的密码保护（在你有权操作的文件上），可以说"去掉这个 PDF 的密码保护，我有权限，密码是 xxx"。
Nano PDF 和直接用 AI 读 PDF 有什么区别？
直接让 AI 读 PDF 是"理解内容"——AI 把 PDF 当文本分析，输出是文字回答。Nano PDF 是"操作文件"——输出是一个新的 PDF 文件，文件结构、格式、图片、排版全部保留。前者适合问答分析，后者适合文件处理。两者可以配合：先用 Nano PDF 提取指定页，再让 AI 分析提取出的内容。
处理大文件（100MB+）会卡吗？
不会卡死，但处理时间会变长。nano-pdf CLI 基于本地 CPU 运行，100MB 的 PDF 压缩通常需要 10-30 秒。批量处理时建议在指令里加上"后台运行，完成后通知我"，Proactive Agent 会在处理完成后推送通知而不是让你等待。超大文件（500MB+）建议先拆分成小块再处理。
PDF 处理完会保存到哪里？
默认保存到你在指令中指定的路径。如果你没有指定路径，Skill 会询问你想保存在哪里，或默认保存到与原文件相同的目录，文件名加上操作类型后缀（如 报告_compressed.pdf、报告_merged.pdf）。所有处理结果都在本地，不会上传到任何云服务。
下一步
- 教程 18 — 安装 Humanizer Skill，5 步消除文章里的 AI 写作痕迹