Clawrouter

核心用法

ClawRouter是OpenClaw生态的托管网关LLM路由代理。用户在本地运行轻量级代理，所有请求经HTTPS转发至blockrun.ai网关，由其智能路由到55+模型中最便宜的 capable 模型执行。无需持有各厂商API密钥，统一通过USDC钱包结算。

关键数据流：

• 本地应用 → localhost代理 → https://blockrun.ai/api → 实际模型提供商 → 响应返回
• 每请求发送：模型名、完整prompt、采样参数、x402签名的USDC微支付头
• 不发送：钱包私钥（仅 detached 签名）、本地文件、其他环境变量

路由四层分级：

| 层级 | 场景 | 典型模型 | 成本 |

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

| SIMPLE | 事实查询、问候、翻译 | Gemini Flash | $0.60/M, 99%节省 |

| MEDIUM | 摘要、解释、数据提取 | DeepSeek Chat | $0.42/M, 99%节省 |

| COMPLEX | 代码生成、多步分析 | Claude Opus | $75/M, 最佳质量 |

| REASONING | 证明、形式逻辑、数学 | o3 | $8/M, 89%节省 |

内置工具：

• 市场数据：全球12股市、加密货币、外汇、大宗商品实时价格与历史K线
• Twitter/X情报：实时用户档案查询（粉丝数、认证状态等）
• Polymarket预测市场：8种工具涵盖事件、排行榜、聪明钱追踪、跨市场套利

显著优点

1. 成本优化显著：官方宣称67%成本节省，SIMPLE/MEDIUM层级可达99%
2. 零API密钥管理：blockrun.ai持有所有厂商关系，用户只需维护USDC钱包
3. 模型覆盖广：55+模型含8个免费NVIDIA模型（gpt-oss-120b等）
4. 即开即用的金融数据工具：无需额外API key即可调用股票、加密、预测市场数据
5. 开源可审计：MIT许可证，GitHub源码公开，npm包与git tag版本对应
6. 自动化密钥管理：EVM/Solana钱包自动派生，首次运行无感生成

潜在缺点与局限性

1. 非本地推理：所有prompt发送至第三方网关，不满足数据本地化合规要求
2. 隐私边界模糊：与OpenAI/Anthropic等同等对待，敏感数据不宜直接发送
3. 支付链依赖：依赖x402 USDC支付协议，需理解区块链钱包操作
4. 密钥存储风险：钱包私钥明文存储于OpenClaw配置文件，依赖系统文件权限（0600），无额外加密层
5. 单一网关依赖：blockrun.ai服务可用性直接决定可用性
6. 成本透明度：路由决策黑盒，用户难以预判具体计费

适合人群

• 成本敏感且愿意接受托管网关模式的个人开发者、初创团队
• 需要实时金融/社交数据但不愿整合多API key的Agent开发者
• 已有OpenClaw生态用户，寻求即插即用的模型路由方案
• 非高机密场景，可接受第三方托管推理的通用AI应用

常规风险

• 密钥泄露：配置文件若被窃取，USDC钱包资金直接面临风险（建议小额 burner 钱包策略）
• 供应链攻击：npm包与GitHub源码需手动校验一致性
• 网关隐私：blockrun.ai的数据处理政策需独立审查
• 区块链支付波动：USDC网络费用、汇率波动影响实际成本
• 模型降级风险：自动路由可能在质量敏感场景选择次优模型

核心用法

ClawRouter 是一个托管网关 LLM 路由器，作为 OpenClaw 插件运行。用户安装后，通过 openclaw models set blockrun/auto 启用智能路由，或在请求时直接指定模型。系统会将提示转发至 blockrun.ai 网关，由其从 55+ 模型（OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA 等）中选择最便宜的可用模型执行，返回结果经本地代理透传回应用。

典型工作流：
1. 安装：openclaw plugins install @blockrun/clawrouter
2. 配置：自动生成 EVM/Solana 钱包密钥，无需手动管理 API key
3. 使用：像调用普通 LLM API 一样发送请求，ClawRouter 自动处理模型选择与支付
4. 内置工具：可直接调用股价、加密货币、外汇、商品、X 用户查询、Polymarket 预测市场等 20+ 数据工具

显著优点

• 成本优化：官方宣称平均节省 67% 推理费用，SIMPLE 类请求可省 99%（Gemini Flash $0.60/M）
• 智能分层路由：四档自动分级（SIMPLE/MEDIUM/COMPLEX/REASONING），80% 请求规则匹配 <1ms
• 统一支付：单一 USDC 钱包覆盖所有 55+ 模型及数据工具，无需分别申请各厂商 API key
• 丰富内置工具：实时全球股票（12 市场）、加密货币、外汇、贵金属、X 用户资料、Polymarket 全功能套件
• 供应链透明：MIT 开源，GitHub 公开仓库，npm 包与标签版本强制对齐，可审计
• 8 个免费 NVIDIA 模型：包括 Llama-4-Maverick、DeepSeek-V3.2、Qwen3-Coder-480B 等

潜在缺点与局限性

• 数据外泄风险：所有提示必须发送至 blockrun.ai 网关，无法离线运行，不适合高度敏感数据场景
• 中心化依赖：完全依赖 BlockRun 网关的可用性与定价策略，无 fallback 选项
• 支付摩擦：需持有 USDC 并理解 x402 微支付机制，对非加密用户有门槛
• 私钥本地明文存储：walletKey/solanaKey 以明文存于 OpenClaw 配置目录，依赖文件系统权限（0600）保护
• 成本不可完全预测：动态路由意味着单次请求成本浮动，需监控余额
• 模型选择黑盒：虽然文档说明分层逻辑，但具体路由决策由网关算法决定，用户可控性有限

适合人群

• 成本敏感的多模型用户：需要频繁调用不同厂商高端模型，希望自动优化费用
• 金融/加密数据开发者：需要实时股票、加密货币、Polymarket 数据，且愿意用 USDC 结算
• 非隐私敏感场景：处理公开数据、通用知识问答、代码生成等无需本地隔离的工作负载
• 已熟悉加密支付的用户：已有 USDC 钱包，不介意 x402 微支付流程

常规风险

| 风险类型 | 描述 | 缓解建议 |

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

| 数据隐私 | 提示内容发送至第三方网关 | 避免输入 PII、商业机密；评估 blockrun.ai 隐私政策 |

| 密钥安全 | 钱包私钥本地明文存储 | 使用专用小额"燃烧钱包"；启用磁盘加密；定期轮换 |

| 供应链 | 依赖 npm 包与网关服务 | 关键场景验证 npm pack 与 GitHub tag 一致性 |

| 费用失控 | 动态定价+工具调用累积 | 监控余额；设置预算上限；了解各工具 $0.001-$0.005/call 定价 |

| 服务可用性 | 网关单点故障 | 准备 fallback 方案（如直连 OpenAI API）用于关键业务 |