这个 GitHub 爆火的 Agent 支付 Skill 到底能干嘛?实测来了

1614 字
8 分钟
这个 GitHub 爆火的 Agent 支付 Skill 到底能干嘛?实测来了

最近我在搬运 GitHub 高星 AI Agent Skill 的时候,发现了一个相当炸裂的 Skill——Agent Payment Execution(x402)

说实话,第一次看到它的时候我的反应是:什么?给 AI Agent 装钱包让它自己花钱?这不怕 Agent 把钱花光吗?

但看完整个 SKILL.md 之后,我只能说——这个设计真的有点东西

这个 Skill 是什么?#

这个 Skill 来自 GitHub 上 17 万星的超级项目 affaan-m/everything-claude-code,它解决的核心问题是:

让 AI Agent 能够自主为 API 调用、外部服务、或其他 Agent 进行付费,同时通过严格的预算控制确保安全。

简单说,就是给 Agent 装一个”钱包”,让它能自己花钱买东西,但你能控制它花多少、花给谁、花多快。

原始项目简介#

项目详情
仓库affaan-m/everything-claude-code
星数172,000+ ⭐
语言JavaScript
协议MIT
描述Agent 性能优化系统——包含 Skills、Instincts、Memory、Security 等全套工具

这个项目是目前 GitHub 上最大的 AI Agent 工具集之一,里面包含了几十个 Skill,涵盖了 API 设计、后端模式、安全审查、深度研究等方方面面。我们今天搬运的 agent-payment-x402 只是其中一个。

核心功能与亮点#

1. x402 支付协议——机器自动议价#

x402 协议扩展了 HTTP 402(Payment Required),把”需要付款”变成了一个机器可协商的流程:

  1. Agent 调用某个付费 API
  2. 服务器返回 402,附带价格信息
  3. Agent 的支付工具自动检查预算、签名交易、完成支付并重试
  4. 全程无需人工介入

这就好比你雇了个采购员,告诉他”预算 50 块以内自己看着办”,然后他就能自动完成整个购买流程。

2. 四级支出控制——不怕 Agent 乱花钱#

这是我最喜欢的部分。这个 Skill 不是让 Agent 随便花钱,而是提供了四层防护

控制层作用示例
按任务预算单个操作的最大花费每次 API 调用最多 $0.50
按会话预算整个会话的累计上限一次对话最多花 $5.00
白名单接收方只能付给指定的地址/服务只能付给 api.example.com
速率限制每分钟/小时最大交易次数每小时最多 10 笔交易

而且最关键的是:支出策略由调度器(Orchestrator)设置,Agent 自己改不了。这就从根本上防止了 Agent 自己给自己涨预算的情况。

3. 非托管钱包——真正的自主#

Agent 通过 ERC-4337 智能账户持有自己的私钥,不是把钱存在某个中心化平台。这意味着:

  • ✅ 没有资金池风险
  • ✅ 没有托管风险
  • ✅ Agent 真正拥有自己的资金
  • ✅ 交易记录完全透明可审计

4. 标准 MCP 集成——即插即用#

通过 MCP(Model Context Protocol)标准接口接入,配置极其简单:

{
"mcpServers": {
"agentpay": {
"command": "npx",
"args": ["agentwallet-sdk@6.0.0"]
}
}
}

四个 Agent 可调用的工具:

  • get_balance — 查余额
  • send_payment — 付款
  • check_spending — 查剩余预算
  • list_transactions — 审计所有交易记录

使用方法#

第一步:安装 SDK#

Terminal window
npm install -g agentwallet-sdk@6.0.0

第二步:配置 MCP 服务器#

在你的 Claude Code 或 Agent 框架配置中添加上面的 JSON 配置。

第三步:设置支出策略#

在委派任务给 Agent 之前,通过 set_policy 设置预算:

const policyResult = await agentpay.callTool({
name: "set_policy",
arguments: {
per_task_budget: 0.50, // 每次操作最多 50 美分
per_session_budget: 5.00, // 整个会话最多 5 美元
allowlisted_recipients: ["api.example.com"], // 只能付给这个地址
},
});

第四步:执行前检查#

在任何付费操作之前,调用 preToolCheck 进行预算验证。这个 Skill 提供了一个五层防护的检查函数

  1. 拒绝无效输入(NaN/Infinity)
  2. 处理连接失败
  3. 处理工具返回错误
  4. 验证响应格式
  5. 检查预算是否足够

任何一个环节失败,操作都会被阻断——**失败即阻断(fail closed)**的设计,非常安全。

适用场景#

✅ 适合的场景#

  • API 付费调用:Agent 需要调用按次计费的 API(如 AI 推理、数据查询)
  • 多 Agent 结算:多个 Agent 协作时,需要互相支付服务费
  • 自动化采购:Agent 自主购买云服务、域名、存储等资源
  • 成本控制:需要严格控制 Agent 每次任务的支出上限
  • 财务审计:需要完整的交易记录用于审计和报销

❌ 不适合的场景#

  • 大额支付:这个 Skill 更适合小额高频的支付场景
  • 需要人工审批的交易:如果每笔交易都需要人工确认,那就不需要这个了
  • 传统银行转账:这是基于区块链的支付方案,不涉及法币

与其他同类 Skill 对比#

在 everything-claude-code 项目中,有几个 Skill 可以和 agent-payment-x402 搭配使用:

Skill关系
cost-aware-llm-pipeline控制 LLM 调用的 token 成本,与支付 Skill 配合可以全面控制 Agent 的”花销”
security-review支付是高权限操作,需要用安全审查来审核支付流程
backend-patterns后端开发时如果涉及付费 API 集成,可以配合使用

目前我搬运的 24 个 Skill 中,还没有其他支付类的 Skill,这个是独一份。

个人评价#

推荐指数:⭐⭐⭐⭐☆(4/5)

优点

  • 设计思路清晰,四级防护机制非常严谨
  • 失败即阻断的安全理念值得学习
  • MCP 标准化集成,即插即用
  • 已被 NVIDIA NeMo Agent Toolkit 采纳,说明工业界认可
  • 代码示例完整,五层防护的 preToolCheck 可以直接拿来用

不足

  • 依赖区块链钱包,对不熟悉 Web3 的开发者有学习门槛
  • 目前只支持 Base 链(以太坊 L2),生态还在早期
  • 文档中 TypeScript 示例较多,缺少其他语言的参考

总结:这是我在搬运过程中见过的最有”未来感”的 Skill 之一。它解决的不仅仅是技术问题,更是信任问题——如何让 AI Agent 在拥有自主花钱能力的同时,不会乱花钱。五级防护 + 失败即阻断的设计,让人对 Agent 自主支付这件事有了信心。

如果你正在构建需要 Agent 自主调用付费 API 的系统,或者对 AI Agent 经济模型感兴趣,这个 Skill 值得一看。


📌 原始仓库:affaan-m/everything-claude-code
📦 中文翻译版已收录至:awesome-ai-agent-skills-zh

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

这个 GitHub 爆火的 Agent 支付 Skill 到底能干嘛?实测来了
https://boke.hackerdream.xyz/posts/agent-payment-x402-introduction/
作者
晴天
发布于
2025-04-12
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
晴天
Hello, I'm 晴天.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
125
分类
17
标签
287
总字数
257,955
运行时长
0
最后活动
0 天前

目录