Nutrient Openclaw

Metered-call gate

For every credit-consuming invocation, complete these steps in order:

1. Resolve the exact tool, operation, input, proposed output, and page selection. State pages as an inclusive range or explicit list when known. If page count is unknown, say so and obtain a bounded estimate before calling.
2. State that the selected file or pages will be transferred to Nutrient DWS.
3. Produce a numeric estimate or bounded range using Nutrient's current official pricing. For Build-compatible workflows, prefer the official non-processing Analyze calculation when a protected authenticated capability is already available; Analyze is free and must not execute the Build. Plugin 0.1.1 exposes no Analyze tool, so otherwise use the current official pricing table and state page-count, conversion, action, and uncertainty assumptions. Never improvise a raw authenticated shell request.
4. nutrient_check_credits may provide context, but label it prior local state. It cannot replace an estimate or authorize processing.
5. Immediately before the tool call, present the exact block below and obtain an explicit yes/no answer. Do not interleave unrelated work or change the payload after approval.

DWS call awaiting confirmation
- Tool: <exact tool>
- Operation: <exact action and format/options>
- Input: <exact file>
- Output: <new non-overwriting path>
- Pages: <inclusive range/list, or unknown with bounded assumption>
- External transfer: selected input/pages to Nutrient DWS
- Estimated credits: <number or bounded range>
- Estimate source and assumptions: <official source, page/conversion/action assumptions>
Proceed with this one call?

One approval authorizes one unchanged invocation. A retry, changed option, changed page range, chained stage, or verification render needs its own refreshed estimate and action-time confirmation. Never infer retry approval from the original answer. After a successful result, report the tool's actual credit usage if returned, but do not describe a remaining balance as exact because deductions can be pending.

If no supportable numeric or bounded estimate is available, do not call the processing tool. Explain what current pricing or document information is missing.

Staged high-risk workflows

AI redaction

1. Prefer nutrient_redact when deterministic presets cover the request.
2. For semantic redaction, agree on the exact criteria, source, pages, and separate candidate-output path. Explain that plugin 0.1.1 has no AI-redaction dry-run and the output is permanently redacted.
3. Estimate and confirm the single nutrient_ai_redact call immediately before running it.
4. Treat the output as a candidate only. A human must inspect every affected page for misses, false positives, layout damage, and recoverable hidden content before distribution.
5. If page rendering is needed for inspection, estimate and confirm the nutrient_convert_to_image verification call separately. Never distribute or replace the source automatically.

Signing

1. Confirm the exact document, output, intended signer/authority, signature purpose, required standard, jurisdiction, and the user's right to sign.
2. Explain that plugin 0.1.1 exposes DWS CMS/CAdES signing options but no user-controlled certificate or private-key input. The resulting operation is not, by itself, proof of signer identity, authority, consent, or legal sufficiency.
3. Stop and route to an approved signing workflow if certificate custody, qualified/electronic-signature compliance, identity proofing, countersignatures, or regulated retention is required. Obtain human/legal approval where applicable.
4. Only for a compatible use case, estimate and confirm the exact nutrient_sign call. Preserve the source and verify the resulting signature and visible appearance before release.

Failure and output rules

• On authentication, quota, timeout, or server failure, preserve the source and partial evidence without exposing secrets.
• Diagnose from redacted errors and current manifest/tool schemas. Do not print configuration or environment values.
• Do not automatically retry. Recompute the estimate and ask again immediately before each retry.
• Do not claim success from file existence alone. Verify the requested output type, selected pages, non-overwrite path, and applicable redaction/signing review.

Official sources

• Pinned plugin source
• npm package
• OpenClaw skills
• OpenClaw secrets
• OpenClaw tool plugins
• Nutrient credit calculation