ClawRouter:零密钥、极速LLM路由—代理付款
ClawRouter:零密钥、极速LLM路由器
对于构建自治代理的 AI 开发者,LLM API 的成本、延迟和管理始终是痛点。ClawRouter 同时解决这些问题:它将每一次模型请求路由到最便宜的可行提供商,使用你自己的加密钱包签名支付,并保持全过程本地化,延迟<1 ms。
ClawRouter的重要性
- 🚀 零API密钥 – 认证通过你自己的 USDC 交易签名完成,无需共享密钥。
- 💸 巨大节省 – 基于15维加权评分选择最便宜模型;通常节省率为70‑90%,相比单一提供商方案。
- ⚡ 快速路由 – 所有决策在客户端完成;首秒响应时间即为“决策时间”,而非外部API往返。
- 🔒 非托管支付 – 钱包由你控制;后台不保管资金。
- 🌐 30+ 模型 & 7 个提供商 – 包含 OpenAI、Anthropic、Google、DeepSeek、XAI、Moonshot、MiniMax,均可通过一次调用访问。
快速安装与设置
ClawRouter 随包附带一键式安装程序,支持 Linux、macOS 和 Windows(WSL)。本节演示在120秒内将其启动运行所需的最小步骤。
# 1. 安装智能路由包装器
curl -fsSL https://blockrun.ai/ClawRouter-update | bash
# 2. 重新启动 OpenClaw 网关,使路由器加载
openclaw gateway restart
# 3. 用几美元 USDC 为 L2 Base 钱包注资(仅 $1 即可)
# 安装时会打印钱包地址
# $ openclaw wallet address
#
# 例如:0x1234…ABCD(Base L2)
钱包注资后,ClawRouter 会自动成为默认路由器(/model auto 配置)。基本使用不再需要其他环境变量。
路由配置说明
ClawRouter 提供四个预设路由配置。可通过简短命令 /model <profile> 在它们之间切换。
| 配置 | 策略 | 节省率 | 使用场景 |
|---|---|---|---|
| /model auto | 平衡 | 74‑100% | 一般用途,高效 |
| /model eco | 仅最便宜 | 95‑100% | 最大化节省,低成本工作负载 |
| /model premium | 仅最高质量 | 0% | 关键任务应用 |
| /model free | 仅免费层 | 100% | 零成本实验 |
代码一瞥
ClawRouter 的核心使用 TypeScript 编写。路由器采用 15 维加权评分器评估成本、延迟、上下文长度和推理质量。评分决定层级系统,从而选择满足请求约束的最便宜模型。
import { ClawRouter } from 'clawrouter'
const router = new ClawRouter({ profile: 'auto' })
const result = await router.call('gpt-4o', { prompt: 'Who won the 2024 World Series?' })
console.log(result.output)
支付流程
ClawRouter 独特之处在于其微支付系统。当路由器因钱包余额不足无法满足请求时,网关返回 402 Payment Required 响应并给出确切价格。代理随后使用其私钥签名支付并匿名重发请求。无 API 密钥,无共享密钥,无托管方,钱包始终由你控制。
典型用法:
- 代理向
/model auto发送请求。 - 网关检查钱包余额。
- 若余额不足,返回
402并给出价格。 - 代理使用私钥签名对应的 USD‑C 等值(x402)支付。
- 网关扣除费用并返回 LLM 输出。
高级配置
虽默认设置已满足大多数用户需求,但 ClawRouter 的 docs/configuration.md 公开了许多可调参数:
BLOCKRUN_PROXY_PORT– 更改本地监听端口。CLAWROUTER_DISABLED– 开启调试时关闭智能路由。- 针对不同提供商的覆盖规则和自定义权重矩阵。
ClawRouter为何优于竞争对手
与 OpenRouter 和 LiteLLM 对比,ClawRouter 的主要差异点如下所示:
- 成本:~
$2.05/M平均混合价 vs$25/M最高质量 OpenRouter 模型。 - 延迟:所有决策本地化 (<1 ms) vs 外部 API 往返。
- 安全性:钱包签名 vs 共享 API 密钥。
- 可扩展性:无按键速率限制;由你掌控钱包。
参与贡献
ClawRouter 是一个 MIT 许可的项目,由 BlockRun 社区维护。你可以通过以下方式贡献:
- 提交拉取请求——
.github/workflows文件夹中包含在 TypeScript、ESLint 和 Prettier 上运行的持续集成测试。 - 添加新的路由配置或模型。
- 改进钱包支付逻辑或添加对其他 L2 链的支持。
在 GitHub 上找到源码:BlockRunAI/ClawRouter。
今天就试一试
开始开发:
git clone https://github.com/BlockRunAI/ClawRouter.git
cd ClawRouter
npm install
npm run build
npm test
构建完成后,只需运行 openclaw gateway start 开始发送 LLM 请求。使用 ClawRouter 节省费用、降低摩擦,并让你的资金始终掌握在你手中。