openkrill

💳 AI代理自动化微支付解决方案

基于thirdweb和x402协议,让AI代理能自动完成Browserbase等服务的加密货币微支付,实现真正的“即用即付”自动化体验。

收藏
7k
安装
2.6k
版本
00.000
CLS 安全性认证2026-05-04
点击查看完整报告 >

使用说明

OpenKrill是一个专为AI代理设计的x402协议支付技能,通过集成thirdweb支付基础设施,使自动化代理能够自主完成基于加密货币的微支付。该技能的核心价值在于将传统的"先订阅后使用"模式转变为"即用即付"的流式支付体验,特别适用于Browserbase浏览器自动化、Firecrawl网络抓取等按量计费的服务场景。

核心用法

该技能通过调用thirdweb的x402 fetch API,代理可在遇到HTTP 402 Payment Required响应时自动完成支付流程。工作流程包括:首先检查或创建钱包地址,然后通过fetchWithPayment端点向目标服务(如x402.browserbase.com)发起带支付能力的请求。若余额充足,thirdweb会自动处理USDC转账并返回API结果;若余额不足,系统会生成支付链接供用户充值。此外,技能还集成了x402 Bazaar发现机制,可查询超过12,000个兼容的支付端点,并支持Mail.tm一次性邮箱服务用于服务注册验证。

显著优点

OpenKrill的最大优势是支持"True x402"无密钥支付模式,用户无需管理复杂的API密钥,仅需持有USDC即可使用Browserbase等服务,实现了真正的去中心化访问控制。其次,自动化程度高,代理可自主处理支付流程,无需人工干预每次交易。第三,基于USDC稳定币支付,避免了加密货币价格波动风险。最后,完善的发现机制(Bazaar)让代理能够动态发现新的可支付服务,扩展性强。

潜在缺点与局限性

首先,该技能高度依赖thirdweb的中心化API服务,若thirdweb服务不可用,整个支付流程将中断,这与区块链去中心化理念存在一定矛盾。其次,并非所有服务都支持标准的x402实现,例如Firecrawl使用的是非标准混合模式(需API Key+支付),且当前实现存在返回401而非402的问题,无法直接用于自动化代理。第三,目前主要支持Base链上的USDC,对其他区块链的支持有限。最后,作为个人开发者(T3)维护的项目,长期维护稳定性和企业级支持存在不确定性。

适合的目标群体

该技能最适合构建自动化工作流的AI代理开发者,特别是需要按需购买浏览器会话(Browserbase)或网络抓取额度的场景。对于希望构建"自治代理"(Autonomous Agents)的开发者,OpenKrill提供了关键的支付基础设施,使代理能够独立在数字经济中运作。此外,需要频繁创建临时邮箱进行服务注册验证的用户也会受益于内置的Mail.tm集成。

使用风险

使用OpenKrill需注意以下风险:一是资金安全风险,虽然单笔支付金额较小(微支付),但需确保THIRDWEB_SECRET_KEY和钱包私钥的安全存储,避免未授权访问导致资金损失。二是第三方依赖风险,thirdweb API的可用性和响应延迟直接影响代理性能。三是本地凭证安全,create-email.ts会将邮件账户信息存储在.agent-emails.json文件中,需确保该文件权限设置正确并加入.gitignore。四是网络要求,该技能需要稳定的互联网连接访问thirdweb和x402端点,无法在完全离线环境下使用。建议定期检查钱包余额并设置支付上限(X402_MAX_PAYMENT环境变量)以控制风险。

安全解读

核心用法

OpenKrill 是一个专门用于 x402 支付协议的 AI Agent 技能,使智能体能够自主完成微支付流程。主要工作流程包括:

1. 钱包管理:通过 thirdweb API 创建/获取服务端钱包,支持自动化的 USDC 余额管理和充值
2. 支付执行:当遇到 HTTP 402 Payment Required 响应时,自动处理支付头生成和链上转账

3. 服务发现:集成 x402 Bazaar 目录,可查询 12,000+ 兼容服务的实时信息

4. 多服务支持:已验证支持 Browserbase(浏览器自动化,$0.12/小时)、Mail.tm(临时邮箱,免费)等

典型调用场景

  • 用户要求"购买浏览器会话"→ 查询 Bazaar → 创建钱包 → 检查余额 → 发起支付 → 返回 session 数据
  • 遇到 402 响应 → 自动解析 payment 信息 → 生成链上交易 → 重试原请求

显著优点

  • 真正无密钥:Browserbase 等"True x402"服务无需 API key,仅需支付即可使用,降低凭证泄露风险
  • 自动化闭环:从发现服务到完成支付的全流程无需人工介入,适合构建自主Agent
  • 开源透明:MIT 许可证,代码无恶意行为,依赖均为知名基础设施(thirdweb、Coinbase CDP)
  • 零供应链风险:无 npm 依赖,纯原生 Node.js/fetch 实现
  • 详细文档:包含服务对比表、错误处理指南、多种发现方法

潜在缺点与局限性

  • 服务覆盖有限:实际可用的 x402 服务较少,Firecrawl 等非标准实现无法使用
  • 资金门槛:需要预存 USDC 到 Base 链钱包,对非加密用户有学习成本
  • 外部依赖风险:核心功能完全依赖 thirdweb API,若服务故障则 Skill 失效
  • 非托管警告:用户需自行管理 THIRDWEB_SECRET_KEY,文档未充分说明权限范围
  • 凭证明文存储:Mail.tm 邮箱凭证以明文写入 .agent-emails.json

适合人群

  • 构建需要付费 API 访问能力的自主 AI Agent 的开发者
  • 已有加密货币支付基础设施、熟悉 Base/EVM 生态的技术团队
  • 需要浏览器自动化+无密钥认证场景(如自动化测试、数据抓取)的用户
  • 探索 Agent 经济(Agent-to-Agent 支付)的早期采用者

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | THIRDWEB_SECRET_KEY 权限若过大可能被滥用 | 使用最小权限的 thirdweb 项目密钥 |
| 资金损失 | 钱包私钥由 thirdweb 托管,存在平台风险 | 仅存放小额运营资金,定期转出 |
| 服务中断 | 依赖第三方 API 可用性 | 实现服务健康检查和缓存机制 |
| 误操作支付 | 自动支付可能因配置错误导致超额支出 | 设置 maxValue 上限,监控交易 |
| 合规风险 | 加密货币支付在某些地区受限 | 确认当地法规允许后使用 |

openkrill 内容

assets文件夹
references文件夹
scripts文件夹
手动下载zip · 30.1 kB
config-template.jsonapplication/json
请选择文件