Route every request to the right model at the right price. 15-dimension scoring, <1ms local routing, optimized for autonomous agents. One wallet, 41+ models, zero API keys.

📑 Quick Navigation

| Section | Description | | ----------------------------------------- | ------------------------------- | | Quick Start | Install in 2 minutes | | Routing Profiles | eco / auto / premium / free | | How It Works | 15-dimension local routing | | Models & Pricing | 41+ models, full price list | | Screenshots | See it in action | | Payment | x402 non-custodial USDC | | Configuration | Environment variables | | Troubleshooting | doctor AI-powered diagnostics | | vs OpenRouter | Why ClawRouter wins | | Support | Telegram, X, founders |

🚀 Quick Start

# 1. Install with smart routing enabled
curl -fsSL https://blockrun.ai/ClawRouter-update | bash
openclaw gateway restart

# 2. Fund your wallet with USDC on Base (address printed on install)
# $5 is enough for thousands of requests

Done! Smart routing (blockrun/auto) is now your default model.

🎯 Routing Profiles

Choose your routing strategy with /model <profile>:

| Profile | Strategy | Savings | Best For | | ---------------- | ------------------ | ------- | ---------------- | | /model auto | Balanced (default) | 74-100% | General use | | /model eco | Cheapest possible | 95-100% | Maximum savings | | /model premium | Best quality | 0% | Mission-critical | | /model free | Free tier only | 100% | Zero cost |

Shortcuts: /model grok, /model br-sonnet, /model gpt5, /model o3

⚡ How It Works

100% local routing. <1ms latency. Zero external API calls.

Request → Weighted Scorer (15 dimensions) → Tier → Cheapest Model → Response

| Tier | ECO Model | AUTO Model | PREMIUM Model | | --------- | ----------------------------------- | ---------------------------- | ---------------------------- | | SIMPLE | nvidia/gpt-oss-120b (FREE) | 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) |

Blended average: $2.05/M vs $25/M for Claude Opus = 92% savings

💰 Models & Pricing

41+ models across 7 providers, one wallet:

| Model | Input $/M | Output $/M | Context | Reasoning | | ----------------------- | --------- | ---------- | ------- | :-------: | | 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 | FREE | FREE | 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 | | | Google | | | | | | 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 | * |

Free tier: gpt-oss-120b costs nothing and serves as automatic fallback when wallet is empty.

📸 Screenshots

The flow:

1. Wallet auto-generated on Base (L2) — saved at ~/.openclaw/blockrun/wallet.key
2. Fund with $1 USDC — enough for hundreds of requests
3. Request any model — ClawRouter picks the cheapest capable one
4. Pay per request — non-custodial, you hold your keys

💳 Payment

No account. No API key. Payment IS authentication via x402.

Request → 402 (price: $0.003) → wallet signs USDC → retry → response

USDC stays in your wallet until spent — non-custodial. Price is visible in the 402 header before signing.

/wallet     # Check balance and address
/stats      # View usage and savings

Fund your wallet:

• Coinbase: Buy USDC, send to Base
• Bridge: Move USDC from any chain to Base
• CEX: Withdraw USDC to Base network

⚙️ Configuration

For basic usage, no configuration needed. For advanced options:

| Variable | Default | Description | | --------------------- | -------------- | ----------------------- | | BLOCKRUN_WALLET_KEY | auto-generated | Your wallet private key | | BLOCKRUN_PROXY_PORT | 8402 | Local proxy port | | CLAWROUTER_DISABLED | false | Disable smart routing |

Full reference: docs/configuration.md

🥊 vs OpenRouter

| | OpenRouter / LiteLLM | ClawRouter | | --------------- | --------------------------- | -------------------------------- | | Setup | Human creates account | Agent generates wallet | | Auth | API key (shared secret) | Wallet signature (cryptographic) | | Payment | Prepaid balance (custodial) | Per-request (non-custodial) | | Routing | Proprietary / closed | Open source, client-side | | Rate limits | Per-key quotas | None (your wallet, your limits) | | Cost | $25/M (Opus equivalent) | $2.05/M blended average |

Full comparison →

🩺 Troubleshooting

When things go wrong, run the doctor:

npx @blockrun/clawrouter doctor

This collects diagnostics and sends them to Claude Sonnet for AI-powered analysis:

🩺 BlockRun Doctor v0.10.4

System
  ✓ OS: darwin arm64
  ✓ Node: v20.11.0

Wallet
  ✓ Address: 0x1234...abcd
  ✓ Balance: $12.50

Network
  ✓ BlockRun API: reachable (142ms)
  ✗ Local proxy: not running on :8402

📤 Sending to Claude Sonnet 4.6 (~$0.003)...

🤖 AI Analysis:
The local proxy isn't running. Run `openclaw gateway restart` to fix.

Use Opus for complex issues:

npx @blockrun/clawrouter doctor opus

Ask a specific question:

npx @blockrun/clawrouter doctor "why is my request failing?"
npx @blockrun/clawrouter doctor opus "深度分析我的配置"

Cost: Sonnet ~$0.003 (default) | Opus ~$0.01

🛠 Development

git clone https://github.com/BlockRunAI/ClawRouter.git
cd ClawRouter
npm install
npm run build
npm test

📞 Support

| Channel | Link | | --------------------- | ------------------------------------------------------------------ | | 📅 Schedule Demo | calendly.com/vickyfu9/30min | | 💬 Community Telegram | t.me/blockrunAI | | 🐦 X / Twitter | x.com/BlockRunAI | | 📱 Founder Telegram | @bc1max | | ✉️ Email | [email protected] |

📚 More Resources

| Resource | Description | | -------------------------------------------- | ------------------------ | | Documentation | Full docs | | Model Pricing | All models & prices | | Routing Profiles | ECO/AUTO/PREMIUM details | | Architecture | Technical deep dive | | Configuration | Environment variables | | vs OpenRouter | Why ClawRouter wins | | Features | All features | | Troubleshooting | Common issues |

MIT License · BlockRun — Pay-per-request AI infrastructure

⭐ If ClawRouter saves you money, consider starring the repo!