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 输出。

高级配置

虽默认设置已满足大多数用户需求,但 ClawRouterdocs/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 节省费用、降低摩擦,并让你的资金始终掌握在你手中。

原创文章: 查看原文

分享本文