clawrouter

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":"[Truncated]"},"install":["[Truncated]"]}}

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调用次数来为其充值。如果主机计算机被入侵，钱包密钥也会被泄露——此时应立即更换密钥并退款。

供应链完整性：**

• 每个版本都会在GitHub上标记：https://github.com/BlockRunAI/ClawRouter/releases
• 每个版本都会发布到npm仓库：https://www.npmjs.com/package/@blockrun/clawrouter?activeTab=versions
• skills/release/SKILL.md文件中的检查清单确保package.json、GitHub仓库标签和npm发布版本的一致性。
• 可以通过npm pack @blockrun/clawrouter@<version>命令在本地验证版本信息，并将生成的tarball文件与GitHub上的标签信息进行对比。

安装方法

上述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实际处理请求后的输出示例）