用途
Agent Payment Execution（x402）用于让 AI 智能体在受策略约束的情况下完成支付。当智能体需要为一次 API 调用付费、购买某项服务、与另一个智能体结算、执行每任务支出上限，或管理非托管钱包时，可以使用该技能。它基于 x402 HTTP 支付协议与 MCP 工具，使智能体能够为外部服务、API 或其他智能体付款，而不承担托管风险。资料指出它与 cost-aware-llm-pipeline 和 security-review 技能搭配自然。
主要能力
x402 协议
x402 将 HTTP 402（Payment Required）扩展为机器可协商的流程。当服务器返回 402 时，智能体的支付工具会协商价格、检查预算、签署交易，并且只在编排器设定的策略与确认边界内重试。
支出控制
每次支付工具调用都会强制执行 SpendingPolicy，包括：
- 每任务预算：单个智能体操作的最大支出
- 每会话预算：整个会话的累计限额
- 收款方白名单：限制智能体可支付的地址或服务
- 速率限制：每分钟或每小时的最高交易数量
非托管钱包
智能体通过 ERC-4337 智能账户自行持有密钥。编排器在委派前设定策略，智能体只能在范围内支出。资料强调没有资金池、没有托管风险。
MCP 集成
支付层暴露标准 MCP 工具，可接入任何 Claude Code 或智能体 harness 设置。
安全提示：务必锁定包版本。该工具管理私钥，未锁定版本的 npx 安装会引入供应链风险。
集成路径选择
资料提供决策树，依据智能体是购买付费 API 访问权限，还是向他人收费来选择路径：
- 智能体在 Base 或其他 agentwallet 支持的链上支付 402 网关 API：使用 agentwallet-sdk 作为带严格支出策略的 MCP 支付服务器。
- 智能体在 X Layer 上支付 402 网关 API：使用 okx/onchainos-skills 中的 OKX Agent Payments Protocol；okx-x402-payment 是已弃用的旧别名。
- 智能体在 Solana 或其他 x402 v2 网络上支付 402 网关 API：用上游 @x402/fetch 或 @x402/axios 包包装智能体的 HTTP 客户端，并注册 EVM/SVM 方案；资源服务器的 facilitator 负责验证与结算。
- API 向 Solana 或多网络上的智能体收费（TypeScript、Python 或 Go）：使用 x402-foundation/x402 的上游 x402 中间件——TypeScript 对应 @x402/express、@x402/hono、@x402/next、@x402/fastify，Python 对应 x402，Go 对应 github.com/x402-foundation/x402/go/v2。
- TypeScript API 向智能体收费：使用 OKX Payments TypeScript 卖方 SDK 文档，适用于 Express、Hono、Fastify 或 Next.js。
- Go API 向智能体收费：使用 OKX Payments Go 卖方 SDK 文档，适用于 Gin、Echo 或 net/http。
- Rust API 向智能体收费：使用 OKX Payments Rust 卖方 SDK 文档，适用于 Axum。
- Java API 向智能体收费：使用 OKX Payments Java 卖方 SDK 文档，适用于 Spring Boot 2/3、Java EE 或 Jakarta。
- Python API 向智能体收费：实现前需查看当前 OKX Payments 仓库；Python 卖方指南可能尚不可用。
使用方式
选项 A：agentwallet-sdk（Base / 多链）
在 MCP 配置中注册：
{
"mcpServers": {
"agentpay": {
"command": "npx",
"args": ["agentwallet-sdk@6.0.0"]
}
}
}
可供智能体调用的工具包括：get_balance（检查智能体钱包余额）、send_payment（向地址或 ENS 发送付款）、check_spending（查询剩余预算）、list_transactions（所有付款的审计记录）。
注意：支出策略由编排器在委派给智能体之前设定，而不是由智能体自己设定。这可以防止智能体自行提高支出限额。请通过编排层或任务前钩子中的 set_policy 配置策略，切勿将其作为智能体可调用的工具。
选项 B：OKX Agent Payments Protocol（X Layer）
适用于 X Layer 上的 x402、多方可支付（MPP）、会话支付、charge 和 A2A charge 流程。买方侧智能体流程：安装或引用当前 okx/onchainos-skills 仓库；使用 skills/okx-agent-payments-protocol/SKILL.md 作为调度器；将 skills/okx-x402-payment/SKILL.md 视为已弃用的兼容别名，而非规范技能；在钱包状态检查或支付操作前必须获得用户明确确认，不得将支付执行隐藏在通用工具调用之后。卖方侧 API 流程需在生成代码前获取最新的特定语言指南，资料给出了 TypeScript、Go、Rust、Java 的 SELLER.md 链接，并提醒不要未经核对当前 OKX 仓库就复制旧文档示例。
选项 C：上游 x402 包（Solana + Base/EVM）
当智能体在 Solana、Base 或其他上游协议实现支持的网络付款，或你的 API 收费时使用此路径。这不是独立的 MCP 服务器，而是包装智能体自身的 HTTP 客户端，由资源服务器选定的 facilitator 验证与结算。
买方侧智能体流程要点：从 examples/typescript/clients 中维护的示例开始，而不是复制旧文档片段；在签署或提交首个付费请求前必须获得用户明确确认；锁定包版本（例如 @x402/fetch@2.22.0），所有上游包版本同步；在客户端注册 PaymentPolicy 以执行预算，每次调用都针对服务器的实际挑战进行检查；单独配置精确的资源源 allowlist，与收款方和预算策略分开；所有启用支付的抓取都拒绝重定向；会话批准需列明批准的源、网络、资产、收款方和人类单位支出上限，并发调用共享同一决定；此客户端及其策略对编排器保持私有。
资料给出了完整代码示例，说明如何注册 EVM 与 SVM 方案、如何通过 registerPolicy 过滤网络、资产与收款方、如何用 payOnce 边界控制会话支出、如何阻止重定向、以及如何在使用 signed-SVM 方案时由 facilitator 支付交易手续费（买方钱包只需持有 USDC，无需 SOL 作为 gas）。资料还建议对策略进行对抗性测试：喂入要求 5000000 原子单位的挑战、报价不同 mint 的挑战、以及从未注册的链上的挑战，断言它们都不会产生签名。
适用场景
智能体需要为 API 调用付费、购买服务、与其他智能体结算、执行每任务支出限制或管理非托管钱包时适用。资料指出它与 cost-aware-llm-pipeline 和 security-review 技能搭配自然。
限制与注意事项
- 支持的网络上，agentwallet-sdk 的具体网络覆盖需以包文档为准，Base Sepolia 是最安全的开发默认值，Base 主网是原技能指出的生产路径；OKX Payments / X Layer 当前卖方文档面向 X Layer（eip155:196）和 USDT0 结算，生成生产代码前需获取最新 SDK 文档；上游 x402 包为多网络设计，默认使用仅限测试网的 x402.org facilitator（Base Sepolia eip155:84532、Solana devnet solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1，以及 Stellar、Aptos、Hedera、XRPL 测试网），不适用于主网路由。主网（Solana 为 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp）需自行 facilitate、运行自己的 facilitator，或从上游 facilitator 列表选择托管服务，并在生产前到 facilitator 的 /supported 端点确认实时覆盖情况。
- facilitator 的选择属于资源服务器的决定，而非买方。按信任委托程度从低到高：进程内自托管、运行自己的 facilitator、x402.org facilitator（开发与测试网）、托管生产 facilitator。托管选项需从上游文档的 facilitator 列表中选择，该列表会变化且并非详尽。
- 该工具管理私钥，必须锁定包版本；签名密钥属于编排器的环境变量，绝不硬编码、绝不允许智能体写入。
- 资料中未提供具体的收费、价格、性能或效果数据。