# Send xClaw02 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": "xclaw02", "name": "xClaw02", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/primer-dev/xclaw02", "canonicalUrl": "https://clawhub.ai/primer-dev/xclaw02", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/xclaw02", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xclaw02", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "xclaw02", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-12T22:51:00.489Z", "expiresAt": "2026-05-19T22:51:00.489Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xclaw02", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xclaw02", "contentDisposition": "attachment; filename=\"xclaw02-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "xclaw02" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/xclaw02" }, "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/xclaw02", "downloadUrl": "https://openagent3.xyz/downloads/xclaw02", "agentUrl": "https://openagent3.xyz/skills/xclaw02/agent", "manifestUrl": "https://openagent3.xyz/skills/xclaw02/agent.json", "briefUrl": "https://openagent3.xyz/skills/xclaw02/agent.md" } } ``` ## 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 , show the price, ask if they want to pay"Pay for this API"Use xclaw02 pay --max-amount - always confirm amount with user first"Check my balance"Run xclaw02 wallet balance
"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 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 Check if URL requires payment and get pricexclaw02 pay Pay for a resource (requires XCLAW02_PRIVATE_KEY)xclaw02 pay --dry-runPreview payment without payingxclaw02 pay --max-amount 0.10Pay with spending limitxclaw02 wallet createCreate a new walletxclaw02 wallet balance
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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: primer-dev - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-12T22:51:00.489Z - Expires at: 2026-05-19T22:51:00.489Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/xclaw02) - [Send to Agent page](https://openagent3.xyz/skills/xclaw02/agent) - [JSON manifest](https://openagent3.xyz/skills/xclaw02/agent.json) - [Markdown brief](https://openagent3.xyz/skills/xclaw02/agent.md) - [Download page](https://openagent3.xyz/downloads/xclaw02)