@blockrun/clawrouter
Advanced tools
Smart LLM router โ save 92% on inference costs. 41+ models, one wallet, x402 micropayments.
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.
| 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 |
API Docs: Image Generation & Editing ยท Architecture ยท Configuration
# 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.
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
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.
Edit existing images with /img2img โ pass a local file and describe what to change:
/img2img --image ~/photo.png change the background to a starry sky
/img2img --image ./cat.jpg --mask ./mask.png remove the background
/img2img --image /tmp/portrait.png --size 1536x1024 add a hat
| Option | Required | Description |
|---|---|---|
--image <path> | Yes | Local image file path (supports ~/) |
--mask <path> | No | Mask image (white = area to edit) |
--model <model> | No | Model to use (default: gpt-image-1) |
--size <WxH> | No | Output size (default: 1024x1024) |
Supported model: gpt-image-1 (OpenAI GPT Image 1, $0.02/image).
API endpoint: POST http://localhost:8402/v1/images/image2image โ accepts local file paths, URLs, or base64 data URIs:
curl -X POST http://localhost:8402/v1/images/image2image \
-H "Content-Type: application/json" \
-d '{"prompt":"add sunglasses","image":"~/photo.png"}'
See Image Generation & Editing docs for full API reference and code examples.
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:
| 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.
Smart Routing in Action
|
Telegram Integration
|
The flow:
~/.openclaw/blockrun/wallet.keyNo 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:
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
| 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 |
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
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 |
| Image Generation & Editing | API examples, 5 models |
| 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!
FAQs
Smart LLM router โ save 92% on inference costs. 41+ models, one wallet, x402 micropayments.
The npm package @blockrun/clawrouter receives a total of 2,323 weekly downloads. As such, @blockrun/clawrouter popularity was classified as popular.
We found that @blockrun/clawrouter demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.ย It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Since January 31, 2026, we identified at least 72 additional malicious Open VSX extensions, including transitive GlassWorm loader extensions targeting developers.
Research
Six malicious Packagist packages posing as OphimCMS themes contain trojanized jQuery that exfiltrates URLs, injects ads, and loads FUNNULL-linked redirects.
Security News
The GCVE initiative operated by CIRCL has officially opened its publishing ecosystem, letting organizations issue and share vulnerability identifiers without routing through a central authority.