Clawrouter

核心用法

ClawRouter 是一个本地代理服务，将 LLM 请求转发至 blockrun.ai 托管网关，由其智能路由至 9 家提供商的 55+ 模型中最便宜的可用选项。用户无需管理各厂商 API key，统一通过 USDC 钱包支付。

关键特性：

• 四级路由分类：SIMPLE（40% 流量）→ Gemini Flash、MEDIUM（30%）→ DeepSeek Chat、COMPLEX（20%）→ Claude Opus、REASONING（10%）→ o3，规则匹配 80% 请求耗时 <1ms
• 8 个免费 NVIDIA 模型：包括 gpt-oss-120b/20b、deepseek-v3.2 等
• 内置 Agent 工具：全球 12 市场股价、加密货币、外汇、大宗商品实时数据，以及 Polymarket 预测市场全套工具，统一按次计费（$0.001–$0.30）
• 图像/视频生成：集成 DALL-E 3、Flux、Grok Imagine、Seedance 等 8 个模型

显著优点：

• 潜在成本节省显著（宣称最高 99%）
• 简化多厂商 API 管理，单一钱包结算
• 开箱即用的金融数据工具链，无需额外 API 配置
• MIT 开源，npm 可审计安装

潜在局限与风险：

• 非本地推理：所有 prompt 经 HTTPS 发送至 blockrun.ai 网关，隐私敏感场景不适用
• 钱包密钥明文存储：walletKey（EVM 私钥）和 solanaKey 以明文保存在 OpenClaw 配置文件，依赖文件系统权限（0600），无额外加密层
• 供应链信任：核心路由逻辑在 blockrun.ai 服务端黑箱运行，用户无法验证实际模型选择逻辑
• 支付风险：私钥一旦泄露，USDC 余额可被转移，官方建议仅存入预期消费金额（"burner wallet" 模式）
• 单一故障点：网关不可用则全服务中断

适合人群：

• 成本敏感、需频繁调用多厂商 LLM 的开发者
• 需要集成实时金融/预测市场数据的量化或研究型 Agent 项目
• 对隐私要求不高、可接受第三方网关托管的业务场景

常规风险：

• 第三方网关的数据留存与合规政策（参考 blockrun.ai/privacy）
• 加密货币支付的波动性与链上手续费
• 路由算法的透明度和公平性无法独立审计

核心用法

ClawRouter 是 OpenClaw 生态的托管网关路由器 Skill，并非本地推理工具。它作为轻量级本地代理，将所有 LLM 请求转发至 blockrun.ai 网关，由网关智能路由至 55+ 模型（OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA 等）中最便宜且能胜任的模型。用户只需维护一个 USDC 钱包，无需持有各厂商 API 密钥。

安装启用：

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

四层路由机制：

• 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/次）。

内置 Agent 工具：

• 实时市场数据：全球 12 个股市、加密货币、外汇、大宗商品价格
• Polymarket 预测市场：完整事件、排行榜、聪明钱定位、跨市场套利
• 图像/视频生成：DALL-E 3、Flux、Grok Imagine、ByteDance Seedance 等 8+ 模型

---

显著优点

| 维度 | 优势 |

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

| **成本优化** | 官方宣称节省 67% 推理成本，实际案例显示最高省 99%（Gemini Flash 处理简单查询） |

| **模型覆盖** | 55+ 模型，含 8 个免费 NVIDIA 模型（gpt-oss-120b、DeepSeek-V3.2 等） |

| **简化管理** | 单一 USDC 钱包结算，告别多平台 API 密钥管理 |

| **数据工具** | 内置金融级实时数据 API，Agent 可直接调用而非爬取网站 |

| **透明计费** | 每次请求成本实时显示，示例输出展示精确到小数点后四位的费用对比 |

| **供应链可信** | GitHub 与 npm 版本严格同步打标签，支持本地 tarball 校验 |

---

潜在缺点与局限性

1. 非本地推理：所有提示必须发送至 blockrun.ai 网关，无法满足数据不出本地的合规要求。文档明确说明："If your workload requires inference that never leaves your machine, use Ollama — ClawRouter is not the right tool"

2. 密钥明文存储：EVM/Solana 私钥以明文存储于 OpenClaw 配置文件（权限 0600），虽符合 OpenClaw 标准，但无额外加密层。主机被入侵即密钥泄露

3. 网关单点依赖：所有推理与支付流依赖 blockrun.ai 服务可用性，无离线降级能力

4. USDC 门槛：需持有并管理 USDC 钱包，对非 Crypto 用户存在学习成本

5. 数据隐私边界：提示内容、采样参数、模型名称均发送至第三方，虽披露完整但本质上构成数据外泄通道

6. 分类器成本：20% 请求触发 LLM 分类器，增加约 $0.00003/次的固定开销

---

适合人群

• 成本敏感型开发者：需高频调用多模型，愿以数据出境换取显著成本节省
• 金融/交易类 Agent 开发者：需要实时股价、加密货币、预测市场数据的内置工具
• 多模型对比测试者：快速切换 55+ 模型评估效果，无需分别申请 API 密钥
• Crypto 原生用户：已熟悉 USDC 钱包管理，不介意微支付流程
• 非敏感数据处理场景：客服机器人、公开信息摘要、创意内容生成等

不适合人群： 处理 PII/PHI/机密数据的合规场景、要求完全离线推理的环境、不愿接触加密货币支付的用户

---

常规风险

| 风险类别 | 等级 | 说明 |

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

| 数据外泄 | ⚠️ 中 | 提示必达 blockrun.ai，虽 HTTPS 加密但服务端可见明文 |

| 密钥被盗 | ⚠️ 中 | 本地明文存储，主机入侵即资金风险；建议 burner 钱包策略 |

| 网关宕机 | ⚠️ 中 | 单点依赖，无本地 fallback |

| 模型降级 | ⚠️ 低 | 路由错误可能导致复杂任务被分配到简单模型，影响质量 |

| 供应链攻击 | ✅ 低 | 来源可信（T2），版本严格同步，支持本地校验 |

| 计费争议 | ⚠️ 低 | USDC 微支付不可逆，需自行监控余额 |

关键安全建议： 使用专用 burner 钱包仅充值预期消费金额；在加密卷上运行 OpenClaw；定期轮换密钥；避免在提示中包含敏感信息。