核心用法
ClawRouter是OpenClaw生态的托管网关LLM路由代理,作为本地轻量代理层,将所有请求转发至blockrun.ai网关进行智能调度。用户无需持有各厂商API密钥,通过单一USDC钱包完成所有计费。
典型工作流:
1. 安装@blockrun/clawrouter npm包
2. 执行openclaw models set blockrun/auto启用智能路由
3. 应用发送OpenAI兼容格式的请求至本地代理
4. ClawRouter附加x402签名的USDC支付头,转发至网关
5. 网关按四层分类(SIMPLE/MEDIUM/COMPLEX/REASONING)自动选择最便宜可用模型
6. 返回结果经代理透传回应用
核心差异化能力:
- 成本优化:四层路由规则处理80%请求<1ms,仅模糊查询触发LLM分类器(~$0.00003/次),官方宣称平均节省67%
- 免费模型层:8个NVIDIA托管模型零成本使用(含gpt-oss-120b、deepseek-v3.2等)
- 内置工具集:无需额外API密钥即可调用实时股价(12国市场)、加密/外汇/大宗商品价格、Polymarket预测市场数据、图像/视频生成等x402付费工具
显著优点
- 密钥管理简化:单一钱包替代多平台API密钥运维,降低凭证泄露面
- 模型覆盖广:55+模型跨9家提供商(OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA等),包含最新旗舰模型
- 透明计费:每笔请求成本实时可见,支持Base和Solana双链支付
- 供应链可审计:MIT开源,GitHub标签与npm版本强制同步,可本地
npm pack验证
潜在缺点与局限性
- 非本地推理:所有提示经HTTPS发送至blockrun.ai网关,不满足数据驻留合规要求;隐私级别等同于直接向OpenAI/Anthropic发送请求
- 钱包安全边界:EVM/Solana私钥以明文存储于OpenClaw配置文件(
0600权限依赖系统保护),无额外加密层;官方建议视为"消费账户"而非长期储值 - 供应商锁定风险:推理完全依赖blockrun.ai网关可用性,无退路本地降级方案
- 支付摩擦:需预存USDC并理解x402微支付机制,对非加密原生用户有学习成本
- 分类器盲区:20%请求依赖LLM分类判断,极端冷门场景可能误分配至高价模型
适合人群
- 成本敏感、需高频调用多模型对比的AI应用开发者
- 希望快速集成金融数据/预测市场工具而无需申请多平台API的agent构建者
- 已熟悉加密支付流程、能接受托管推理模式的技术团队
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 数据隐私 | 提示内容完整发送至第三方网关 | 避免输入PII、商业机密;评估blockrun.ai隐私政策 |
| 密钥泄露 | 本地钱包私钥明文存储,主机沦陷即资金风险 | 使用专用"燃烧钱包",限额充值;部署于加密卷(FileVault/LUKS/BitLocker) |
| 供应链 | npm包与GitHub源理论上可审计,但用户实际验证率低 | 关键版本执行`npm pack`比对 |
| 服务连续性 | 网关故障或blockrun.ai运营终止导致服务中断 | 保留直接调用原厂API的降级代码路径 |
| 计费异常 | 智能路由误判导致高价模型调用,或USDC汇率波动 | 监控单笔成本,设置钱包余额告警 |