AgentXPay

Polar Sponsor
爱发电 赞助
.NET 9.0

AgentXPay Skill — 让 AI Agent 在 Monad 链上通过 x402 协议自主发现、付费、订阅 AI 服务。支持链上支付、Agent 钱包管理、服务订阅和资金托管。

AgentXPay Skill

功能概述

AgentXPay Skill是一项面向实际任务的技能,主要用于让 AI Agent 具备在 Monad 区块链上 自主发现 AI 服务、链上付费、管理钱包 的能力;核心机制:通过 x402 协议 (HTTP 402 Payment Required),Agent 发送请求 → 收到 402 → 自动链上支付 → 携带交易哈希重试 → 获取 AI 服务响应,全程无需人工介入;

核心要点

  • 在使用本 Skill 前,需。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;

结果检查与注意事项

涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

AgentXPay Skill

让 AI Agent 具备在 Monad 区块链上自主发现 AI 服务、链上付费、管理钱包的能力。

核心机制:通过 x402 协议(HTTP 402 Payment Required),Agent 发送请求 → 收到 402 → 自动链上支付 → 携带交易哈希重试 → 获取 AI 服务响应,全程无需人工介入。

前置条件

在使用本 Skill 前,需要确保以下配置可用:

变量 必填 说明
RPC_URL 是 Monad RPC 节点地址
PRIVATE_KEY 是 Agent 钱包私钥
SERVICE_REGISTRY_ADDRESS 是 ServiceRegistry 合约地址
PAYMENT_MANAGER_ADDRESS 是 PaymentManager 合约地址
SUBSCRIPTION_MANAGER_ADDRESS 否 SubscriptionManager 合约地址
ESCROW_ADDRESS 否 Escrow 合约地址
AGENT_WALLET_FACTORY_ADDRESS 否 AgentWalletFactory 合约地址
  1. 依赖:@agentxpay/sdk、ethers v6

可用 Tool 清单

本 Skill 提供以下 7 个 Tool,AI 可根据任务需要选择调用:

Tool 1: agentxpay_discover_services

用途:在 Monad 链上发现已注册的 AI 服务。

参数:

参数 类型 必填 说明
category string 否 服务类别过滤,如 "LLM"、"Image"、"Code"
maxPrice string 否 最大单价(MON),如 "0.05"

返回:{ services: [...], totalCount: number }

使用场景:用户问"有哪些 AI 服务可用"、"找一个图像生成服务"时调用。

执行方式:运行 scripts/run-tool.ts discover_services '{"category":"LLM"}'

Tool 2: agentxpay_pay_and_call (核心 Tool)

用途:通过 x402 协议自动付费调用 AI 服务端点。

参数:

参数 类型 必填 说明
url string 是 AI 服务端点 URL
method string 否 HTTP 方法,默认 "POST"
body object 否 请求体(会被 JSON 序列化)
headers object 否 额外 HTTP 请求头

返回:{ status, data, payment: { txHash, amount, serviceId }, latencyMs }

工作流程:

  1. 向目标 URL 发送 HTTP 请求
  2. 若收到 HTTP 402 响应,解析 X-Payment-* 响应头
  3. 自动调用 PaymentManager 合约完成链上支付
  4. 携带 X-Payment-TxHash 重新发送请求
  5. 返回 AI 服务响应 + 支付凭证

使用场景:用户说"帮我调用这个 AI 接口"、"用 GPT-4 回答问题"时调用。

执行方式:运行 scripts/run-tool.ts pay_and_call '{"url":"http://...","method":"POST","body":{"prompt":"hello"}}'

Tool 3: agentxpay_smart_call (推荐:一步到位)

用途:智能发现 → 选择最优服务 → 自动付费调用,一步完成。

参数:

参数 类型 必填 说明
task string 是 任务描述,如 "生成一张赛博朋克猫图片"
category string 否 偏好的服务类别
maxBudget string 否 最大预算(MON)
preferCheapest boolean 否 是否优先选最便宜的

返回:{ selectedService: {...}, response, payment, latencyMs }

使用场景:用户描述一个需要外部 AI 服务的任务,但没有指定具体服务端点时。这是最常用的 Tool。

执行方式:运行 scripts/run-tool.ts smart_call '{"task":"生成赛博朋克猫图片","category":"Image"}'

Tool 4: agentxpay_manage_wallet

用途:创建和管理 Agent 智能合约钱包,包括授权/撤销 Agent 地址和通过钱包余额支付服务。

参数:

参数 类型 必填 说明
action string 是 "create" / "fund" / "get_info" / "set_limit" / "authorize_agent" / "revoke_agent" / "pay"
dailyLimit string 条件 每日限额(MON),create/set_limit 时需要
amount string 条件 金额(MON),fund/pay 时需要
walletAddress string 条件 钱包地址,fund/get_info/set_limit/authorize_agent/revoke_agent/pay 时需要
agentAddress string 条件 Agent 地址,authorize_agent/revoke_agent 时需要
serviceId number 条件 链上服务 ID,pay 时需要

返回:{ walletAddress, balance, dailyLimit, dailySpent, remainingAllowance, txHash, agentAddress?, isAuthorized?, paymentServiceId?, paymentAmount? }

Action 说明:

  • create:创建新的 Agent 智能钱包,设置每日支出限额
  • fund:向钱包充值 MON
  • get_info:查询钱包余额、每日限额、今日已花、剩余额度
  • set_limit:调整每日支出限额
  • authorize_agent:授权一个地址(Agent)从该钱包支出
  • revoke_agent:撤销一个地址的钱包支出权限
  • pay:通过钱包余额调用 PaymentManager.payPerUse 支付服务(需先授权)

使用场景:用户说"创建一个 Agent 钱包"、"授权某个地址使用钱包"、"用钱包余额支付服务"时调用。

Tool 5: agentxpay_subscribe

用途:订阅链上 AI 服务的周期性计划。

参数:

参数 类型 必填 说明
serviceId number 是 链上服务 ID
planId number 否 订阅计划 ID(不传则自动选第一个)

返回:{ subscriptionId, planName, price, txHash, hasAccess }

使用场景:用户说"订阅这个服务"、"我想包月使用"时调用。

Tool 6: agentxpay_create_escrow

用途:为定制 AI 任务创建链上资金托管。

参数:

参数 类型 必填 说明
serviceId number 是 链上服务 ID
amount string 是 托管金额(MON)
deadlineDays number 是 截止天数
description string 是 任务描述

返回:{ escrowId, amount, deadline, txHash }

使用场景:用户说"我有一个定制任务需要先锁定资金"时调用。

Tool 7: agentxpay_get_agent_info

用途:查询当前 Agent 的钱包地址、余额和网络信息。

参数:无

返回:{ address, balance, network }

使用场景:用户问"我的钱包地址是什么"、"余额还有多少"时调用。

标准操作流程 (SOP)

场景 A:用户需要调用外部 AI 服务

步骤 1: 调用 agentxpay_discover_services 查看可用服务和价格
步骤 2: 向用户展示服务列表和价格,确认是否继续
步骤 3: 用户确认后,调用 agentxpay_pay_and_call 或 agentxpay_smart_call
步骤 4: 返回 AI 服务响应 + 支付交易哈希

场景 B:用户直接描述任务(推荐)

步骤 1: 调用 agentxpay_smart_call,传入任务描述和可选的类别/预算
步骤 2: Skill 自动发现服务 → 选择最优 → 付费调用
步骤 3: 返回结果给用户,附带所选服务信息和支付凭证

场景 C:用户要管理 Agent 钱包

步骤 1: 调用 agentxpay_manage_wallet action="get_info" 查看当前状态
步骤 2: 根据需要执行 create/fund/set_limit

场景 D:用户要用 Agent 钱包支付服务

步骤 1: 创建钱包 — manage_wallet action="create" dailyLimit="1.0"
步骤 2: 充值 — manage_wallet action="fund" walletAddress="0x..." amount="10.0"
步骤 3: 授权 Agent — manage_wallet action="authorize_agent" walletAddress="0x..." agentAddress="0x..."
步骤 4: 通过钱包支付 — manage_wallet action="pay" walletAddress="0x..." serviceId=1 amount="0.01"

场景 E:用户要订阅服务

步骤 1: 调用 agentxpay_discover_services 找到目标服务
步骤 2: 调用 agentxpay_subscribe 订阅
步骤 3: 确认访问权限已激活

错误处理

错误 原因 处理方式
"No matching services found" 链上无匹配服务 建议用户放宽过滤条件或检查合约部署
"insufficient funds" Agent 余额不足 提示用户充值或使用 agentxpay_manage_wallet fund
"ServiceId mismatch" 链上 serviceId 与 Provider 402 响应中的 serviceId 不一致 提示用户联系服务提供者修正 serviceId 配置
"Price mismatch" 链上 pricePerCall 与 Provider 402 响应中的 amount 不一致 提示用户联系服务提供者修正定价配置
HTTP 402 retry 失败 支付验证未通过 检查合约地址和网络配置
"daily limit exceeded" 超出每日限额 提示用户调整限额或等待次日重置
"Agent ... is not authorized" Agent 未被授权使用钱包 用 authorize_agent 授权该 Agent
"Insufficient daily allowance" 钱包每日额度不足 用 set_limit 调高限额或等待次日重置
"Insufficient wallet balance" 钱包余额不足 用 fund 向钱包充值

安全注意事项

  1. 私钥保护:PRIVATE_KEY 通过 openclaw.json 安全注入,不要硬编码
  2. 每日限额:建议使用 Agent Wallet 的 dailySpendingLimit 限制支出
  3. 用户确认:在执行付费操作前,应向用户展示价格并获得确认
  4. 交易验证:所有支付都有链上 txHash,可在区块浏览器验证

引用资源

  • CLI 工具执行脚本:参考 scripts/run-tool.ts(可直接 npx tsx 执行)
  • TypeScript 类型定义:参考 src/types.ts
  • Tool JSON Schema 定义:参考 src/schemas.ts
  • 核心运行时实现:参考 src/runtime.ts
  • 集成入口和适配器(OpenAI/MCP):参考 src/index.ts
  • x402 协议参考:参考 references/x402-protocol.md
  • AgentXPay SDK API 文档:参考 references/sdk-api.md

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
文心快码功能介绍
文心快码功能介绍

共0课时 | 0人学习

文心快码Agent使用手册
文心快码Agent使用手册

共0课时 | 0人学习

文心快码产品文档
文心快码产品文档

共0课时 | 0人学习