一、项目摘要
YYClaw 不是一个面向个人聊天的 AI Bot，而是一层给“程序”使用的 AI 接入基础设施。
它要解决的问题很明确：
今天大多数 AI 模型的调用方式，仍然是典型的 Web2 逻辑：
- 绑定信用卡
- 按月订阅
- 中心化账单
- 对链上程序不友好
但在 Binance / BSC 生态中，越来越多的程序并不需要“订阅一个 AI 网站”，它们真正需要的是：
1. 使用链上资产支付
2. 按调用次数计费，而不是月费
3. 程序可以直接接入，不必重写整套系统
4. 支付授权透明、可撤销、可验证
5. 调用成本和日志可以实时查看
因此，YYClaw 提出的核心方案是：
把 AI 能力通过 BSC 链，以 X402 风格的按量计费逻辑接入各种程序。
在实现方式上，YYClaw 将以下几个能力整合到了一条完整链路中：
- 钱包身份
- 稳定币授权
- OpenAI-Compatible API
- AI 请求转发
- 成功后链上扣费
- Dashboard 可视化日志与花费
从产品视角看，YYClaw 是一个 Web3 原生 AI Gateway。
从基础设施视角看，YYClaw 是一个连接层：向上连接各种程序，向下连接多模型能力，横向连接 BSC 与稳定币支付能力。
二、项目想解决的根本问题
如果只看“调用 AI”，这个世界已经有很多模型平台。
但如果看“如何让 Binance / BSC 生态里的各种程序自然调用 AI”，问题就没有被很好解决。
问题主要有四个：
1. AI 计费方式不适合链上程序
AI API 的默认计费模式通常建立在传统账户体系之上，这适合 SaaS，不适合：
- 链上工作流
- Agent 系统
- 交易机器人
- 自动化脚本
- Web3 应用后端
这些程序需要的是小额、高频、按次消耗的 AI 能力，而不是月费制。
2. Web3 程序与 AI API 之间缺少支付桥梁
很多程序已经能调用 OpenAI SDK，但它们无法自然地把“钱包资产”转化成“AI 请求的支付能力”。
也就是说：
- 钱包是钱包
- AI API 是 AI API
- 程序调用是程序调用
三者之间没有自然闭环。
3. 多模型能力分散，迁移成本高
如果每个程序都要单独适配不同模型供应商、不同定价方式、不同鉴权方式，那么开发者的接入成本就会非常高。
4. 调用成本不可视，边界不清晰
对于程序化调用来说，最危险的事情不是“能不能调用”，而是“调用后谁来付钱、什么时候扣、失败是否收费、如何看到成本变化”。
如果这些问题不清晰，开发者就很难放心把 AI 接到链上程序里。
三、YYClaw 的核心逻辑
YYClaw 的产品逻辑可以概括为一句话：
用链上稳定币，为程序购买按次使用的 AI 能力。
它不是让用户先买一个长期套餐，也不是把资金托管给中心化平台，而是采用更贴近 Web3 的路径：
1. 用户连接钱包
2. 用户在链上授权稳定币
3. 系统发放 API Key
4. 程序像调用 OpenAI 一样调用 YYClaw
5. Gateway 判断是否具备支付能力
6. 调用成功后再完成扣费
7. 用户可在 Dashboard 查看记录，必要时 revoke 授权
这个逻辑有三个关键点：
第一，程序调用身份与钱包支付身份被打通。
第二，AI 消费能力由稳定币承载，而不是信用卡账单承载。
第三，支付发生在调用成功之后，而不是调用之前。
这使得 YYClaw 不只是“一个 AI 接口”，而是一种新的 AI 使用方式。
四、为什么选择 BSC
这个项目选择 BSC，不是随机决定，而是基于场景匹配：
1. Binance / BSC 生态拥有大量程序化用户和开发者
无论是量化交易、链上分析、钱包工具、内容系统还是 Agent 工作流，这些程序都天然适合接入 AI。
2. BSC 的稳定币使用习惯成熟
YYClaw 当前重点支持：
- USD1
- USDT
- USDC
- U
这些资产本身就更适合作为 AI 的计费媒介，因为它们具备低波动、易理解、便于核算的特点。
3. BSC 更适合作为 AI 消费层的承载网络
对于按次调用 AI 的小额支付场景来说，链上的交互成本、资产习惯和开发者认知都很关键，而 BSC 在这些方面具有非常现实的适配性。
因此，YYClaw 不是“把 AI 放到链上”，而是“把 AI 的支付与调用方式重新设计成更适合 BSC 的形态”。
五、为什么强调 X402 风格按量计费
本项目提到的 X402，不是为了制造概念，而是为了说明一种更适合程序化 AI 请求的支付逻辑：
- 请求是一次一次发生的
- 支付也应该一次一次结算
- 余额或授权不足时，应有明确的支付失败信号
- 支付成功与调用成功应当强关联
在 YYClaw 中，这种逻辑具体表现为：
1. 程序请求到达 Gateway
2. Gateway 先检查链上支付条件
3. 如果授权或余额不足，则直接返回 402
4. 如果条件满足，则转发给上游模型
5. 上游成功后，再执行链上扣费
6. 上游失败，则不扣费
也就是说，YYClaw 并没有把“支付”独立看待，而是把它嵌入到 API 调用生命周期中。
这让“AI 请求”与“支付结果”形成了天然闭环。
六、为什么这个项目对开发者足够便捷
一个想获得大规模使用的基础设施，不能只是“理论上合理”，还必须“迁移成本足够低”。
YYClaw 的便捷性主要体现在三点：
1. 直接告诉你的AI 帮我装 YYClaw 即可接入。
2. 接入路径极短
用户完成以下动作即可开始使用：
- Connect Wallet
- Approve 稳定币
- 获取 API Key
- 替换 Base URL
- 发起调用
3. 管理成本低
开发者可以在 Dashboard 中直接看到：
- 当前授权
- 余额
- API Key
- 调用日志
- 花费变化
这意味着它不仅好接入，也好运营。
七、系统架构
为了让评委更容易理解这个项目的技术完整性，下面按层解释系统架构。
7.1 接入层
这一层负责“让人和程序进入系统”。
包括：
- 官网 Landing Page
- Dashboard
- OpenAI-Compatible API 接口
- OpenClaw Skill 接入入口
这一层的作用是统一入口，降低迁移门槛。
对人来说，可以通过网页操作。
对程序来说，可以通过标准 API 调用。
对 Agent 来说，可以通过 Skill 直接集成。
7.2 身份与支付层
这一层负责“谁在调用、谁来支付、是否有支付能力”。
包括：
- 钱包连接
- 钱包签名登录
- BSC 上稳定币授权
- allowance / balance 检查
- revoke 授权
这一层非常关键，因为它把 Web3 的钱包身份和程序调用身份连接起来。
用户不是通过用户名密码证明自己，而是通过钱包签名。
用户不是通过信用卡结算，而是通过稳定币授权赋予程序调用能力。
7.3 AI Gateway 层
这一层是 YYClaw 的核心中枢。
职责包括：
- API Key 鉴权
- 请求解析
- 模型路由
- 支付前检查
- 成功后计费
- 日志记录
也就是说，AI Gateway 层同时承担了：
- API 网关
- 计量系统
- 支付执行协调器
三种角色。
7.4 模型能力层
这一层连接外部 AI 模型供应商。
从产品意义上讲，它让 YYClaw 可以统一暴露多模型能力。
从开发者意义上讲，它把多模型复杂性隐藏在 Gateway 背后。
用户和程序不需要分别适配每个模型供应商，只需要调用统一入口。
7.5 数据与运营层
这一层负责让系统“可见、可管、可运营”。
包括：
- 调用日志
- 花费统计
- 余额与额度展示
- Dashboard 可视化
- Admin 管理后台
如果没有这一层，系统只能算“能跑通”。
有了这一层，系统才算“能落地”。
八、计费机制设计：Charge-After-Success
这是整个项目最值得强调的设计点之一。
传统系统很容易出现一个问题：
先扣费，再调用；如果调用失败，用户体验就会很差。
YYClaw 选择的方式是：
Charge-After-Success
也就是：
1. 先检查用户是否具备支付能力
2. 具备则发起 AI 请求
3. 上游成功后再扣费
4. 上游失败则不扣费
这个设计有三个重要价值：
第一，公平。
用户为成功结果付费，而不是为失败请求付费。
第二，可解释。
评委和开发者都能很容易理解“为什么扣费 / 为什么不扣费”。
第三，更适合程序化请求。
因为 Agent、脚本、机器人可能会高频调用接口，如果失败也收费，会极大削弱系统可用性。
九、为什么它不是概念 Demo
YYClaw 当前可直接验证的链接包括：
官网：
https://yyclaw.cc
API：
https://crypto.yyclaw.cc/v1
模型列表：
https://crypto.yyclaw.cc/v1/models
Admin：
https://crypto.yyclaw.cc/admin/
OpenClaw Skill：
https://github.com/GeniusTimee/yyclaw-skill
开源项目：
https://github.com/GeniusTimee/YYClaw
BSC 合约：
https://bscscan.com/address/0x30E57026c87072CFAc5B543bEA19ae1850D9bE68
Base 合约：
https://basescan.org/address/0x30E57026c87072CFAc5B543bEA19ae1850D9bE68
这些链接的意义不在于“展示很多地址”，而在于证明：
- 网页存在
- API 存在
- 模型接口存在
- Skill 存在
- 合约存在
- 管理后台存在
也就是说，项目已经具备完整的验证面。
十、结论
YYClaw 的核心意义不在于“再提供一个 AI 入口”，而在于它提出并实现了一种更适合 Web3 的 AI 使用方式：
让各种程序通过 BSC，以稳定币和 X402 风格的按量计费逻辑，按次调用 AI。
如果 Binance / BSC 生态未来会出现越来越多的：
- 交易机器人
- Agent 工作流
- 研究工具
- 开发者插件
- 自动化程序
那么这些程序一定需要一种更像 Web3 的 AI 接入层。
YYClaw 正在做的，就是这层基础设施。