Clawrouter

核心用法

ClawRouter 是一个托管网关 LLM 路由代理，作为本地轻量级代理运行。用户通过 OpenClaw 安装后，所有 LLM 请求被转发至 blockrun.ai 网关，由其自动选择 55+ 个模型（来自 OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA 等 9 家提供商）中最便宜且能胜任的模型执行。

关键特性：

• 四级智能路由：SIMPLE（Gemini Flash，省 99%）、MEDIUM（DeepSeek，省 99%）、COMPLEX（Claude Opus，最佳质量）、REASONING（o3，省 89%）
• 单一 USDC 钱包支付：无需持有各平台 API 密钥，通过 x402 微支付协议自动扣款
• 8 个免费 NVIDIA 模型：包括 gpt-oss-120b、DeepSeek-v3.2、Qwen3-coder-480b 等
• 内置 Agent 工具：实时全球股票/加密货币/外汇/大宗商品价格、Polymarket 预测市场数据、X/Twitter 情报、图像/视频生成

典型工作流：

openclaw plugins install @blockrun/clawrouter
openclaw models set blockrun/auto  # 启用智能路由
# 或直接指定模型：openclaw models set openai/gpt-4o

显著优点

1. 成本优化显著：官方声称平均节省 67%，简单任务可达 99%（对比直接使用 GPT-4）
2. 零 API 密钥管理负担：blockrun.ai 持有所有提供商关系，用户仅需维护一个 USDC 钱包
3. 开箱即用的金融数据工具：$0.001/次的全球 12 市场股价查询、免费加密/外汇/大宗商品数据，替代爬虫方案
4. 透明供应链：MIT 许可证，GitHub 开源，npm 发布，版本与标签强制对齐
5. Solana/Base 双链支持：默认 Base 主网，可选 Solana 网关降低 gas 成本

潜在缺点与局限性

| 方面 | 说明 |

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

| **非本地推理** | 所有 prompt 经 HTTPS 发送至 blockrun.ai，不满足数据主权或离线需求 |

| **隐私边界** | 与使用 OpenAI/Anthropic 直接 API 同等隐私风险，敏感数据需谨慎 |

| **钱包安全** | EVM/Solana 私钥以明文存储于本地配置文件（`0600` 权限），无额外加密层 |

| **提供商锁定** | 依赖 blockrun.ai 网关的可用性与定价策略，无 fallback 机制 |

| **成本透明度** | 实际节省率因任务分布而异，复杂任务（Claude Opus/o3）成本可能接近原价 |

| **地域限制** | 需要 USDC 支付能力，部分地区用户可能面临法币入金障碍 |

适合人群

• 成本敏感型开发者：高频调用 LLM 且希望优化推理预算的团队
• 金融/交易类 Agent 构建者：需要实时市场数据、预测市场情报的原生集成
• 多模型实验用户：希望无缝切换 55+ 模型而无需管理多个 API 账户
• Solana/Base 生态参与者：已有 USDC 钱包，熟悉链上支付流程

常规风险

1. 私钥泄露风险：配置文件若被恶意软件读取，USDC 钱包资金直接暴露。建议：使用专用"燃烧钱包"，仅存入预期消费金额
2. 网关单点故障：blockrun.ai 服务中断将导致所有路由失败，无本地降级方案
3. 智能合约风险：x402 支付协议依赖链上合约，存在潜在漏洞可能
4. 数据残留：prompt 内容在 blockrun.ai 网关有短暂驻留，需遵守其隐私政策
5. 汇率波动：USDC 虽为稳定币，但网关定价以美元计价，存在微小兑换摩擦

核心用法

ClawRouter 是一个托管网关型LLM路由器，作为本地代理将请求转发至 blockrun.ai 网关，由网关从55+模型中自动选择最便宜且能胜任任务的模型。用户只需配置单一USDC钱包，无需管理多个供应商API密钥。

典型工作流：
1. 安装：openclaw plugins install @blockrun/clawrouter
2. 启用智能路由：openclaw models set blockrun/auto
3. 发起请求 → 本地代理 → blockrun.ai 网关 → 自动选择最优模型 → 返回结果

四层智能路由系统：

• SIMPLE（40%流量）：事实查询、问候、翻译 → Gemini Flash（节省99%）
• MEDIUM（30%）：摘要、解释、数据提取 → DeepSeek Chat（节省99%）
• COMPLEX（20%）：代码生成、多步分析 → Claude Opus（最佳质量）
• REASONING（10%）：证明、形式逻辑、多步数学 → o3（节省89%）

内置代理工具（x402支付，无需额外API密钥）：

• 实时市场数据：全球12个股票市场、加密货币、外汇、大宗商品
• 图像/视频生成：DALL-E 3、Flux、Grok Imagine等8个模型
• Polymarket预测市场：完整工具箱，含智能资金定位、跨市场套利匹配

显著优点

成本优化突出：官方宣称平均节省67%，SIMPLE/MEDIUM层级可达99%成本削减。规则引擎处理80%请求仅需<1ms，仅模糊查询触发LLM分类器（约$0.00003/次）。

使用体验简洁：单一USDC钱包替代多供应商API密钥管理；8个NVIDIA免费模型降低入门门槛；OpenClaw原生集成，配置即开即用。

数据工具生态独特：将实时金融数据、社交媒体情报、预测市场数据以工具形式暴露给Agent，替代传统爬虫方案，定价透明（$0.001/调用起）。

供应链透明度高：MIT许可证，完整GitHub开源，每版本强制对齐（git tag = GitHub release = npm publish），支持本地tarball校验。

潜在缺点与局限性

非本地推理：所有提示通过HTTPS发送至 blockrun.ai 网关，不适合数据绝对不能离境的场景。文档明确建议此类用户转向Ollama等本地运行时。

密钥管理风险：EVM私钥和Solana密钥以明文形式存储于本地配置文件（~/.config/openclaw/config.json），依赖文件系统权限（0600）保护。虽为设计选择，但意味着主机沦陷即密钥沦陷。

供应商锁定：推理执行完全依赖BlockRun运营的基础设施，若网关服务中断或政策变化，将直接影响可用性。USDC支付体系也绑定于BlockRun的x402实现。

分类器局限性：20%请求可能触发LLM分类器产生额外成本；复杂边界案例的分类准确性依赖训练数据覆盖度。

适合人群

• 成本敏感的企业开发者：需高频调用LLM且希望优化推理支出
• 多模型策略团队：需要灵活切换OpenAI/Anthropic/Google/DeepSeek等模型而无需维护多个集成
• 金融数据Agent开发者：需要实时市场数据、预测市场情报作为Agent工具
• USDC/crypto原生团队：已熟悉链上支付流程，接受微支付模式

不适合人群：数据主权要求极高（必须本地推理）、无法接受任何第三方网关传输、不熟悉加密货币钱包管理、或需完全离线环境的用户。

常规风险

运营风险：托管网关的单点故障；USDC价格波动对小额支付的影响；智能合约/支付通道潜在漏洞。

数据隐私风险：提示内容完整传输至第三方；虽宣称遵循标准LLM API隐私实践，但仍需避免传输PII/商业机密级数据。

安全运营风险：本地明文密钥需配合全盘加密（FileVault/LUKS/BitLocker）使用；建议将钱包视为"消费账户"而非价值存储，控制单钱包余额暴露。

合规不确定性：预测市场数据工具（Polymarket）在某些司法辖区存在监管限制；需用户自行评估所在地法规合规性。