agentic-x402
Make x402 payments to access gated APIs and content. Fetch paid resources, check wallet balance, and create payment links. Use when encountering 402 Payment Required responses or when the user wants to pay for web resources with crypto.
Why use this skill?
Use the agentic-x402 skill to automate USDC payments on Base. Access gated APIs, pay for web resources autonomously, and create crypto payment links.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ya7ya/agentic-x402What This Skill Does
The agentic-x402 skill provides an autonomous bridge between AI agents and the x402 payment protocol, specifically designed for the Base network using USDC. It allows your agent to handle HTTP 402 Payment Required status codes natively. Instead of stopping when it hits a paywall, the agent can use this skill to check the required price, verify it against user-defined security limits, and execute a crypto-based payment to unlock access to gated APIs or web content. Beyond consuming content, the skill serves as a full-featured tool for content creators, enabling the generation of monetized payment links and webhook integration for automated service delivery.
Installation
To integrate this skill, use the ClawHub registry: clawhub install openclaw/skills/skills/ya7ya/agentic-x402. Once installed, navigate to the local skill directory and execute npm install. The skill requires an .env file containing your EVM_PRIVATE_KEY and the desired X402_NETWORK configuration. Ensure the wallet is funded with both USDC for payments and ETH for gas fees on the Base network to ensure uninterrupted agent operations.
Use Cases
This skill is perfect for automated research agents that need to bypass paywalls on data aggregators or premium API endpoints. It is equally powerful for developers building 'agent-as-a-service' applications who want to gate their own API responses or exclusive datasets. By utilizing the x402 fetch command, an agent can be tasked with 'get the latest market data from this source,' and the system will intelligently manage the payment flow without requiring human intervention.
Example Prompts
- "Check my current wallet balance and tell me if I have enough USDC to access the premium news API at https://api.news.ai."
- "Use the x402 fetch tool to retrieve the content from https://data.provider.com/set-1 and automatically handle the payment if the cost is below $5.00."
- "Create a new payment link for my 'Market Analysis Report' priced at 2.50 USDC and save the link details to my records."
Tips & Limitations
Always define a reasonable X402_MAX_PAYMENT_USD environment variable or use the --max flag during execution to prevent unexpected drain of funds due to malicious or misconfigured paywalls. Use the --dry-run flag frequently when testing new API sources to verify price structures before authorizing actual blockchain transactions. Note that this skill currently requires manual maintenance of gas reserves, so monitor your ETH balance regularly alongside your USDC holdings.
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-ya7ya-agentic-x402": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, external-api