ClawRouter —— 面向自主代理的 LLM 路由器
专为无法注册账号、无法输入信用卡的自主代理设计的 LLM 路由:本地 <1ms 智能路由,0 个 API 密钥,通过 x402 按次支付 USDC。
证据显示:项目声称本地路由、无外部依赖,但未提供代码细节验证权限最小化。用户确认机制缺失,未提及任何用户确认步骤。数据流透明度部分: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中数字不一致(如免费模型数),可能影响用户预期。
- 未提供用户确认机制,特别是涉及电话呼叫和支付的操作。
这个 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 有哪些优点和局限?
- 无需账户、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?
安装 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 与同类方案有什么区别?
OpenRouter:ClawRouter 是开源、本地运行、使用钱包认证和 USDC 支付,无需账户或信用卡;OpenRouter 需要账户、API 密钥和信用卡,要求手动选择模型。LiteLLM:两者都开源且本地运行,但 ClawRouter 增加智能路由、钱包认证和 USDC 支付;LiteLLM 需要自带 API 密钥并手动选模型。Martian:提供智能路由但闭源,需要账户和 API 密钥,无免费层。Portkey:提供网关和可观测性,但需要订阅费用,不专为代理设计。
常见问题
ClawRouter 真的免费使用吗?
/model free 使用。如何为付费模型提供资金?
没有加密货币可以使用 ClawRouter 吗?
free/ 模型即可使用。要使用付费模型,则需要 USDC。ClawRouter 可以与我现有的工具一起使用吗?
http://localhost:8402。它还作为 OpenClaw 插件集成,并提供 BRCC 插件用于 Claude Code。如果发生故障怎么办?
npx @blockrun/clawrouter doctor 获取 AI 驱动的诊断。您还可以从路由中排除有问题的模型(/exclude add <model>)。