Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
xClaw02
Make x402 payments. Pay for APIs, sell your services, handle 402 Payment Required responses with USDC on Base and other EVM chains.
skill openclawclawhub Free
Make x402 payments. Pay for APIs, sell your services, handle 402 Payment Required responses with USDC on Base and other EVM chains.
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, _meta.json
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- 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.
New install
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
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.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 0.1.0
Provenance
- Publisher
- primer-dev
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
xClaw02
Your entry point into x402 - the open payment standard for the agentic web. x402 is an open protocol enabling instant stablecoin payments over HTTP using the 402 Payment Required status code. xClaw02, built by Primer, provides agent-friendly CLI tools and simple APIs for making and receiving payments.
When to Use This Skill
Use xClaw02 when: You encounter a 402 Payment Required HTTP response You need to access a paid API or resource The user asks you to pay for something with crypto/USDC You need to check wallet balance or manage payments You want to charge for your own API or service
How to Respond
User Says/AsksWhat to Do"I got a 402 error"This is an x402 payment request. Probe the URL with xclaw02 probe <url>, show the price, ask if they want to pay"Pay for this API"Use xclaw02 pay <url> --max-amount <amount> - always confirm amount with user first"Check my balance"Run xclaw02 wallet balance <address>"Set up x402" / "Set up payments"Run xclaw02 openclaw init"What networks do you support?"List supported networks (Base is primary; also Ethereum, Arbitrum, Optimism, Polygon)"How much does X cost?"Probe the URL with xclaw02 probe <url> to get pricing"Create a wallet"Run xclaw02 wallet create - remind user to save the private key securely"I want to charge for my API"Show the Express.js or FastAPI middleware examples
Node.js
npx xclaw02 openclaw init
Python
pip install xclaw02 xclaw02 openclaw init This will: Create a new wallet (or use existing) Save config to ~/.openclaw/skills/xclaw02/ Display your wallet address to fund with USDC on Base
How x402 Works
Request - You call a paid API 402 Response - Server returns payment requirements in headers Pay & Retry - Sign payment, retry request with PAYMENT-SIGNATURE header Access - Server verifies payment, settles on-chain, returns resource The payment is gasless for the payer - the facilitator handles gas fees.
CLI Commands
CommandDescriptionxclaw02 openclaw initSet up xClaw02 for this agentxclaw02 openclaw statusCheck setup status and balancexclaw02 probe <url>Check if URL requires payment and get pricexclaw02 pay <url>Pay for a resource (requires XCLAW02_PRIVATE_KEY)xclaw02 pay <url> --dry-runPreview payment without payingxclaw02 pay <url> --max-amount 0.10Pay with spending limitxclaw02 wallet createCreate a new walletxclaw02 wallet balance <address>Check USDC balance on Basexclaw02 wallet from-mnemonicRestore wallet from mnemonicxclaw02 networksList supported networks
Example CLI Output
$ xclaw02 probe https://api.example.com/paid { "status": "payment_required", "price": "0.05", "currency": "USDC", "network": "base", "recipient": "0x1234...abcd", "description": "Premium API access" } $ xclaw02 wallet balance 0xYourAddress { "address": "0xYourAddress", "network": "base", "balance": "12.50", "token": "USDC" } $ xclaw02 pay https://api.example.com/paid --max-amount 0.10 { "status": "success", "paid": "0.05", "txHash": "0xabc123...", "response": { ... } }
Node.js / TypeScript
const { createSigner, x402Fetch } = require('xclaw02'); // Private key format: 0x followed by 64 hex characters const signer = await createSigner('eip155:8453', process.env.XCLAW02_PRIVATE_KEY); const response = await x402Fetch('https://api.example.com/paid', signer, { maxAmount: '0.10' // Maximum USDC to spend }); const data = await response.json();
Python
from xclaw02 import create_signer, x402_requests import os # Private key format: 0x followed by 64 hex characters signer = create_signer('eip155:8453', os.environ['XCLAW02_PRIVATE_KEY']) with x402_requests(signer, max_amount='0.10') as session: response = session.get('https://api.example.com/paid') data = response.json()
Selling Your Services (Server-Side)
Want other agents to pay you? Add a paywall to your API:
Express.js
const express = require('express'); const { x402Express } = require('xclaw02'); const app = express(); app.use(x402Express('0xYourAddress', { '/api/premium': { amount: '0.05', // $0.05 USDC per request asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', network: 'eip155:8453' } })); app.get('/api/premium', (req, res) => { res.json({ data: 'Premium content here' }); });
FastAPI (Python)
from fastapi import FastAPI from xclaw02 import x402_fastapi app = FastAPI() app.add_middleware(x402_fastapi( '0xYourAddress', { '/api/premium': { 'amount': '0.05', 'asset': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', 'network': 'eip155:8453' } } )) @app.get("/api/premium") async def premium_endpoint(): return {"data": "Premium content here"}
Supported Networks
NetworkCAIP-2 IDTokenNotesBaseeip155:8453USDCPrimary - fast, cheap, recommendedBase Sepoliaeip155:84532USDCTestnetEthereumeip155:1USDCHigher feesArbitrumeip155:42161USDCOptimismeip155:10USDCPolygoneip155:137USDC Base is the default network. To use others, set XCLAW02_NETWORK environment variable.
Facilitators
Facilitators handle payment verification and on-chain settlement. The x402 ecosystem has many independent facilitators: NameURLNotesPrimerhttps://x402.primer.systemsDefaultCoinbasehttps://api.cdp.coinbase.com/platform/v2/x402x402.orghttps://x402.org/facilitatorTestnet onlyPayAIhttps://facilitator.payai.networkCorbitshttps://facilitator.corbits.devDexterhttps://x402.dexter.cashHeuristhttps://facilitator.heurist.xyzKobaruhttps://gateway.kobaru.ioNeverminedhttps://api.live.nevermined.app/api/v1/Openfacilitatorhttps://pay.openfacilitator.ioSolpayhttps://x402.solpay.cashxEchohttps://facilitator.xechoai.xyz To use a different facilitator, set XCLAW02_FACILITATOR environment variable.
Environment Variables
VariableFormatDescriptionXCLAW02_PRIVATE_KEY0x + 64 hex charsWallet private key (required for payments)XCLAW02_NETWORKeip155:8453, base, etc.Default network (default: base)XCLAW02_MAX_AMOUNT0.10Default max payment amount in USDCXCLAW02_FACILITATORURLFacilitator URL override
Error Handling
Error CodeMeaningWhat to DoINSUFFICIENT_FUNDSWallet balance too lowTell user to fund wallet with USDC on BaseAMOUNT_EXCEEDS_MAXPayment exceeds maxAmountAsk user to approve higher amount, then retry with --max-amountSETTLEMENT_FAILEDOn-chain settlement failedWait a moment and retry, or try a different facilitatorINVALID_RESPONSEMalformed 402 responseThe URL may not support x402 properlyNETWORK_MISMATCHWrong networkCheck the 402 response for required network, set XCLAW02_NETWORK
Security Notes
Never expose private keys in logs, chat, or output Use environment variables for wallet credentials Always confirm payment amounts with user before paying Fund wallets only with what's needed for the task Private key format: 0x followed by 64 hexadecimal characters
Alternative Implementations
x402 is an open standard with multiple implementations: Official Coinbase SDK - The reference implementation with Go support and Solana (SVM) in addition to EVM chains: GitHub: https://github.com/coinbase/x402 ClawHub: See the x402 skill by @notorious-d-e-v Best for: Go developers, Solana payments, full spec compliance When to use alternatives: You need Go support (xClaw02 is Node.js/Python only) You need Solana payments (xClaw02 is EVM only) You want the official reference implementation All x402 implementations are interoperable - a client using any SDK can pay a server using any other SDK, as long as they share a supported network and facilitator.
Links
x402 Protocol: https://x402.org SDK (npm): https://npmjs.com/package/xclaw02 SDK (PyPI): https://pypi.org/project/xclaw02 GitHub: https://github.com/primer-systems/xClaw02
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Config
- SKILL.md
- _meta.json