通过 Agent 接入#
为你的 Agent 安装支付 Skill 后,它能识别 402 付费请求、签署交易并完成支付,无需人工介入。
配置#
将以下提示词发送给 AI,即可安装 Onchain OS Skills,为你的 Agent 配置 Agentic Wallet:
运行 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 秒
这是一个需要通过 x402 协议付费才能访问的端点。需要我帮你发起支付来获取天气数据吗?确认支付,签名交易数据并重放请求到卖家端:
签名成功,正在重放请求:
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")
⎿ HTTP/1.1 200 OK获取到卖家端返回的资源:
⏺ 支付成功!天气数据返回:
{"report": {"temperature": 70, "weather": "sunny"}}
- 温度: 70°F
- 天气: 晴天 ☀️