---

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

---

# 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.

---

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

---

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

---

41+ models across 7 providers, one wallet:

Click to expand full model list

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.

---

Smart Routing in Action

Telegram Integration

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

---

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

---

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

---

	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 →

---

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

---

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

---

Channel	Link
📅 Schedule Demo	calendly.com/vickyfu9/30min
💬 Community Telegram	t.me/blockrunAI
🐦 X / Twitter	x.com/BlockRunAI
📱 Founder Telegram	@bc1max
✉️ Email	vicky@blockrun.ai

---

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

---