教程 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 寫作痕跡