clawrouter

ClawRouter

托管网关 LLM 路由器，通过将每个请求转发到 blockrun.ai 网关来节省 84% 的推理成本。该网关会从 9 家提供商的 90 个模型（其中包含 7 个免费开放权重模型）中，选择能够处理请求的最便宜模型。所有费用都通过一个 BlockRun 凭证结算——可以使用 USDC 钱包，通过 x402 按次付款；也可以使用 BlockRun API 密钥，从银行卡充值的账户余额中扣款。无论采用哪种方式，你都无需持有提供商的 API 密钥。

这不是本地推理工具。 ClawRouter 是一个轻量级本地代理。你的提示词会通过 HTTPS 发送到 blockrun.ai 网关执行模型推理。如果你的工作负载要求推理过程绝不离开本机，请使用 Ollama 等本地运行时——ClawRouter 不适用于这种场景。

源码：https://github.com/BlockRunAI/ClawRouter · npm：https://www.npmjs.com/package/@blockrun/clawrouter · 许可证：MIT。

数据流

Your app → localhost proxy (ClawRouter) → https://blockrun.ai/api  (or sol.blockrun.ai/api)
                                              ↓
                                        OpenAI / Anthropic / Google / etc.
                                              ↓
                                        Response → back through proxy → your app

**每次请求都会发送到 blockrun.ai 的内容：**模型名称、完整的提示词/消息正文、采样参数（temperature、max_tokens、工具等），以及付款凭证——钱包模式下为包含已签名 x402 USDC 微支付的 X-PAYMENT 请求头，API 密钥模式下为 Authorization: Bearer brk_live_… 请求头。

**不会发送的内容：**你的钱包私钥（仅会发送独立的付款签名）、任何其他本地文件、环境变量，或超出此请求所需内容的 OpenClaw 配置。

**BlockRun 的隐私立场：**https://blockrun.ai/privacy。请像对待发送给任何托管 LLM API（OpenAI、Anthropic 等）的提示词一样对待这些提示词——不要发送你不愿与第三方 API 提供商分享的数据。

凭据与本地密钥存储

ClawRouter 不会收集或转发第三方提供商的 API 密钥。你无需提供 OpenAI、Anthropic、Google、DeepSeek、xAI 或 NVIDIA 的凭据——这些关系由 blockrun.ai 网关负责。

models.providers.blockrun 存储的内容（完整列出）：

字段	是否敏感	用途
walletKey	仅限钱包模式	用于通过 x402 为 USDC 小额支付签名的 EVM 私钥。首次运行时在本地自动生成——无需用户输入。绝不会通过网络传输；仅发送分离式支付签名。配置 BlockRun API 密钥时，完全不会使用、读取或生成该密钥。
solanaKey	是	Solana 密钥对（BIP-44 m/44'/501'/0'/0'）。通过 @scure/bip32 + @scure/bip39 从同一份本地助记词自动派生。
gateway	否	网关 URL。默认值：https://sol.blockrun.ai/api（Solana，新安装时的默认链）· https://blockrun.ai/api（Base，现有安装的默认链）。
routing	否	可选的路由器核心配置覆盖项（层级链、strategy: "rules" 回退、shadow 比较、评分器关键词）。

密钥的存储方式和位置：

• 密钥存储在 OpenClaw 用户配置文件中——通常在 Linux 上为 ~/.config/openclaw/config.json，在 macOS 上为 ~/Library/Application Support/openclaw/config.json，在 Windows 上为 %APPDATA%\openclaw\config.json——路径为 models.providers.blockrun。
• 由 OpenClaw 的标准配置写入器写入；在 POSIX 系统上权限为 0600（仅所有者可读写）。
• 以明文存储，与 OpenClaw 存储所有提供商 API 密钥的方式相同。ClawRouter 不会额外增加加密层；文件系统权限就是安全边界。如果你需要加密密钥库，请在加密卷（FileVault、LUKS、BitLocker）上运行 OpenClaw，或使用专用的一次性钱包，且只存入你打算花费的金额。
• 自动生成时会使用 @scure/bip39 生成 24 个单词的助记词，然后通过 BIP-44 为两条链派生密钥。源码：src/wallet.ts。

**运维建议：**将钱包视为只存入少量资金的消费账户，而非长期价值储存。存入你预计用于大模型调用的金额。如果主机遭到入侵，钱包密钥也会泄露——请轮换密钥并退回资金。

供应链完整性

• 每个版本都会在 GitHub 上打标签：https://github.com/BlockRunAI/ClawRouter/releases
• 每个版本都会发布到 npm，并使用匹配的版本号：https://www.npmjs.com/package/@blockrun/clawrouter?activeTab=versions
• skills/release/SKILL.md 中的强制检查清单会确保：package.json 中的版本、Git 标签、GitHub 版本发布和 npm 发布均相匹配。
• 要在本地验证：运行 npm pack @blockrun/clawrouter@<version>，并将生成的 tarball 内容与已打标签的提交进行比较。

安装

openclaw plugins install @blockrun/clawrouter

上面的结构化 install 块会指示 OpenClaw 安装可审计的 npm 包 @blockrun/clawrouter。每个版本的源代码都在 GitHub 上；每次发布都有对应标签。

设置

# Enable smart routing (auto-picks cheapest model per request)
openclaw models set blockrun/auto

# Or pin a specific model
openclaw models set openai/gpt-4o

路由工作原理

路由由本地的 @blockrun/router-core 处理（Router Core V3.4，约束优先），该代码内联到 ClawRouter 中，并固定到特定提交。无需网络调用，也不需要第二个模型——每个请求约耗时四分之一毫秒。

1. 15 维加权评分器会将每个请求归入四个层级之一，任务分类器则会标注工作类型（chat、extraction、code_edit、code_agent、tool_agent、reasoning_math、long_context、vision，等等）。
2. 无法满足请求的模型——不支持工具调用、不支持视觉、上下文窗口或最大输出长度过小，或不兼容结构化输出——会在评分前被移除。
3. 剩余模型会根据任务质量、能力、预估成本、速度和可靠性进行排名；完整的排名列表会作为超时和 5xx 错误时的回退链保留。

默认 auto 配置中的精选首选模型：

• SIMPLE — 事实查询、问候、翻译 → gemini-2.5-flash
• MEDIUM — 摘要、解释、数据提取 → kimi-k2.7
• COMPLEX — 代码生成、多步骤分析 → gemini-3.1-pro
• REASONING — 证明、形式逻辑、多步骤数学 → grok-4-1-fast-reasoning

实际需要使用所附工具的轮次会切换到针对 Agent 调优的层级（gpt-4o-mini → kimi-k2.7 → claude-sonnet-4.6）。eco 从免费层级开始（nemotron-3.5-lightning）；premium 则会升级到 gpt-5.3-codex / claude-fable-5 / claude-sonnet-4.6。完整链路见：docs/routing-profiles.md。

此处有意不列出各层级的 节省百分比：已公布的数字是根据指定的工作负载组合计算的综合值，而 单个层级的数字容易让人拿它与一个未明确说明的基准进行比较。请参阅 savings-mix.json。

可用模型

共有 90 个模型，包括：gpt-6-astra [GPT-6 旗舰版，1M ctx]、gpt-6-sol、gpt-6.1-sol [焕新版 Sol]、gpt-6-luna [快速]、gpt-5.6-terra [均衡、稳定的默认选择]、gpt-5.6-sol [旗舰版]、gpt-5.6-luna [高性价比]、gpt-5.6-sol/terra/luna-pro [专业推理层级]、gpt-5.5、gpt-5.5-pro [最高计算量]、chat-latest [ChatGPT Instant]、gpt-5.4、gpt-5.1、gpt-4o、o3、claude-fable-5.1、claude-fable-5、claude-opus-5.5 [最新 Opus]、claude-opus-5 [1M ctx]、claude-opus-4.8、claude-opus-4.7、claude-opus-4.5、claude-sonnet-5.5、claude-sonnet-5、claude-sonnet-4.6、gemini-3.1-pro、gemini-3.6-flash、gemini-3.5-flash-lite、gemini-2.5-flash、deepseek-v4-pro、deepseek-chat、grok-4.7、grok-4.6、grok-4.5、grok-4.3、grok-build-0.1、glm-5.3 [Z.AI 旗舰版，1M ctx]、glm-5.3-flash [原生多模态，1M ctx]、glm-5.2、minimax-m3、kimi-k3 [旗舰版，1M ctx]、kimi-k2.7、qwen3.8-max [Qwen 3.8 旗舰版，1M ctx]、qwen3.7-max、qwen3.7-plus、qwen3.7-flash、mimo [Xiaomi MiMo-V2.5 Pro，1M ctx]、mistral-large-4 [Mistral 旗舰版，512K ctx，支持视觉]、hy4-preview [Tencent，770B MoE]、laguna-s-2.1 [Poolside，编码]，以及 7 个免费的开放权重模型（nemotron-3.5-lightning [1M ctx，思考模式——免费默认选择]、nemotron-3-ultra-550b [550B/55B MoE，1M ctx——最大的免费模型]、nemotron-3-nano-omni-30b-a3b-reasoning [256K ctx]、llama-3.2-11b-vision [Meta Llama]、north-mini-code [Cohere，编码，亚秒级]、laguna-xs-2.1 [Poolside，编码，约 161 tok/s]、muse-glimmer-30b [Meta Muse，推理]）。免费层级仅支持文本——包含图像的轮次会路由到付费视觉模型，因为目录中宣称支持视觉的两个免费模型，在两条链路上都无法通过纯色探测，尽管它们返回了 HTTP 200。

模型价格 — 实时查询

模型价格会变动（供应商会调整价格，促销也会结束），因此此技能不包含模型价格表。预算调用前，请先读取实时目录：

curl -s https://blockrun.ai/api/v1/models       # Base
curl -s https://sol.blockrun.ai/api/v1/models   # Solana

data[] 中的每个条目都包含 id、billing_mode 和 pricing 对象。所有金额均以 USD 计。

billing_mode	pricing 字段	单次调用的预估费用
paid（聊天）	每 1M 个 token 的 input、output；可选的每 1M 个 token 的 cache_read / cache_write；可选的 long_context	(input_tokens × input + output_tokens × output) / 1,000,000，最低 $0.001，另加 $0.001 交易费
free	input: 0、output: 0	$0 — 无需付款
per_image	per_image、transaction_fee	per_image × 图片数 + transaction_fee
per_second	per_second、per_call_surcharge、transaction_fee、default_duration_seconds	per_second × 秒数 + per_call_surcharge + transaction_fee
per_track	per_track、transaction_fee	per_track + transaction_fee
per_character	per_1k_chars、transaction_fee	per_1k_chars × 字符数 / 1,000 + transaction_fee
per_generation	per_generation、transaction_fee	per_generation + transaction_fee

• 缓存的提示词 token：当模型列出相应费率时，按 cache_read 计费，而非按 input 计费（缓存写入则按 cache_write 计费）。
• long_context 是一个分层列表。当提示词大于某个层级的 threshold（若 inclusive 为 true，则等于该值也算）时，该层级的 input / output / cache_* 费率将应用于整个请求。
• 图片尺寸／质量和视频分辨率可能会使媒体价格高于列出的基础费率。
• 上述金额为估算值。确切金额会在签署任何内容前通过 HTTP 402 挑战报价，因此调用结算金额绝不会高于报价。
• 易读的费率表：https://blockrun.ai/pricing

内置 Agent 工具

除了 LLM 路由之外，ClawRouter 还将 BlockRun 受 x402 门控的数据 API 封装为可直接使用的 OpenClaw 工具。所有工具都从同一个 USDC 钱包扣费 — 无需额外设置，也无需额外的 API 密钥。

市场数据

涵盖各类资产的实时价格和历史 OHLC 数据。Agent 应直接调用这些工具，而不是抓取财经网站。

工具	覆盖范围	价格
blockrun_stock_price	全球 12 个市场：美国（NYSE/Nasdaq）、香港、日本、韩国、英国、德国、法国、荷兰、爱尔兰、卢森堡、中国、加拿大	$0.001 / call
blockrun_stock_history	OHLC 数据栏，分辨率为 1/5/15/60/240 分钟或 D/W/M	$0.001 / call
blockrun_stock_list	按市场查询股票代码 / 搜索公司名称	免费
blockrun_crypto_price	BTC-USD、ETH-USD、SOL-USD 等	免费
blockrun_fx_price	EUR-USD、GBP-USD、JPY-USD 等	免费
blockrun_commodity_price	XAU-USD（黄金）、XAG-USD（白银）、XPT-USD（铂金）	免费

图像与视频生成

工具	用途	价格
blockrun_image_generation	12 种图像模型 — GPT Image 1/2/2.5（Flare、Sunburst）、Nano Banana / 2 / Pro、Seedream 5 Pro、Grok Imagine / 2.0 / Pro、CogView-4	按模型计价 — 请参阅模型价格
blockrun_image_edit	编辑 / 修复现有图像（GPT Image 1/2、2.5 Sunburst、Nano Banana；model 参数）	按模型计价 — 请参阅模型价格
blockrun_video_generation	Grok Imagine + ByteDance Seedance（1.5-pro / 2.0-fast / 2.0），支持 720p 分辨率和同步音频（默认 t2v），时长为 5–10 秒；+ 通过 Azure 提供的 OpenAI Sora 2（azure/sora-2，时长为 4/8/12 秒，支持 t2v + i2v，参考图像中不能包含人脸）。Seedance 按上游令牌计价（默认 720p+音频配置约为 20,256 个令牌/秒，是之前 480p 费率的 2 倍）；自 2026-06-01 起，image_url（图生视频）的费用与 t2v 相同。Seedance 2.0 变体可选用 real_face_asset_id（ta_…），以实现 BytePlus RealFace 角色一致性；此参数不能与 image_url 同时使用。	按模型计价 — 请参阅模型价格

电话与语音（Twilio + Bland.ai）

验证电话号码并发起 AI 外呼。会产生现实影响——仅当用户明确要求拨打电话时，才调用 blockrun_voice_call。服务端会强制执行紧急号码黑名单；ClawRouter 不会。

工具	用途	价格
blockrun_phone_lookup	查询任意 E.164 号码的运营商和线路类型（移动电话／固定电话／voip）	$0.01
blockrun_phone_lookup_fraud	SIM 卡交换和呼叫转移欺诈信号（在短信验证码流程前使用）	$0.05
blockrun_phone_numbers_buy	开通绑定到此钱包的美国／加拿大号码（租期 30 天）	$5.00
blockrun_phone_numbers_renew	将钱包所有号码的租期延长 30 天	$5.00
blockrun_phone_numbers_list	列出钱包当前拥有的号码及到期时间戳	$0.001
blockrun_phone_numbers_release	将钱包所有的号码释放回号码池	免费
blockrun_voice_call	通过 Bland.ai 发起 AI 外呼——最长 30 分钟，含转录文本和录音	$0.54 固定费用
blockrun_voice_status	查询通话状态／转录文本／录音	免费

语音通话采用发起后即返回的方式：POST 会立即返回 call_id 和 poll_url，通话本身在云端运行，最长 30 分钟。在通话状态为 in_progress 时，每隔 10–30s 轮询 blockrun_voice_status 以获取转录文本。斜杠命令：/cr-call +1<E.164> "<task>" [--voice nat] [--max-duration 5]。CLI：clawrouter phone numbers list/buy/renew/release 和 clawrouter phone lookup/fraud <+E.164>。完整的通话流程参考请见 phone 技能。

预测市场（Predexon）

涵盖 Polymarket、Kalshi、Limitless、Opinion、Predict.Fun、dFlow 以及用于加密货币 K 线的 Binance 的完整预测市场工具箱。57 个端点（Predexon v2）以 9 个 Agent 工具的形式开放（8 个具名便捷封装器 + 1 个万能工具）：

• 市场与交易——事件、各平台的市场列表、跨平台搜索（markets/search）、订单簿、K 线（按市场和按代币）、交易、持仓、成交量图表。
• 排行榜与聪明资金——全局和单市场排行榜、聪明资金持仓、顶级持有人、聪明资金活动动态。
• 钱包分析——完整钱包档案、盈亏时间序列、按市场细分、相似钱包发现、批量档案、AND/OR 筛选器。
• UMA 预言机与钱包身份——UMA 乐观预言机的结算状态（uma/markets、uma/market/{conditionId}）；钱包身份标签（ENS／Lens／交易所／风险标签）、批量身份查询、链上集群发现。 | 工具 | 覆盖范围 | 价格 | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | | blockrun_predexon_events | Polymarket 实时事件及当前赔率 | $0.001 / 次调用 | | blockrun_predexon_markets | 按关键词搜索 Polymarket 市场 | $0.001 / 次调用 | | blockrun_predexon_leaderboard | 按利润排名的 Polymarket 顶级交易者 | $0.001 / 次调用 | | blockrun_predexon_smart_money | 特定市场上的聪明资金持仓 | $0.005 / 次调用 | | blockrun_predexon_smart_activity | 聪明资金当前活跃的市场 | $0.005 / 次调用 | | blockrun_predexon_wallet | Polymarket 钱包资料（盈亏、胜率、持仓） | $0.005 / 次调用 | | blockrun_predexon_wallet_pnl | 钱包盈亏时间序列 | $0.005 / 次调用 | | blockrun_predexon_matching_markets | Polymarket ↔ Kalshi 市场配对（套利比较） | $0.005 / 次调用 | | blockrun_predexon_endpoint_call | 用于其余 49 个端点的通用工具——订单簿、K 线、顶级持仓者、UMA 预言机、钱包身份/集群、Kalshi/Limitless/Opinion/Predict.Fun、dFlow、Binance Futures、跨平台搜索、体育、规范市场。接受 path 和可选的 method/query/body。 | $0.001 / $0.005 / 次调用 |

定价：市场数据调用每次 $0.001，分析/搜索/钱包调用每次 $0.005。完整端点参考请参阅 predexon 技能。

预测市场交易（Polymarket）——真实资金

除了读取赔率，ClawRouter 还可以通过 blockrun_polymarket 工具在 Polymarket（CLOB V2，Polygon）上下注、管理并赎回真实投注。与此处的其他所有工具不同，它不是 HTTP 代理封装，而是运行本地交易引擎，使用支付大模型调用费用的同一个 ClawRouter 钱包对 CLOB 订单进行签名（EIP-712），并将订单提交至 Polymarket（默认通过 BlockRun 的东京出口，因此在受地理位置限制的地区也能开箱即用）。

工具	功能	费用
blockrun_polymarket	action: setup / fund / buy / sell / cancel / orders / positions / redeem / withdraw。一个多路复用工具。	工具免费；下注消耗 pUSD

• 资金：下注消耗通过你的密钥派生的 Polygon 无 gas 存款钱包金库中的 pUSD；action:"fund" 可免 gas 将你的 Base USDC → pUSD（x402，手续费 $0.01，非托管）。withdraw 可将奖金提回 Base 上的原生 USDC。
• 安全性：下单或签名必须设置 confirm:true（省略时会预览试运行结果）；每笔订单上限为 POLYMARKET_MAX_BET_USD（默认 $25），还可选设置 POLYMARKET_MAX_SESSION_USD。下注不会从 x402 API 预算中扣款。
• 零配置：无需 Polymarket 账户、API 密钥或 gas 代币——首次运行 setup 即可通过你的钱包完成所有初始化。请先使用 blockrun_predexon_* 数据工具查找代币 ID。关于黄金法则和端到端流程，请参阅 polymarket-trading 技能。

示例输出

[ClawRouter] google/gemini-2.5-flash (SIMPLE, rules, confidence=0.92)
             Cost: $0.0025 | Baseline: $0.308 | Saved: 99.2%