教程 17

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

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注