SuperAPI AI 工具集

agent-payment-x402

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:让 AI 智能体具备自主支付能力,用于支付 API 调用、购买服务、与其他智能体结算,并强制按任务/会话的消费限额,同时管理非托管钱包。

主要能力:基于 x402 HTTP 支付协议,将 HTTP 402 扩展为机器可协商流程——服务器返回 402 时,支付工具自动协商价格、检查预算、签名交易并重试,无需人工介入。每次支付调用都执行 SpendingPolicy:按任务预算、按会话累计预算、收款方白名单、每分钟/小时交易速率限制。钱包采用 ERC-4337 智能账户,智能体自持密钥,无资金池、无托管风险。通过标准 MCP 工具接入 Claude Code 或智能体框架。

可用工具:get_balance(查余额)、send_payment(向地址或 ENS 付款)、check_spending(查剩余预算)、list_transactions(支付审计记录)。

使用方式:先安装依赖 npm install -g agentwallet-sdk@6.0.0,再在 MCP 配置中固定版本,例如 command 为 npx、args 为 ["agentwallet-sdk@6.0.0"]。消费策略由编排层在委派前通过 set_policy 设置,不作为智能体可调用工具,以防智能体自行提高限额。建议在付费动作前用 preToolCheck 做失败即阻断的预算校验,并在任务后钩子用 list_transactions 记录支出。

适用场景:需要为外部 API 付费、购买服务、智能体间结算、执行按任务消费上限或管理非托管钱包的智能体流程,可与成本感知的 LLM 流水线、安全审查技能配合。

限制与注意:该工具管理私钥,务必固定包版本,未固定版本的 npx 安装会引入供应链风险;非交互环境下 npx 不加 -y 会因确认提示而挂起。支付工具权限高,应按 shell 访问同等标准审查。开发建议先用 Base Sepolia 测试网,生产再切 Base 主网。资料未提供具体收费与价格信息。