A specialized skill for automating TRC20 token payments to AI agent endpoints using the x402 protocol on the TRON network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tron-x402-payment
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tron-x402-payment using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TRON x402 Payment Skill?
The TRON x402 Payment skill is a robust integration designed for developers working with Openclaw Skills to facilitate seamless financial transactions between AI agents. It leverages the x402 protocol to handle 402 Payment Required responses automatically, ensuring that agent-to-agent or user-to-agent interactions are never interrupted by manual payment hurdles. By supporting popular TRC20 tokens like USDT and USDD, this skill empowers decentralized AI ecosystems on the TRON blockchain.
Built with security and developer experience in mind, this skill manages complex blockchain operations such as signing EIP-712 typed data and managing infinite approvals internally. It allows Openclaw Skills users to invoke paid API endpoints with the same ease as free ones, abstracting away the complexities of wallet balances, gas fees, and transaction signing.
TRON x402 Payment Skill Use Cases
- Invoking paid AI agent endpoints that require USDT or USDD payments per request.
- Automating discovery of agent capabilities through manifest and entrypoint listing.
- Handling binary data and image generation results from paid AI services.
- Managing micro-payments for high-frequency AI model inferences on the TRON network.
How TRON x402 Payment Skill Works
- The tool constructs the appropriate endpoint URL based on the provided base URL and entrypoint name.
- It initiates an HTTP request to the target agent endpoint.
- If the agent returns a 402 Payment Required status, the skill parses the payment requirements, including the amount and asset.
- The skill checks the local wallet balance and token allowance; if necessary, it performs an infinite approval transaction.
- It signs a payment permit using the configured TRON private key and retries the request with the required X-PAYMENT header.
- The final response, including any generated binary data saved to temporary files, is returned to the user.
TRON x402 Payment Skill Setup
To get started with this skill in Openclaw Skills, ensure your TRON environment is configured.
# Set your private key as an environment variable
export TRON_PRIVATE_KEY='your_private_key_here'
# (Optional) For Mainnet usage, set your TronGrid API Key
export TRON_GRID_API_KEY='your_api_key_here'
# Verify your configuration and wallet status
node dist/x402_tron_invoke.js --check
TRON x402 Payment Skill Data Schema & Taxonomy
The TRON x402 Payment skill manages metadata and binary outputs structured as follows:
| Feature | Description |
|---|---|
| Wallet Auth | Managed via TRON_PRIVATE_KEY or ~/.mcporter/mcporter.json. |
| Binary Storage | Images and binaries are saved to /tmp/x402_... |
| Response Schema | Returns JSON containing file_path, content_type, and bytes for binary data. |
| Token Config | Supports USDT/USDD contracts on Mainnet, Nile, and Shasta. |
TRON x402 Payment Skill Advanced Features
- Automatic infinite approval handling to minimize future transaction friction.
- Multi-network support spanning TRON Mainnet, Nile Testnet, and Shasta Testnet.
- Secure wallet status verification tools that prevent private key leakage in logs.
- Built-in binary and image handling for agents that generate media content.
SKILL.md
Loading
Related Openclaw Skills
Polymarket Scanner
An automated prediction market scanner and trading agent that leverages the Simmer API to identify and execute high-probability trades.
MRC Monitor
A background monitoring utility that tracks MRC canteen order statuses via Firebase and sends instant pickup notifications.
paper_scout
Automate the discovery and summarization of robotics research papers from top-tier academic journals and conferences.
Magic Quill
Magic Quill is an automated generator that creates themed YAML mappings to transform standard AI agent functions into immersive, lore-based spells.
Financial Analysis Skill
A sophisticated financial modeling tool for risk parity portfolio optimization and historical backtesting using local market data.
Financial Analysis Skill
A professional-grade financial toolkit for portfolio optimization, risk parity analysis, and automated backtesting using multi-source market data.
Featured*
