The agent-native LLM router for OpenClaw

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
Image Generation	/imagegen with 5 models
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 or Solana (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

---

🎨 Image Generation

Generate images directly from chat with /imagegen:

/imagegen a dog dancing on the beach
/imagegen --model dall-e-3 a futuristic city at sunset
/imagegen --model banana-pro --size 2048x2048 mountain landscape

Model	Provider	Price	Max Size
nano-banana	Google Gemini Flash	$0.05/image	1024x1024
banana-pro	Google Gemini Pro	$0.10/image	4096x4096
dall-e-3	OpenAI DALL-E 3	$0.04/image	1792x1024
gpt-image	OpenAI GPT Image 1	$0.02/image	1536x1024
flux	Black Forest Flux 1.1	$0.04/image	1024x1024

Default model: nano-banana. Images are returned as hosted URLs for compatibility with Telegram, Discord, and other clients.

---

⚡ 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:

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.6	$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	$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

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

---

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

Dual-chain support: Pay with USDC on Base (EVM) or Solana. Both wallets are derived from a single BIP-39 mnemonic on first run. Existing EVM-only users can enable Solana with /wallet setup-solana.

/wallet              # Check balance and address (both chains)
/wallet export       # Export keys and mnemonic for backup
/wallet solana       # Enable Solana payments / switch to Solana
/wallet base         # Switch back to Base (EVM)
/stats               # View usage and savings

Fund your wallet:

• Base (EVM): Send USDC on Base to your EVM address
• Solana: Send USDC on Solana to your Solana address
• Coinbase/CEX: Withdraw USDC to either network
• Credit card: Don't have USDC? Reach out to @bc1max on Telegram — we accept credit card payments

---

⚙️ 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
CLAWROUTER_SOLANA_RPC_URL	https://api.mainnet-beta.solana.com	Solana RPC endpoint

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	vicky@blockrun.ai

---

📚 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!