| name | clawrouter |
| description | 托管式网关大型语言模型(LLM)路由器:可节省高达67%的推理成本。该工具充当一个本地代理,将所有请求转发至blockrun.ai网关,网关会从OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA等平台提供的55种以上模型中选择成本最低且性能最佳的模型进行处理。此外,该工具还内置了8种免费的NVIDIA模型,并能够实时获取市场数据(全球股票、加密货币、外汇、大宗商品)、Twitter/X平台的智能信息以及Polymarket平台的预测数据。需要注意的是,该工具并非用于本地推理的工具——用户输入的提示语会直接发送到blockrun.ai网关进行处理。 |
| homepage | https://blockrun.ai/clawrouter.md |
| repository | https://github.com/BlockRunAI/ClawRouter |
| license | MIT |
| metadata | {"openclaw":{"emoji":"🦀","requires":{"config":["models.providers.blockrun"]},"install":[{"id":"node","kind":"node","package":"@blockrun/clawrouter","bins":["clawrouter"],"label":"Install ClawRouter (npm)"}]}} |
ClawRouter
这是一个托管式的LLM(大型语言模型)路由器,通过将每个请求转发到blockrun.ai网关来节省高达67%的推理成本。该网关会从9个提供商提供的55多个模型中选择最合适的模型来处理请求(其中包含8个免费的NVIDIA模型)。所有费用都通过一个USDC钱包进行结算;您无需持有提供商的API密钥。
**请注意:**ClawRouter并非一个用于本地推理的工具,而只是一个轻量级的本地代理。您的请求会通过HTTPS发送到blockrun.ai网关以执行相应的模型。如果您的任务需要在本机上进行推理(即不离开您的计算机),请使用像Ollama这样的本地运行时环境——ClawRouter并不适合这种使用场景。
**来源:**https://github.com/BlockRunAI/ClawRouter
**npm链接:**https://www.npmjs.com/package/@blockrun/clawrouter
**许可证:**MIT
数据流
每个请求都会发送到blockrun.ai的内容:
- 模型名称
- 完整的提示/消息内容
- 采样参数(如温度、最大字符数、使用的工具等)
- 一个包含签名后的x402格式USDC微支付的
X-PAYMENT头部
不会发送的内容:
- 您的钱包私钥(仅发送微支付的签名)
- 任何其他本地文件
- 环境变量
- 除当前请求所需之外的OpenClaw配置信息
Blockrun的隐私政策:
请像对待其他托管式LLM API(如OpenAI、Anthropic等)一样对待这些请求数据——不要发送您不会与第三方API提供商共享的信息。
凭据和本地密钥存储
ClawRouter不会收集或转发第三方提供商的API密钥。您无需提供OpenAI、Anthropic、Google、DeepSeek、xAI或NVIDIA的凭据——这些关系由blockrun.ai网关负责管理。
modelsProviders.blockrun存储的内容(详细列表):
| 字段 | 是否敏感 | 用途 |
|---|
walletKey | 是 | 用于通过x402协议签署USDC微支付的EVM私钥。首次运行时自动生成,无需用户输入。密钥不会通过网络传输;仅发送微支付的签名。 |
solanaKey | 是 | Solana密钥对(BIP-44格式)。通过@scure/bip32和@scure/bip39自动生成。 |
gateway | 否 | 网关地址。默认值:https://blockrun.ai/api(基础版本)/ https://sol.blockrun.ai/api(Solana版本)。 |
routing | 否 | 可选配置,用于覆盖默认的四层路由规则。 |
密钥的存储方式:
- 密钥存储在OpenClaw的用户配置文件中(通常位于Linux系统的
~/.config/openclaw/config.json、macOS系统的~/Library/Application Support/openclaw/config.json或Windows系统的%APPDATA%\openclaw\config.json文件中),位于modelsProviders.blockrun路径下。
- 使用OpenClaw的标准配置工具以
0600权限写入(仅允许所有者读写)。
- 以明文形式存储,与OpenClaw其他提供商的API密钥存储方式相同。ClawRouter不添加额外的加密层;您的文件系统权限决定了密钥的安全性。如果需要加密的密钥存储,请在加密的存储空间(如FileVault、LUKS、BitLocker)中运行OpenClaw,或使用仅用于存储交易资金的专用钱包。
- 密钥的生成使用
@scure/bip39生成24个单词的助记符,然后通过BIP-44格式进行派生(具体实现见src/wallet.ts文件)。
操作建议:
将钱包视为一个用于支付的小额资金的账户,而非长期价值存储工具。请根据您预期使用的LLM调用次数来为其充值。如果主机计算机被入侵,钱包密钥也会被泄露——此时应立即更换密钥并退款。
供应链完整性:**
安装方法
上述install块会指导OpenClaw安装可审计的npm包@blockrun/clawrouter。每个版本的源代码都托管在GitHub上,并且每个版本都会被标记。
设置方法
路由机制
ClawRouter将每个请求分为四个类别:
- 简单请求(占流量的40%):事实查询、问候语、翻译等——使用Gemini Flash模型(费用:0.60美元/次,节省99%的成本)
- 中等复杂度请求(占30%):摘要生成、解释、数据提取等——使用DeepSeek Chat模型(费用:0.42美元/次,节省99%的成本)
- 复杂请求(占20%):代码生成、多步骤分析等——使用Claude Opus模型(费用:75美元/次,提供最佳质量)
- 推理类请求(占10%):证明性任务、形式化逻辑、多步骤计算等——使用o3模型(费用:8美元/次,节省89%的成本)
大约80%的请求能在1毫秒内得到处理;只有模糊不清的查询才会被转发给LLM模型进行分类(每次分类的费用约为0.00003美元)。
可用模型:
共提供55个模型,包括:gpt-5.5、gpt-5.4、gpt-4o、o3、claude-opus-4.7、claude-opus-4.6、claude-sonnet-4.6、gemini-3.1-pro、gemini-2.5-flash、deepseek-chat、grok-3、kimi-k2.6、kimi-k2.5,以及10个免费的NVIDIA模型(gpt-oss-120b [默认模型]、gpt-oss-20b、mistral-small-4-119b、deepseek-v4-pro、deepseek-v4-flash、qwen3-next-80b-a3b-thinking、qwen3-coder-480b、glm-4.7、lama-4-maverick、nemotron-3-nano-omni-30b-a3b-reasoning [视觉任务模型])。
内置代理工具:
除了LLM路由功能外,ClawRouter还提供了BlockRun提供的x402协议接口,这些工具可以直接通过OpenClaw使用。所有这些工具的费用都从同一个USDC钱包中扣除,无需额外设置或API密钥。
市场数据服务:**
提供实时价格和历史价格数据(OHLC格式),涵盖所有资产类别。建议直接调用这些工具,无需手动从金融网站抓取数据:
| 工具 | 支持的资产类别 | 费用 |
|---|
blockrun_stock_price | 12个全球市场(纽约证券交易所/Nasdaq、香港、日本、韩国、英国、德国、法国、荷兰、爱尔兰、卢森堡、中国、加拿大) | 每次调用0.001美元 |
blockrun_stock_history | 提供1/5分钟、15分钟、60分钟、240分钟或每日/每周/每月的OHLC价格数据 | 每次调用0.001美元 |
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 | 8种图像生成模型(DALL-E 3、Nano Banana、Flux、Grok Imagine、CogView-4) | 每张图片0.015–0.15美元 |
blockrun_image_edit | 编辑/修改现有图片(基于OpenAI/GPT技术) | 每张图片0.02–0.04美元 |
blockrun_video_generation | 使用Grok Imagine和ByteDance的图像生成服务 | 每秒0.03–0.30美元 |
Polymarket(Predexon):**
提供完整的预测市场工具箱,包括实时事件、排行榜、市场搜索、智能资金定位、钱包分析以及跨市场套利功能(Polymarket与Kalshi平台对接)。8种工具,每次调用费用为0.001–0.005美元。具体工具详见blockrun_predexon_*系列。
示例输出结果:**
(此处应展示ClawRouter实际处理请求后的输出示例)