Clawrouter

核心用法

ClawRouter 是一个本地代理层，将 OpenAI 兼容格式的 API 请求转发至 blockrun.ai 网关，由网关根据请求复杂度自动路由到 55+ 个模型中最便宜的可用选项。支持 9 家提供商（OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA 等），包含 8 个免费 NVIDIA 模型。

安装后通过 openclaw models set blockrun/auto 启用智能路由，或指定具体模型如 openai/gpt-4o。请求被分为四级：SIMPLE（Gemini Flash，省 99%）、MEDIUM（DeepSeek Chat，省 99%）、COMPLEX（Claude Opus）、REASONING（o3）。

重要：这不是本地推理工具——所有 prompt 通过 HTTPS 发送至 blockrun.ai 网关执行，不适合需要数据不出机的场景。

显著优点

• 成本优化：官方宣称平均节省 67%，简单任务可省 99%
• 统一管理：单一 USDC 钱包结算，无需管理多平台 API key
• 丰富工具集：内置股票/加密/外汇/大宗商品实时数据、Polymarket 预测市场、Twitter/X 情报、图像/视频生成等 x402 付费工具
• 零配置启动：钱包私钥本地自动生成，无需手动输入
• 开源可审计：MIT 许可，GitHub 源码与 npm 包版本严格对应

潜在缺点与局限

• 隐私风险：prompt 必须上传至第三方网关，等同于发送给 OpenAI/Anthropic 等，敏感数据需谨慎
• 单点依赖：blockrun.ai 网关故障或下线将完全中断服务
• 私钥管理：EVM 和 Solana 私钥以明文存储于本地配置文件，依赖文件系统权限保护，无额外加密层
• 网络要求：必须保持外网连接，无法离线使用
• 资金风险：需预存 USDC 至热钱包，机器被入侵可能导致资金损失

适合人群

• 需要频繁调用多平台 LLM 且关注成本优化的开发者
• 需要实时金融/预测市场数据作为 Agent 工具的场景
• 能接受数据上传至第三方网关、非隐私敏感型工作负载

常规风险

• 供应链：npm 包与 GitHub 版本可交叉验证，但仍需信任 blockrun.ai 网关运营方
• 资金安全：建议仅存放预期消费金额，使用专用" burner wallet"
• 合规：USDC 支付涉及加密货币，需考虑当地监管要求
• 数据留存：需遵守 blockrun.ai 隐私政策，商业敏感数据建议先行评估

核心用法

ClawRouter 是一个托管网关式 LLM 路由器，作为本地代理将请求转发至 blockrun.ai 网关，由其自动选择最便宜且能胜任任务的模型。支持 55+ 模型（OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA 等），含 8 个免费 NVIDIA 模型。

安装与配置：

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%）

内置 Agent 工具：

• 全球市场数据（股票、加密、外汇、大宗商品）
• Polymarket 预测市场全套工具（事件、排行榜、聪明钱分析、跨市场套利）
• 图像/视频生成（DALL-E 3、Flux、Grok Imagine 等）

所有服务统一用 USDC 钱包付费，无需持有各平台 API Key。

显著优点

| 维度 | 优势 |

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

| **成本优化** | 官方宣称节省 67% 推理成本，规则分级 80% 请求 <1ms 决策 |

| **模型覆盖** | 55+ 模型实时比价，含 10 个免费 NVIDIA 模型 |

| **支付便利** | 单一 USDC 钱包结算，免管理多平台 API Key |

| **工具生态** | 预集成金融数据、预测市场、媒体生成，降低 Agent 开发门槛 |

| **透明度** | 数据流向、密钥存储、隐私政策文档清晰，供应链可审计（GitHub 标签对应 npm 版本）|

潜在缺点与局限性

1. 非本地推理：所有 prompts 经 HTTPS 发送至 blockrun.ai，不满足本地离线需求。敏感数据场景需自行评估。

2. 外部信任依赖：必须信任 BlockRunAI 网关的模型选择公平性、价格真实性及数据保密性。若网关故障或被攻破，服务完全中断。

3. 密钥存储方式：EVM/Solana 私钥以明文存储于 ~/.config/openclaw/config.json，依赖文件系统权限（0600）保护，无额外加密层。

4. 成本可控性：智能路由虽便宜，但 "COMPLEX" 档仍可能选用 $75/M 的 Claude Opus，高频复杂任务成本可能超预期。

5. 网络延迟：相比直连 OpenAI/Anthropic，增加本地→blockrun.ai→上游厂商的跳转，对延迟敏感场景需实测。

适合人群

• 成本敏感的中高频 LLM 用户：月消耗 $50+ 的团队，希望自动化降低账单
• 多模型策略开发者：需要透明比价、动态切换模型，无需自建路由逻辑
• Agent/自动化工作流构建者：需要预集成的市场数据、预测市场、媒体生成工具
• USDC/加密友好用户：偏好加密货币支付，或难以获取传统 API Key 的地区用户

不适合： 数据必须本地离线处理（如医疗、军工）、对第三方托管极度敏感、或追求极致延迟优化的场景。

常规风险

| 风险类别 | 具体说明 | 缓解建议 |

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

| **供应链风险** | 实际运行代码来自 npm 包 `@blockrun/clawrouter`，与 SKILL.md 分离 | 安装前比对 GitHub tag 与 npm tarball；使用 `npm pack` 验证 |

| **密钥泄露** | 私钥明文存储，主机沦陷即资产风险 | 使用专用 burner wallet，仅存入预期消费金额；主机启用全盘加密 |

| **数据隐私** | prompts 发送至第三方，可能用于模型训练（需确认隐私政策） | 避免发送商业机密、PII；定期审阅 https://blockrun.ai/privacy |

| **服务商单点故障** | blockrun.ai 网关不可用时服务完全中断 | 关键业务保留 fallback 直连方案 |

| **价格/模型透明度** | 实际路由逻辑、比价数据源黑箱 | 监控输出日志中的 cost 字段，交叉验证账单 |

---

关键决策点：接受 "托管网关 + 明文本地密钥" 换取 "成本节省 + 多模型便利"，还是坚持本地推理（Ollama/vLLM）牺牲模型多样性与易用性。