---

name: agent-payment-x402 description: 为AI智能体添加x402支付执行能力，包含按任务预算、支出控制和非托管钱包。通过agentwallet-sdk支持Base链，通过OKX Payments / OKX Agent Payments Protocol支持X Layer。 origin: community

智能体支付执行（x402）

使AI智能体能够进行策略门控支付，内置支出控制。使用x402 HTTP支付协议和MCP工具，使智能体可以为外部服务、API或其他智能体付款，无托管风险。

何时使用

当你的智能体需要为API调用付费、购买服务、与另一个智能体结算、执行按任务支出限制或管理非托管钱包时使用。与 cost-aware-llm-pipeline 和 security-review 技能自然配合。

决策树

根据你的智能体是购买付费API的访问权还是向他人收费来选择集成路径：

| 需求 | 推荐路径 | |------|---------| | 智能体在Base或其他agentwallet支持的链上支付402门控API | 使用 agentwallet-sdk 作为MCP支付服务器，配合严格支出策略 | | 智能体在X Layer上支付402门控API | 使用来自 okx/onchainos-skills 的OKX Agent Payments Protocol；okx-x402-payment 是已弃用的旧别名 | | 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卖方指南可能不可用 |

支持的网络

• agentwallet-sdk：使用包文档确认当前网络覆盖范围后再投入生产。Base Sepolia是最安全的开发默认选项；Base主网是原始技能指定的生产路径。
• OKX Payments / X Layer：当前卖方文档针对X Layer（eip155:196）和USDT0结算。在生成生产代码前获取当前SDK文档，因为支付包和facilitator行为可能快速变化。

工作原理

x402 协议

x402将HTTP 402（需要支付）扩展为机器可协商的流程。当服务器返回 402 时，智能体的支付工具协商价格、检查预算、签署交易，并仅在编排器设置的策略和确认边界内重试。

支出控制

每次支付工具调用都执行 SpendingPolicy：

• 按任务预算 — 单个智能体操作的最大支出
• 按会话预算 — 整个会话的累计限额
• 白名单接收方 — 限制智能体可以支付的地址/服务
• 速率限制 — 每分钟/小时最大交易数

非托管钱包

智能体通过ERC-4337智能账户持有自己的密钥。编排器在委托前设置策略；智能体只能在限制范围内支出。无资金池，无托管风险。

MCP 集成

支付层暴露标准MCP工具，可嵌入任何Claude Code或智能体框架设置。

安全提示：始终固定包版本。此工具管理私钥——未固定的 npx 安装会引入供应链风险。

选项A：agentwallet-sdk（Base / 多链）

{
  "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）、会话支付、收费和A2A收费流程使用此路径。

对于买方智能体流程：

1. 安装或引用当前的 okx/onchainos-skills 仓库。
2. 使用 skills/okx-agent-payments-protocol/SKILL.md 作为调度器。
3. 将 skills/okx-x402-payment/SKILL.md 视为已弃用的兼容性别名，而非规范技能。
4. 在钱包状态检查或支付操作前需要明确的用户确认。不要将支付执行隐藏在通用工具调用后面。

对于卖方API流程，在生成代码前获取最新的语言特定指南：

| 运行时 | 当前指南 | |--------|---------| | TypeScript | OKX Payments TypeScript SELLER.md | | Go | OKX Payments Go SELLER.md | | Rust | OKX Payments Rust SELLER.md | | Java | OKX Payments Java SELLER.md |