Clawrouter

核心用法

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汇率波动 | 监控单笔成本，设置钱包余额告警 |

核心用法

ClawRouter是OpenClaw生态中的托管网关LLM路由工具，通过四层智能分级（SIMPLE/MEDIUM/COMPLEX/REASONING）自动将请求路由至9大供应商的55+模型中最便宜的可用选项。用户只需配置单一USDC钱包，无需管理多平台API密钥。

安装与配置

openclaw plugins install @blockrun/clawrouter
openclaw models set blockrun/auto  # 启用智能路由

首次运行自动生成EVM私钥（BIP-39 24词助记词派生），存储于OpenClaw配置目录（~/.config/openclaw/），权限0600。支持Base和Solana双链支付。

路由机制

• SIMPLE层（40%流量）：事实查询→Gemini Flash，$0.60/M，节省99%
• MEDIUM层（30%）：摘要提取→DeepSeek Chat，$0.42/M，节省99%
• COMPLEX层（20%）：代码生成→Claude Opus，$75/M，质量优先
• REASONING层（10%）：逻辑推理→o3，$8/M，节省89%

80%请求由规则引擎<1ms判定，仅模糊查询触发LLM分类器（约$0.00003/次）。

内置工具生态

除LLM路由外，暴露BlockRun的x402付费数据API：

• 市场数据：12国股票实时价/历史OHLC（$0.001/call）、加密货币/外汇/大宗商品（免费）
• 生成式AI：DALL-E 3/Flux/Grok图像生成（$0.015-0.15/张）、Seedance视频生成（$0.03-0.30/秒）
• 预测市场：Polymarket全功能工具箱（事件/持仓/套利匹配，$0.001-0.005/call）

显著优点

1. 成本优化实证：官方宣称67%成本节省，示例显示极端场景可达99%（Gemini Flash替代GPT-4o处理简单查询）
2. 供应链透明：MIT许可证，GitHub+npm双渠道验证，每版本tagged release强制匹配
3. 多链支付灵活：Base/Solana双网关，USDC微支付（x402协议）无需法币通道
4. 工具即服务：8个免费NVIDIA模型（含gpt-oss-120b、DeepSeek-V3.2等）零门槛使用
5. 零密钥管理负担：单一钱包替代9大供应商API密钥轮换

潜在缺点与局限性

1. 非本地推理：明确声明为托管网关模式，prompts必须离开本地机器，不适合保密场景
2. 密钥明文存储：EVM私钥以plaintext存于本地JSON，依赖文件系统权限（0600）而非硬件安全模块
3. 单一供应商依赖：所有流量汇聚blockrun.ai网关，其可用性、定价策略、隐私政策变更直接影响用户
4. 支付摩擦：需预购USDC、理解x402微支付机制，对非加密原生用户存在门槛
5. 数据删除权利待完善：合规审计显示"数据删除权利支持"项为warn状态

适合人群

• 成本敏感型开发者：高频LLM调用场景（客服机器人、内容生成流水线）
• 多模型策略用户：需动态切换OpenAI/Anthropic/Google/DeepSeek等获取最优性价比
• 加密原生工作者：已持有USDC、熟悉EVM/Solana钱包操作
• 金融/预测市场分析师：需要集成实时股价、Polymarket数据的Agent工作流
• 非适用者：要求本地离线推理、处理高度敏感PII/商业机密、或无法接触加密货币支付的场景

常规风险

| 风险类别 | 具体表现 | 缓解措施 |

|---------|---------|---------|

| 数据外泄 | prompts发送至第三方网关 | 避免在对话中包含PII、凭证、商业机密；阅读https://blockrun.ai/privacy |

| 密钥泄露 | 私钥明文存储于~/.config/openclaw/ | 使用专用"burner wallet"仅存小额；启用全盘加密（FileVault/LUKS/BitLocker） |

| 供应链攻击 | npm包或GitHub release被篡改 | 验证`npm pack`与tagged commit哈希匹配；监控钱包异常支出 |

| 服务中断 | blockrun.ai网关不可用 | 保留fallback本地模型配置（如Ollama）应对关键任务 |

| 合规争议 | USDC支付涉及制裁风险 | 了解所在司法管辖区对稳定币支付的政策 |

安全认证摘要

CLS-Certify v2.1.0评分82/100，Grade A。纯Markdown文档型Skill无本地可执行代码，供应链完整（T2级组织账号+双渠道发布）。主要扣分项：网络分析（70分，9个外部API端点）和隐私合规中的数据删除权利支持。