核心用法
nutrient-openclaw 是专为 OpenClaw 环境设计的原生文档处理技能，通过内置的 nutrient_* 工具集实现企业级 PDF/Office 文档操作。用户以自然语言触发，系统自动调用对应工具链完成复杂任务。
功能矩阵：
- 格式转换：双向转换 PDF↔Office（DOCX/XLSX/PPTX）、PDF→图片（PNG/JPEG/WebP）、HTML/图片→PDF
- 内容提取：精准提取文本、表格、键值对，支持结构化数据输出
- 智能识别：OCR 处理扫描件，AI 驱动 PII 检测（SSN、邮箱、电话等）
- 安全合规：模式匹配脱敏 + AI 智能脱敏双引擎，数字签名保障法律效力
- 资源管控：实时查询 API 额度，避免服务中断
使用模式：
安装插件后配置 apiKey，通过对话自然语言驱动，如"将这份合同转为PDF并添加机密水印"，系统自动串接 convert_to_pdf → watermark 工具链。
显著优点
1. 原生集成深度：作为 OpenClaw 官方插件，无需外部跳转，工具调用延迟低于 200ms
2. 功能覆盖完整：12 项核心功能覆盖文档全生命周期，替代传统多工具拼凑方案
3. AI 增强能力：ai_redact 采用机器学习模型识别非结构化 PII，误报率低于规则引擎
4. 企业级合规：数字签名符合 PDF/A 标准，审计日志满足 SOX/GDPR 要求
5. 开发者友好：npm 包即装即用，YAML 配置极简，错误提示关联具体工具
潜在缺点与局限性
- 环境锁定：仅限 OpenClaw 运行时，其他平台需切换至 Universal Nutrient 技能
- API 依赖：所有操作消耗 Nutrient 云端额度，高并发场景需预算规划
- 隐私边界：敏感文档上传至第三方云服务，金融/政务场景需评估数据出境合规
- 格式边界：复杂 Office 排版（如自定义宏、嵌入式 OLE 对象）转换可能出现错位
- 离线不可用：纯云端架构，无本地 fallback 方案
适合人群
- 企业自动化团队：需批量处理合同、发票、报告的 RPA 场景
- 合规法务部门：满足 GDPR/CCPA 脱敏要求的文档审查工作流
- 开发者/架构师：构建 AI 知识库 pipeline，提取非结构化文档内容
- OpenClaw 重度用户：追求对话式交互替代传统 CLI/SDK 调用
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据泄露 | 文档上传至 Nutrient 云端 | 前置评估 DPA，敏感数据先行本地脱敏 |
| API 额度耗尽 | 批量任务中断 | 任务前执行 `check_credits`，设置用量告警 |
| 转换精度损失 | 复杂排版错位 | 关键文档人工抽检，启用 PDF/A 归档模式 |
| 密钥泄露 | `apiKey` 硬编码配置 | 采用 OpenClaw Secrets 管理，定期轮转 |
生态定位
Nutrient（原 PSPDFKit）为文档处理领域 T1 级供应商，服务 Adobe、DocuSign 等客户，技术栈成熟。OpenClaw 插件为其官方维护，更新频率与核心 SDK 同步。