ClawRouter —— 面向自主代理的 LLM 路由器
专为无法注册账号、无法输入信用卡的自主代理设计的 LLM 路由：本地 <1ms 智能路由，0 个 API 密钥，通过 x402 按次支付 USDC。
- Star 数
- ★ 6.6k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在 OpenClaw 中运行的 AI 编码代理希望无需注册或API密钥即可使用多个 LLM 模型，节省成本。
- 不适合
- 不愿使用加密货币或 USDC 钱包支付的团队
- 希望自行挑选模型、不接受自动路由的人
这个 Agent 能做什么，适合哪些场景？
ClawRouter 是一个开源的（MIT 许可）智能 LLM 路由器，专为自主 AI 代理构建。它分析每个请求的 15 个维度，并在 <1ms 内完全本地路由到最便宜且能胜任的模型，路由决策无需调用外部 API。与人类开发者不同，代理无法注册账号、输入信用卡，因此 ClawRouter 使用钱包签名作为认证，并通过 x402 协议在 Base 和 Solana 链上进行 USDC 微支付。它提供 71 个模型，覆盖 OpenAI、Anthropic、Google、xAI、DeepSeek 等九家提供商，其中 6 个模型完全免费（NVIDIA 托管）。该工具通过 npm 包分发，可作为 OpenClaw 的插件或本地代理（端口 8402）运行，兼容任何 OpenAI 兼容的客户端。
ClawRouter 启动一个本地代理（默认端口 8402），拦截 OpenAI 兼容的请求。它使用加权评分器对每个请求进行 15 个维度的评估，选择合适的层级（简单、中等、复杂、推理），然后选择最优模型。用户可通过 /model auto、/model eco、/model premium 或 /model free 选择路由配置；auto 模式平均比直接调用 Claude Opus 5 节省 88% 成本，eco 模式节省 98%（基于公开的 workload mix 计算）。支付通过 x402 进行：代理返回 402 状态码，包含价格；钱包签名后重试请求。认证通过本地生成的 BIP-39 助记词派生 EVM 和 Solana 钱包。CLI 命令包括 clawrouter setup（集成 OpenClaw）、clawrouter doctor（AI 诊断）、/wallet、/exclude、/stats。同时提供图像生成（/cr-imagegen）、视频生成（/videogen）、图像编辑（/img2img）、语音通话（/cr-call）以及 Surf 加密数据 API 等额外功能。
- 在 OpenClaw 中运行的 AI 编码代理希望无需注册或API密钥即可使用多个 LLM 模型，节省成本。
- 继续使用 continue.dev、Cursor 或 VS Code 等 OpenAI 兼容客户端的开发者，希望自动路由到最便宜且胜任的模型，减少手动选模。
- 希望为零余额用户免费使用 LLM，并稍后添加 USDC 为付费模型买单的开发者和爱好者。
- 需要高效处理不同复杂度请求（如简单查询和复杂推理）的团队，避免为简单任务支付高级模型费用。
- 使用 Claude Code 但不想注册 Anthropic 账户或提供信用卡的用户，可借助 BRCC 利用相同的路由和支付能力。
- 需要从聊天中生成图像、视频或发起 AI 语音电话的代理，所有这些都可以通过同一钱包按次支付 USDC。
如何安装或部署这个 Agent？
安装 ClawRouter 需要 Node.js 和 npm。推荐使用 OpenClaw 插件方式：运行 curl -fsSL https://blockrun.ai/ClawRouter-update | bash，然后执行 openclaw gateway restart。纯 npm 方式：npm install -g @blockrun/clawrouter，然后必须运行 clawrouter setup 完成集成，否则插件未注册。独立方式：npx @blockrun/clawrouter 启动本地代理。无需注册或API密钥，首次运行会生成钱包地址。
如何使用这个 Agent？
安装后，ClawRouter 在本地 8402 端口运行代理。对于 OpenClaw，默认使用 blockrun/auto 模型；可通过 /model 切换配置。对于继续/光标，将 API 基本 URL 设置为 http://localhost:8402/v1/，API 密钥为 x402，模型为 blockrun/auto。要使用付费模型，请向钱包地址发送 USDC（Base 或 Solana）；要保持在 $0，可选择 free/mistral-nemotron 等免费模型。CLI 命令：/wallet 查看余额，/exclude add <model> 阻止模型，/stats 查看使用情况。通过 clawrouter doctor 诊断问题。
这个 Agent 有哪些优点和局限？
- 无需账户、API 密钥或信用卡：钱包签名即认证，USDC 微支付通过 x402 实现，完全面向代理。
- 完全本地智能路由：15 维评分器在 <1ms 内选择模型，无外部 API 调用，路由决策开源。
- 显著成本节省：自动化配置比对照 Claude Opus 5 节省 88%，生态配置节省 98%，且可复现。
- 6 个免费模型（NVIDIA），无任何费用，适合零余额使用；无数量限制。
- 兼容任何 OpenAI 兼容客户端，如 continue.dev、Cursor、VS Code，并可作为 OpenClaw 插件。
- 路由依赖于 BlockRun 的模型目录和定价，模型选择和成本由上游控制。
- x402 支付需要区块链上存在 USDC（Base 或 Solana），这引入了加密货币和网络门槛。
- 免费模型由 NVIDIA 托管，可能并非在所有地区都可用或延迟不一致。
- 独立安装需要正确配置 API 基础 URL（必须包含 /v1/ 后缀），否则容易出错。
- 高级功能（如语音通话、图像生成）需要额外的供应商依赖（Twilio、Bland.ai、BlockRun网关），可能带来额外成本和复杂性。
这个 Agent 与同类方案有什么区别？
OpenRouter：ClawRouter 是开源、本地运行、使用钱包认证和 USDC 支付，无需账户或信用卡；OpenRouter 需要账户、API 密钥和信用卡，要求手动选择模型。LiteLLM：两者都开源且本地运行，但 ClawRouter 增加智能路由、钱包认证和 USDC 支付；LiteLLM 需要自带 API 密钥并手动选模型。Martian：提供智能路由但闭源，需要账户和 API 密钥，无免费层。Portkey：提供网关和可观测性，但需要订阅费用，不专为代理设计。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ClawRouter —— 面向自主代理的 LLM 路由器 当前 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 6.6k | 今天 | TypeScript | OpenAI API · Claude API |
| Plano | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 7.1k | 11 天前 | Rust | OpenAI API · Claude API |
| ClawMetry | 81 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 432 | 1 天前 | Python | Codex · Claude Code |
| taOS 自托管智能体操作系统 | 71 · 存在缺口 | 自托管服务免费 | ★ 569 | 5 天前 | Python | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：项目声称本地路由、无外部依赖，但未提供代码细节验证权限最小化。用户确认机制缺失，未提及任何用户确认步骤。数据流透明度部分：README描述了请求流向，但未说明数据存储和日志。敏感数据处理：涉及钱包私钥，但未说明存储和加密方式。依赖安全：有overrides和CI，但未提供漏洞扫描结果。外部影响：涉及电话呼叫和支付，但未说明用户确认。回滚：有升级测试，但未提供回滚机制。来源归属：有作者和仓库，但发布者未验证。扣分原因：缺乏代码级证据，用户确认缺失，敏感数据处理不明确。
证据显示：README中数字前后不一致（如免费模型数6 vs 71），但CI中有品牌数字检查。依赖可用性：有package.json和CI，但未验证依赖可用性。失败消息：测试中有错误处理，但未提供用户可见的失败消息。扣分原因：数字不一致，失败消息未明确。
证据显示：README详细描述了多种使用场景（OpenClaw、continue.dev、Cursor等），但能力边界未明确。触发精度：有路由配置，但未说明触发条件。环境适配：有Node版本要求，但未说明其他环境。扣分原因：能力边界和触发条件不明确。
证据显示：README结构清晰，有安装说明和示例，但缺少FAQ和已知限制。命名稳定性：有版本号，但未说明命名规则。许可证：MIT许可证存在。版本变更日志：未提供。维护责任：有作者和仓库，但未说明维护计划。扣分原因：缺少FAQ、已知限制、变更日志。
证据显示：README声称节省88%成本，但未提供独立验证。输出可用性：有API和CLI，但未提供输出格式说明。边际价值：有独特功能（x402支付），但未与其他方案对比。成本效益：有定价表，但未提供实际成本分析。扣分原因：成本节省声明未验证。
证据显示：README中引用了savings-mix.json，但未提供具体数据。跨来源验证：有CI和测试，但未提供独立验证。事实与推断分离：README中混合了事实和营销声明。扣分原因：缺乏可验证的数据和独立验证。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 项目涉及钱包私钥和支付，但未提供安全审计或漏洞扫描证据。
- README中数字不一致（如免费模型数），可能影响用户预期。
- 未提供用户确认机制，特别是涉及电话呼叫和支付的操作。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.12.291 v0.12.291 — router-core 0.2.0, viem 2.57.5
发布说明摘录
router-core 0.2.0: more models can recover a tool turn @blockrun/router-core moves from e38958b to 0.2.0 (27125a3). Eleven newly listed models returned a real structured tool call in a live probe and are admitted as availability fallbacks for tool-required turns: Claude Fable 5.1 / Opus 5.5 / Sonnet 5.5, Gemini 3.8 Flash, GPT-5.1, GPT-6 Astra / Luna / Sol, Grok 4.6 / 4.7 and MiMo 2.5. They never displace a benchmarked primary, so which model Auto picks first is unchanged. When the usual tool chain is unavailable, eco and auto try the cheapest of them first; premium keeps …在 GitHub 查看 ↗ -
v0.12.290 v0.12.290 — @solana/kit 8.5.0
发布说明摘录
@solana/kit 8.4.0 → 8.5.0 Picks up the kit 8.5.0 minor release (supersedes Dependabot #468). The Dependabot lockfile nested private copies of @solana/transactions, @solana/transaction-messages and @solana/signers (up to 3 copies each), which the dist smoke check rejects because split copies sign malformed transactions. The @solana lock entries were re-resolved with npm 11, so every @solana/* package is again a single hoisted 8.5.0 copy and nothing outside @solana moved. Signed Solana payment transactions are byte-identical to 8.4.0: 8 cases …在 GitHub 查看 ↗ -
v0.12.289 v0.12.289 — CI actions pinned to commit SHAs
发布说明摘录
CI actions pinned to commit SHAs Every GitHub Action in the CI, publish, integration and brand-sync workflows is now pinned to an immutable commit SHA instead of a floating tag. Each pin is the commit its tag already resolved to, so the workflows run the same code as before, and the publish workflow (which holds the npm token) can no longer pick up a retagged action. Dependabot now also watches the github-actions ecosystem, so the pins get upgrade PRs (#465). No runtime change to the plugin.在 GitHub 查看 ↗
常见问题
ClawRouter 真的免费使用吗？
/model free 使用。如何为付费模型提供资金？
没有加密货币可以使用 ClawRouter 吗？
free/ 模型即可使用。要使用付费模型，则需要 USDC。ClawRouter 可以与我现有的工具一起使用吗？
http://localhost:8402。它还作为 OpenClaw 插件集成，并提供 BRCC 插件用于 Claude Code。如果发生故障怎么办？
npx @blockrun/clawrouter doctor 获取 AI 驱动的诊断。您还可以从路由中排除有问题的模型（/exclude add <model>）。