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/Asks	What 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 |

Quick Setup

Node.js

CODEBLOCK0

Python

CODEBLOCK1

This will:

1. Create a new wallet (or use existing)
Save config to INLINECODE6
Display your wallet address to fund with USDC on Base

How x402 Works

1. 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

Command	Description
INLINECODE8	Set up xClaw02 for this agent
INLINECODE9

Example CLI Output

CODEBLOCK2

Using in Code

Node.js / TypeScript

CODEBLOCK3

Python

CODEBLOCK4

Selling Your Services (Server-Side)

Want other agents to pay you? Add a paywall to your API:

Express.js

CODEBLOCK5

FastAPI (Python)

CODEBLOCK6

Supported Networks

Network	CAIP-2 ID	Token	Notes
Base	eip155:8453	USDC	Primary - fast, cheap, recommended
Base Sepolia

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:

Name	URL	Notes
Primer	https://x402.primer.systems	Default
Coinbase

To use a different facilitator, set XCLAW02_FACILITATOR environment variable.

Environment Variables

Variable	Format	Description
INLINECODE20	INLINECODE21 + 64 hex chars	Wallet private key (required for payments)
INLINECODE22

Error Handling

Error Code	Meaning	What to Do
INLINECODE28	Wallet balance too low	Tell user to fund wallet with USDC on Base
INLINECODE29

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.

xClaw02

您进入x402的入口——面向代理网络的开放支付标准。

x402是一个开放协议，支持通过HTTP使用402 Payment Required状态码进行即时稳定币支付。由Primer构建的xClaw02，为代理友好的CLI工具和简单API提供了收发支付的能力。

何时使用此技能

在以下情况使用xClaw02：

- 遇到402 Payment Required HTTP响应时
需要访问付费API或资源时
用户要求您使用加密货币/USDC支付某物时
需要检查钱包余额或管理支付时
想要为自己的API或服务收费时

如何响应

用户说/问	操作
我收到了402错误	这是x402支付请求。使用xclaw02 probe <url>探测URL，显示价格，询问是否要支付
为这个API付费

使用xclaw02 pay --max-amount - 务必先与用户确认金额 | | 检查我的余额 | 运行xclaw02 wallet balance

快速设置

Node.js

bash npx xclaw02 openclaw init

Python

bash pip install xclaw02 xclaw02 openclaw init

这将：

1. 创建一个新钱包（或使用现有钱包）
将配置保存到~/.openclaw/skills/xclaw02/
显示您的钱包地址，用于在Base上存入USDC

x402工作原理

1. 请求 - 您调用付费API
402响应 - 服务器在头部返回支付要求
支付并重试 - 签名支付，使用PAYMENT-SIGNATURE头部重试请求
访问 - 服务器验证支付，链上结算，返回资源

支付对付款方无gas费用 - 促进者处理gas费用。

CLI命令

命令	描述
xclaw02 openclaw init	为此代理设置xClaw02
xclaw02 openclaw status

CLI输出示例

bash
$ 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

javascript const { createSigner, x402Fetch } = require(xclaw02);

// 私钥格式：0x后跟64个十六进制字符
const signer = await createSigner(eip155:8453, process.env.XCLAW02PRIVATEKEY);
const response = await x402Fetch(https://api.example.com/paid, signer, {
maxAmount: 0.10 // 最大USDC消费额
});
const data = await response.json();

Python

python from xclaw02 import createsigner, x402requests import os

私钥格式：0x后跟64个十六进制字符

signer = createsigner(eip155:8453, os.environ[XCLAW02PRIVATE_KEY]) with x402requests(signer, maxamount=0.10) as session: response = session.get(https://api.example.com/paid) data = response.json()

销售您的服务（服务端）

想让其他代理向您支付？为您的API添加付费墙：

Express.js

javascript const express = require(express); const { x402Express } = require(xclaw02);

const app = express();

app.use(x402Express(0xYourAddress, {
/api/premium: {
amount: 0.05, // 每次请求$0.05 USDC
asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,
network: eip155:8453
}
}));

app.get(/api/premium, (req, res) => {
res.json({ data: Premium content here });
});

FastAPI (Python)

python from fastapi import FastAPI from xclaw02 import x402_fastapi

app = FastAPI()

app.addmiddleware(x402fastapi(
0xYourAddress,
{
/api/premium: {
amount: 0.05,
asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,
network: eip155:8453
}
}
))

@app.get(/api/premium)
async def premium_endpoint():
return {data: Premium content here}

支持的网络

网络	CAIP-2 ID	代币	备注
Base	eip155:8453	USDC	主要 - 快速、便宜、推荐
Base Sepolia

Base是默认网络。要使用其他网络，请设置XCLAW02_NETWORK环境变量。

促进者

促进者处理支付验证和链上结算。x402生态系统拥有许多独立的促进者：

名称	URL	备注
Primer	https://x402.primer.systems	默认
Coinbase

要使用不同的促进者，请设置XCLAW02_FACILITATOR环境变量。

环境变量

变量	格式	描述
XCLAW02PRIVATEKEY

0x + 64个

xclaw02x402支付

xclaw02

xClaw02

When to Use This Skill

How to Respond

Quick Setup

Node.js

Python

How x402 Works

CLI Commands

Example CLI Output

Using in Code

Node.js / TypeScript

Python

Selling Your Services (Server-Side)

Express.js

FastAPI (Python)

Supported Networks

Facilitators

Environment Variables

Error Handling

Security Notes

Alternative Implementations

Links

xClaw02

何时使用此技能

如何响应

快速设置

Node.js

Python

x402工作原理

CLI命令

CLI输出示例

在代码中使用

Node.js / TypeScript

Python

私钥格式：0x后跟64个十六进制字符

销售您的服务（服务端）

Express.js

FastAPI (Python)

支持的网络

促进者

环境变量

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

相关推荐

self-improvement

self-improvement

self-improvement

self-improvement