讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

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
目录

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

0

2026.11.12

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

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

0

2026.11.12

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

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

0

2026.11.12

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

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

0

2026.11.06

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

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

0

2026.11.06

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

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

0

2026.11.06

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

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

0

2026.11.05

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

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

0

2026.11.05

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

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

0

2026.11.04

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn