| 章节 | 描述 |
|---|---|
| 快速开始 | 2分钟完成安装 |
| 路由配置 | eco / auto / premium / free |
| 工作原理 | 15维本地路由 |
| 模型与定价 | 41+ 模型,完整价格表 |
| 截图展示 | 实际运行效果 |
| 支付方式 | x402 非托管 USDC |
| 配置说明 | 环境变量 |
| 故障排除 | doctor AI 智能诊断 |
| 对比 OpenRouter | ClawRouter 的优势 |
| 支持渠道 | Telegram, X, 创始人联系方式 |
# 1. 安装并启用智能路由
curl -fsSL https://blockrun.ai/ClawRouter-update | bash
openclaw gateway restart
# 2. 使用 Base 网络上的 USDC 为钱包充值(安装时会显示地址)
# $5 足够使用数千次请求
完成!智能路由 (blockrun/auto) 现在是您的默认模型。
使用 /model <profile> 选择您的路由策略:
| 配置 | 策略 | 节省 | 适用场景 |
|---|---|---|---|
/model auto | 均衡(默认) | 74-100% | 通用场景 |
/model eco | 最便宜优先 | 95-100% | 最大化节省 |
/model premium | 最佳质量 | 0% | 关键任务 |
/model free | 仅免费层级 | 100% | 零成本 |
快捷指令: /model grok, /model br-sonnet, /model gpt5, /model o3
100% 本地路由。<1ms 延迟。零外部 API 调用。
请求 → 加权评分器(15 维度)→ 层级 → 最便宜模型 → 响应
| 层级 | ECO 模型 | AUTO 模型 | PREMIUM 模型 |
|---|---|---|---|
| SIMPLE | nvidia/gpt-oss-120b (免费) | kimi-k2.5 ($0.60/$3.00) | kimi-k2.5 |
| MEDIUM | gemini-2.5-flash-lite ($0.10/$0.40) | grok-code-fast ($0.20/$1.50) | gpt-5.2-codex ($1.75/$14.00) |
| COMPLEX | gemini-2.5-flash-lite ($0.10/$0.40) | gemini-3.1-pro ($2/$12) | claude-opus-4.6 ($5/$25) |
| REASONING | grok-4-fast ($0.20/$0.50) | grok-4-fast ($0.20/$0.50) | claude-sonnet-4.6 ($3/$15) |
混合平均:$2.05/M vs Claude Opus $25/M = 92% 节省
7 家提供商,41+ 模型,仅需一个钱包:
| 模型 | 输入 $/M | 输出 $/M | 上下文 | 推理能力 |
|---|---|---|---|---|
| OpenAI | ||||
| gpt-5.2 | $1.75 | $14.00 | 400K | * |
| gpt-4o | $2.50 | $10.00 | 128K | |
| gpt-4o-mini | $0.15 | $0.60 | 128K | |
| gpt-oss-120b | 免费 | 免费 | 128K | |
| o1 | $15.00 | $60.00 | 200K | * |
| o1-mini | $1.10 | $4.40 | 128K | * |
| o3 | $2.00 | $8.00 | 200K | * |
| o4-mini | $1.10 | $4.40 | 128K | * |
| Anthropic | ||||
| claude-opus-4.5 | $5.00 | $25.00 | 200K | * |
| claude-sonnet-4.6 | $3.00 | $15.00 | 200K | * |
| claude-haiku-4.5 | $1.00 | $5.00 | 200K | |
| gemini-3.1-pro-preview | $2.00 | $12.00 | 1M | * |
| gemini-3-pro-preview | $2.00 | $12.00 | 1M | * |
| gemini-3-flash-preview | $0.50 | $3.00 | 1M | |
| gemini-2.5-pro | $1.25 | $10.00 | 1M | * |
| gemini-2.5-flash | $0.30 | $2.50 | 1M | |
| gemini-2.5-flash-lite | $0.10 | $0.40 | 1M | |
| DeepSeek | ||||
| deepseek-chat | $0.28 | $0.42 | 128K | |
| deepseek-reasoner | $0.28 | $0.42 | 128K | * |
| xAI | ||||
| grok-4-0709 | $0.20 | $1.50 | 131K | * |
| grok-4-1-fast-reasoning | $0.20 | $0.50 | 131K | * |
| grok-code-fast-1 | $0.20 | $1.50 | 131K | |
| Moonshot | ||||
| kimi-k2.5 | $0.60 | $3.00 | 262K | * |
| MiniMax | ||||
| minimax-m2.5 | $0.30 | $1.20 | 205K | * |
免费层:
gpt-oss-120b完全免费,当钱包为空时自动作为备用选项。
智能路由实际效果
|
Telegram 集成
|
使用流程:
~/.openclaw/blockrun/wallet.key无需账户。无需 API 密钥。支付即认证 通过 x402。
请求 → 402 (价格: $0.003) → 钱包签名 USDC → 重试 → 响应
USDC 保留在您的钱包中直到消费 — 非托管。价格在签名前的 402 响应头中可见。
/wallet # 查看余额和地址
/stats # 查看使用量和节省
为钱包充值:
基本使用无需配置。高级选项:
| 变量 | 默认值 | 描述 |
|---|---|---|
BLOCKRUN_WALLET_KEY | 自动生成 | 钱包私钥 |
BLOCKRUN_PROXY_PORT | 8402 | 本地代理端口 |
CLAWROUTER_DISABLED | false | 禁用智能路由 |
完整参考: docs/configuration.md
| OpenRouter / LiteLLM | ClawRouter | |
|---|---|---|
| 设置 | 人工创建账户 | 智能体自动生成钱包 |
| 认证 | API 密钥(共享密钥) | 钱包签名(加密) |
| 支付 | 预付余额(托管) | 按请求付费(非托管) |
| 路由 | 专有/封闭 | 开源,客户端 |
| 速率限制 | 按密钥配额 | 无(您的钱包,您的限制) |
| 成本 | $25/M (Opus 等效) | $2.05/M 混合平均 |
出现问题时,运行 doctor 命令:
npx @blockrun/clawrouter doctor
这将收集诊断信息并发送给 Claude Sonnet 进行 AI 分析:
🩺 BlockRun Doctor v0.10.4 系统 ✓ 操作系统: darwin arm64 ✓ Node: v20.11.0 钱包 ✓ 地址: 0x1234...abcd ✓ 余额: $12.50 网络 ✓ BlockRun API: 可访问 (142ms) ✗ 本地代理: 未在 :8402 运行 📤 发送给 Claude Sonnet 4.6 (~$0.003)... 🤖 AI 分析: 本地代理未运行。运行 `openclaw gateway restart` 修复。
复杂问题使用 Opus:
npx @blockrun/clawrouter doctor opus
提出具体问题:
npx @blockrun/clawrouter doctor "为什么我的请求失败?"
npx @blockrun/clawrouter doctor opus "深度分析我的配置"
费用: Sonnet ~$0.003 (默认) | Opus ~$0.01
git clone https://github.com/BlockRunAI/ClawRouter.git
cd ClawRouter
npm install
npm run build
npm test
| 渠道 | 链接 |
|---|---|
| 📅 预约演示 | calendly.com/vickyfu9/30min |
| 💬 Telegram 社区 | t.me/blockrunAI |
| 🐦 X / Twitter | x.com/BlockRunAI |
| 📱 创始人 Telegram | @bc1max |
| ✉️ 邮箱 | vicky@blockrun.ai |
| 资源 | 描述 |
|---|---|
| 文档 | 完整文档 |
| 模型定价 | 所有模型和价格 |
| 路由配置 | ECO/AUTO/PREMIUM 详情 |
| 架构设计 | 技术深度解析 |
| 配置说明 | 环境变量 |
| 对比 OpenRouter | ClawRouter 的优势 |
| 功能特性 | 所有功能 |
| 故障排除 | 常见问题 |
MIT 许可证 · BlockRun — 按请求付费的 AI 基础设施
⭐ 如果 ClawRouter 为您节省了费用,请考虑给仓库点星!