openclaw-pdf-tools（OpenClaw PDF tools 开发）

📄 PDF工具箱

一个强大的本地PDF处理技能，无需联网，保护隐私安全。

功能特性

• ✅ PDF合并 - 多个PDF合并为一个
• ✅ PDF拆分 - 按页码拆分PDF
• ✅ PDF压缩 - 减小PDF文件大小
• ✅ PDF转图片 - 将PDF页面转为图片
• ✅ 图片转PDF - 将图片合并为PDF
• ✅ PDF提取文字 - 提取PDF中的文本内容
• ✅ PDF添加水印 - 为PDF添加文字水印
• ✅ PDF加密/解密 - 设置或移除PDF密码

安装

npx clawhub@latest install pdf-toolkit

依赖

需要安装以下系统依赖：

# Ubuntu/Debian
sudo apt-get install poppler-utils ghostscript imagemagick

# macOS
brew install poppler ghostscript imagemagick

# Windows (使用 scoop 或 chocolatey)
scoop install poppler ghostscript imagemagick
# 或
choco install poppler ghostscript imagemagick

使用方法

1. PDF合并

node scripts/merge.js file1.pdf file2.pdf output.pdf

2. PDF拆分

# 拆分为单页
node scripts/split.js input.pdf output_dir/

# 按页码范围拆分
node scripts/split.js input.pdf output.pdf 1-5

3. PDF压缩

node scripts/compress.js input.pdf output.pdf

4. PDF转图片

# 转换所有页面
node scripts/pdf2img.js input.pdf output_dir/

# 指定分辨率 (dpi)
node scripts/pdf2img.js input.pdf output_dir/ --dpi 150

5. 图片转PDF

node scripts/img2pdf.js image1.png image2.jpg output.pdf

6. 提取文字

node scripts/extract-text.js input.pdf output.txt

7. 添加水印

node scripts/watermark.js input.pdf "机密文件" output.pdf

8. 加密/解密

# 加密
node scripts/encrypt.js input.pdf output.pdf password123

# 解密
node scripts/decrypt.js input.pdf output.pdf password123

API示例

也可以在代码中直接调用：

const { merge, split, compress, pdf2img, img2pdf } = require('pdf-toolkit');

// 合并PDF
await merge(['file1.pdf', 'file2.pdf'], 'merged.pdf');

// 拆分PDF
await split('input.pdf', 'output_dir/');

// 压缩PDF
await compress('input.pdf', 'compressed.pdf');

// PDF转图片
await pdf2img('input.pdf', 'output_dir/', { dpi: 150 });

// 图片转PDF
await img2pdf(['img1.png', 'img2.jpg'], 'output.pdf');

注意事项

1. 处理大文件时可能需要较长时间
2. 加密的PDF需要先解密才能进行其他操作
3. ImageMagick默认限制了PDF转换，可能需要修改配置：

   # 编辑 /etc/ImageMagick-6/policy.xml
   # 将 <policy domain="coder" rights="none" pattern="PDF" />
   # 改为 <policy domain="coder" rights="read|write" pattern="PDF" />

常见问题

Q: 为什么PDF转图片失败？

A: 检查ImageMagick的安全策略配置，详见上方注意事项。

Q: 压缩效果不明显？

A: 压缩效果取决于PDF内容类型。图片较多的PDF压缩效果更明显。

Q: 支持中文文件名吗？

A: 支持，但建议使用英文路径避免编码问题。

更新日志

v1.0.0 (2026-03-23)

• 初始版本
• 支持基础PDF操作

许可证

MIT License