# Send Send real Document in the Mail via PostalForm to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "postalform-agent-mailing", "name": "Send real Document in the Mail via PostalForm", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ggaabe/postalform-agent-mailing", "canonicalUrl": "https://clawhub.ai/ggaabe/postalform-agent-mailing", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/postalform-agent-mailing", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=postalform-agent-mailing", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "agents/openai.yaml", "references/payload_templates.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/postalform-agent-mailing" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/postalform-agent-mailing", "downloadUrl": "https://openagent3.xyz/downloads/postalform-agent-mailing", "agentUrl": "https://openagent3.xyz/skills/postalform-agent-mailing/agent", "manifestUrl": "https://openagent3.xyz/skills/postalform-agent-mailing/agent.json", "briefUrl": "https://openagent3.xyz/skills/postalform-agent-mailing/agent.md" } } ``` ## Documentation ### PostalForm Machine Order Use this workflow when an agent needs to send real postal mail (a physical print-and-mail order) reliably on the first attempt. ### 1. Collect inputs and choose address strategy Require these inputs: buyer_name, buyer_email sender_name, recipient_name PDF source (upload_token, { download_url, file_id }, data URL, or allowed https URL) Mailing options (double_sided, color, mail_class, certified) For each party (sender, recipient), choose exactly one strategy: Manual address: *_address_type: "Manual" + *_address_manual Loqate address: *_address_type: "Address" + *_address_id + *_address_text Do not mix manual + Loqate for the same party. ### 2. Build payload with strict idempotency Generate a UUID request_id once and keep payload bytes stable across retries. Set buyer_email every time (required for Stripe receipt routing). For manual addresses: Include line1, city, state, zip Include line2 only when it has a non-empty string value Omit optional fields instead of sending null Use the tested template in references/payload_templates.md. ### 3. Preflight with validate endpoint (recommended) Call: POST https://postalform.com/api/machine/orders/validate If response is 200, confirm: quote.page_count matches expected page count quote.price_usd and options are acceptable If response is 422, fix payload before paying. ### 4. Create order and settle x402 payment Endpoint: POST https://postalform.com/api/machine/orders Flow: Send order payload without payment header. Receive 402 with PAYMENT-REQUIRED. Create payment using your wallet stack on the requested network. Retry the exact same request body with PAYMENT-SIGNATURE. Expect 202 and settlement metadata. Payment client options: purl CLI (fastest path when available) Any x402-compliant client (@x402/core, @x402/evm, or equivalent custom signer flow) If using purl: Prefer wallet alias/keystore over raw private keys Use --password from secure runtime input Set a protective --max-amount Match --network to PAYMENT-REQUIRED network ### 5. Poll order status until post-payment completion Call: GET https://postalform.com/api/machine/orders/:request_id Treat this as complete when: is_paid = true current_step has advanced through processing (commonly to email_sent) order_complete_url is a real URL Handle transitional state: status: "settled_pending_webhook" can persist briefly after on-chain settlement Continue polling with backoff; do not resubmit a changed payload under the same request_id ### Required invariants Keep request_id constant for retries of the same logical order. Keep payload unchanged when retrying after 402. Send buyer_email always. Match payment network to PAYMENT-REQUIRED; do not hardcode network. Use only valid US addresses and one address strategy per party. Verify page count and quoted price before payment. ### Observed failure modes and prevention 422 invalid_type on manual line2: Cause: empty optional fields normalized as null. Prevent: omit line2 unless non-empty string. Delay after successful payment (settled_pending_webhook): Cause: settlement acknowledged before webhook reconciliation completes. Prevent: poll for up to several minutes with retry/backoff. Occasional non-JSON/transient server response during polling: Cause: temporary upstream/render errors. Prevent: parse defensively; if response is non-JSON or 5xx, retry without changing request_id or payload. 409 request_id_mismatch: Cause: same request_id reused with modified payload. Prevent: generate a new UUID for changed orders; reuse ID only for exact retries. ### Security Rules Avoid printing wallet passwords, private keys, or sensitive env vars in logs. Prefer encrypted keystore wallets over raw private keys when tooling supports both. Use a payment cap (max amount) to avoid accidental overpayment. ### Operator Output Return these values after execution: request_id / order_id price/quote summary (including page_count) payment settlement details (network, pay_to, settlement_tx, settled_at) latest status (is_paid, current_step) order_complete_url when available Reference examples and command snippets: references/payload_templates.md ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ggaabe - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/postalform-agent-mailing) - [Send to Agent page](https://openagent3.xyz/skills/postalform-agent-mailing/agent) - [JSON manifest](https://openagent3.xyz/skills/postalform-agent-mailing/agent.json) - [Markdown brief](https://openagent3.xyz/skills/postalform-agent-mailing/agent.md) - [Download page](https://openagent3.xyz/downloads/postalform-agent-mailing)