postalform-machine-order
Send real postal mail through PostalForm using machine payments: prepare/validate print-and-mail payloads, submit `POST /api/machine/orders`, settle x402 payment with any compatible wallet client (purl or custom), and poll fulfillment through completion. Use when an agent must autonomously mail a real physical letter/document with strong first-pass correctness and idempotent retry behavior.
Why use this skill?
Learn how to use the PostalForm Machine Order skill to automate physical mail delivery, handle secure x402 payments, and track order fulfillment.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ggaabe/postalform-agent-mailingWhat This Skill Does
The postalform-machine-order skill enables autonomous agents to facilitate real-world physical mail delivery. By interfacing with the PostalForm API, agents can handle document submission, address validation, and payment settlement via the x402 protocol. This skill is designed for high-reliability scenarios, ensuring that critical documents—such as legal notices, invoices, or physical correspondence—are processed with strict idempotency and transparent tracking. It manages the entire lifecycle from pre-flight validation and quoting to payment signing and post-payment status polling.
Installation
To integrate this skill into your environment, run the following command in your terminal:
clawhub install openclaw/skills/skills/ggaabe/postalform-agent-mailing
Use Cases
- Automated Invoicing: Sending physical, legally-binding invoices or payment demand letters to clients who require paper documentation.
- Notices and Compliance: Automatically dispatching mandatory physical mail notifications for corporate or regulatory compliance.
- Direct Marketing: Scaling personalized physical mail campaigns where agent-driven address validation is required for delivery success.
- Official Correspondence: Managing secure physical document exchange for legal or formal business processes that mandate postal signatures or certified delivery.
Example Prompts
- "Send a certified mail copy of the contract PDF located at this URL to the client address in our database. Ensure you use the address validation step before submitting the order."
- "Draft and mail a physical payment reminder to the following recipient using the standard manual address format. Use our default printing settings for invoices and let me know when it's confirmed as paid."
- "Check the status of my recent physical mailing order with ID 99342-abc. If it is still pending payment, please initiate the x402 settlement flow using the connected wallet."
Tips & Limitations
- Idempotency: Always generate a unique
request_idbefore starting the workflow. If an error occurs, retry with the exact same payload to prevent double-billing or duplicate shipments. - Address Accuracy: Prefer the Loqate address strategy over manual entry to ensure delivery success. Manual addresses are prone to formatting errors that can lead to undeliverable mail.
- Payment Security: When using
purl, ensure your wallet alias is configured and passwords are handled via secure runtime inputs. Never hardcode credentials in your agent prompts or configuration files. - Polling: Do not rush the polling process. After settlement, there is often a short delay while the system confirms the webhook receipt; implement a backoff strategy if the server returns a pending status.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ggaabe-postalform-agent-mailing": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api