我的 Agent 去购买服务#
买家无需复杂安装，只要为你的 AI Agent 安装 Onchain OS Skill，它就能与卖家发起对话、自动签名付款，全程无需人工介入。
Skill 会自动处理：
- 支付请求识别：自动识别 HTTP 402 响应或消息通道中的付款 URL
- 金额校验：检查金额是否合理、收款方是否可信
- 签名授权：调用 Agentic Wallet 完成签名（单次支付一笔一签；批量支付用预授权的 Session Key）
- 状态跟踪：监控支付状态、获取 Receipt
准备工作#
- AI Agent：Claude Desktop 等支持 Skill 的 AI 工具
- Agentic Wallet：通过 Onchain OS Skill 创建（邮箱登录，无需助记词），私钥在 TEE 内生成与保管。安装步骤见 Agentic Wallet 安装
- 链上余额：X Layer 上有足够 USDG / USD₮0
配置#
将以下提示词发送给 AI，即可安装 Onchain OS Skills，为你的 Agent 配置 Agentic Wallet：
text
运行 npx skills add okx/onchainos-skills 安装 Onchain OS skills
注意：请安装到当前 Agent 对应的 skill 目录
同时，帮我根据这个文档安装最新版本的CLI https://github.com/okx/onchainos-skills验证#
下文以 "查询天气" 为示例，请以实际需要请求的线上 x402 付费服务进行测试。
登录：
onchainos wallet login请求卖家端的服务/资源：
//非线上服务，仅做案例参考
访问该服务 http://localhost:4021/weather获取到支付信息，说明请求成功：
服务返回了一个 x402 支付要求 响应（HTTP 402）。内容如下：
- x402 版本: 2
- 资源: /weather — 获取任意地点的当前天气数据，返回 application/json
- 支付方式 (两种 scheme):
- exact — 单次支付
- aggr_deferred — 事后支付
- 网络: eip155:196 (OKX X Layer)
- 代币: USD₮0 (0x779ded0c9e1022225f8e0630b35a9b54be713736)
- 金额: 1000 (最小单位)
- 收款地址: 0xb483abdb92f8061e9a3a082a4aaaa6b88c381308
- 超时: 600,000 秒确认支付，签名交易数据并重放请求到卖家端：
bash
PAYMENT_PAYLOAD=$(python3 -c "
import json, base64
payload = {
'x402Version': 2,
'resource': {'url': '/weather', 'description': 'Get current weather data for any location', 'mimeType':
'application/json'},
'accepted': {'scheme': 'exact', 'network': 'eip155:196', 'asset':
'0x779ded0...4be713736', 'amount': '1000', 'payTo':
'0xb483abd....aa6b88c381308', 'maxTimeoutSeconds': 600000, 'extra': {'name': 'USD₮0',
'version': '1'}},
'payload': {
'signature': '0x3d1907a6ba9f592c...35868ea11b',
'authorization': {'from': '0xbda9fde...99763', 'nonce':
'0x20862cc...06e48', 'to':
'0xb483abd...81308', 'validAfter': '0', 'validBefore': '1775837508', 'value': '1000'}
}
}
print(base64.b64encode(json.dumps(payload, separators=(',', ':')).encode()).decode())
")
curl -s -D - http://localhost:4021/weather -H "PAYMENT-SIGNATURE: $PAYMENT_PAYLOAD"
获取到卖家端返回的资源：
⏺ 支付成功！天气数据返回：
{"report": {"temperature": 70, "weather": "sunny"}}
- 温度: 70°F
- 天气: 晴天 ☀️常见问题#
Agent 自动签名安全吗？
安全。Agent 只能在你预先授权的 Session Key 范围内自动签名（金额、有效期、用途都受限）。即使 Agent 被恶意控制，损失也限定在授权范围内。单次支付场景每笔仍需主钱包确认。
支持哪些钱包？
单次支付支持任何兼容 EIP-3009 的 EVM 钱包。批量支付（Session Key 授权）必须使用 Agentic Wallet。
付款失败怎么办？
付款失败时（如 KYT 检查不通过、余额不足、Session Key 过期）卖家不会交付服务，买家也不会被扣款。具体错误码会返回到 Agent，可在日志中看到原因。
不用 Agentic Wallet 也能用吗？
可以，但功能会受限。任何 EIP-3009 钱包都能完成单次支付；要使用批量支付的 Session Key 授权，必须用 Agentic Wallet。