basezh 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:
| 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 | |
| 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-120bcosts nothing and serves as automatic fallback when wallet is empty.
📸 Screenshots
The flow:
- Wallet auto-generated on Base (L2) — saved at
~/.openclaw/blockrun/wallet.key - Fund with $1 USDC — enough for hundreds of requests
- Request any model — ClawRouter picks the cheapest capable one
- 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 USDC on Solana — no SOL token accepted. Both wallets are derived from a single BIP-39 mnemonic on first run.
/wallet # Check balance and address (both chains)
/wallet export # Export mnemonic + keys for backup
/wallet recover # Restore wallet from mnemonic on a new machine
/wallet solana # Switch to Solana USDC payments
/wallet base # Switch back to Base (EVM) USDC payments
/chain solana # Alias for /wallet solana
/stats # View usage and savings
/stats clear # Reset usage statistics
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.12.24
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!