ClawRouter

Save 78% on LLM costs. Automatically.

ClawRouter is a smart LLM router for OpenClaw that routes every request to the cheapest model that can handle it. One wallet, 30+ models, zero API keys.

Overview

ClawRouter analyzes your prompt and automatically picks the right model tier:

• Simple questions → Cheap models (DeepSeek, Gemini Flash)
• Medium complexity → Balanced models (GPT-4o-mini, Claude Haiku)
• Complex reasoning → Premium models (Claude Opus, GPT-5)
• Code generation → Specialized models (Claude Sonnet, DeepSeek Coder)

Result: 78% average cost savings with no quality loss.

Quick Start

Installation (2 minutes)

# 1. Install ClawRouter
curl -fsSL https://raw.githubusercontent.com/BlockRunAI/ClawRouter/main/scripts/reinstall.sh | bash

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

# 3. Restart OpenClaw
openclaw gateway restart

Enable Smart Routing

In any OpenClaw conversation:

/model blockrun/auto

ClawRouter will now automatically route all requests to the optimal model.

How It Works

14-Dimension Scoring

ClawRouter uses a multi-factor scoring system that runs locally in <1ms:

1. Prompt complexity - Length, structure, nested reasoning
2. Task type - Code, math, creative writing, analysis
3. Context requirements - How much context the model needs
4. Quality needs - When only the best model will do
5. Cost constraints - Always pick the cheapest capable model
6. Speed requirements - Fast models for simple tasks
7. And 8 more factors...

All routing decisions happen on your machine. No external API calls.

4-Tier Model Selection

Prices shown are output costs per 1M tokens (after 5% BlockRun markup)

Smart Routing Examples

Features

100% Local Routing

• 14-dimension weighted scoring runs on your machine in <1ms
• No external API calls for routing decisions
• Full privacy - your prompts never leave your machine for routing

30+ Models

Access all major providers through one wallet:

• OpenAI: GPT-4o, GPT-5, o1, o3
• Anthropic: Claude Opus 4, Sonnet 4, Haiku 4.5
• Google: Gemini 3 Pro, Gemini 2.5 Pro/Flash
• DeepSeek: DeepSeek V3, DeepSeek Reasoner
• xAI: Grok 3, Grok 4 (2M context)
• Moonshot: Kimi K2.5
• NVIDIA: GPT-OSS 120B (FREE)

View all models →

x402 Micropayments

• Pay per request with USDC on Base
• Non-custodial - you control your wallet
• No API keys needed
• No subscriptions or prepaid credits

Open Source

• MIT licensed
• Fully inspectable routing logic
• No black boxes
• View on GitHub →

Usage

Basic Usage

Once installed and enabled with /model blockrun/auto, ClawRouter works automatically:

You: Explain quantum computing in simple terms

ClawRouter: [Routes to gemini-2.5-flash - $0.60/M]
Response: Quantum computing uses quantum mechanics...

Manual Model Selection

You can still override routing for specific requests:

/model openai/gpt-4o

View Routing Decision

ClawRouter logs show which model was selected and why:

[ClawRouter] Prompt complexity: LOW → Tier: SIMPLE → Model: gemini-2.5-flash
[ClawRouter] Cost: $0.0003 (saved $0.0125 vs. Claude Opus)

Why ClawRouter?

vs. OpenRouter / LiteLLM

ClawRouter is built for AI agents, not developers.

• No account creation needed
• No API keys to manage
• Agents can fund their own wallets
• Cryptographic authentication (no shared secrets)

Cost Comparison

Without ClawRouter

Using Claude Opus 4 for everything:

100 requests × 1000 tokens = 100K tokens
100K / 1M × $75 = $7.50

With ClawRouter

Smart routing to appropriate models:

70 simple requests → DeepSeek ($0.42/M) = $0.03
20 medium requests → Claude Haiku ($5.00/M) = $0.10
10 complex requests → Claude Opus ($75.00/M) = $0.75

Total: $0.88 (saved $6.62 = 88% savings)

Supported Models

ClawRouter has access to all models available through BlockRun Intelligence:

Chat Models

• OpenAI GPT-5 Family: GPT-5.2, GPT-5 Mini, GPT-5 Nano
• OpenAI GPT-4 Family: GPT-4.1, GPT-4o, GPT-4o-mini
• OpenAI O-Series: o1, o3, o3-mini, o4-mini
• Anthropic Claude: Opus 4/4.5, Sonnet 4, Haiku 4.5
• Google Gemini: 3 Pro, 2.5 Pro, 2.5 Flash
• DeepSeek: V3 Chat, V3 Reasoner
• xAI Grok: Grok 3, Grok 4 (2M context), Grok Mini
• Moonshot: Kimi K2.5 (1M context)
• NVIDIA Free: GPT-OSS 120B, GPT-OSS 20B

Image Generation

• DALL-E 3
• Nano Banana
• Flux 1.1 Pro

View full pricing →

SDK Integration

Use ClawRouter's smart routing directly in your code with the smart_chat() method:

Python SDK

from blockrun_llm import LLMClient

client = LLMClient()

# Auto-route to optimal model
result = client.smart_chat("What is 2+2?")
print(result.response)        # "4"
print(result.model)           # "deepseek/deepseek-chat"
print(result.routing.tier)    # "SIMPLE"
print(result.routing.savings) # 0.94 (94% savings)

# Use routing profiles
result = client.smart_chat("Complex reasoning task...", routing_profile="premium")

Python SDK Documentation

TypeScript SDK

import { LLMClient } from '@blockrun/llm';

const client = new LLMClient({ privateKey: '0x...' });

// Auto-route to optimal model
const result = await client.smartChat('What is 2+2?');
console.log(result.response);        // "4"
console.log(result.model);           // "deepseek/deepseek-chat"
console.log(result.routing.tier);    // "SIMPLE"
console.log(result.routing.savings); // 0.94

// Use routing profiles
const result2 = await client.smartChat('Complex reasoning task...', {
  routingProfile: 'premium'
});

TypeScript SDK Documentation

XRPL SDK (RLUSD)

from blockrun_llm_xrpl import LLMClient

client = LLMClient()  # Uses BLOCKRUN_XRPL_SEED

# Smart routing works the same on XRPL
result = client.smart_chat("Prove that sqrt(2) is irrational")
print(result.model)  # "xai/grok-4-1-fast-reasoning"
print(result.routing.tier)  # "REASONING"

XRPL SDK Documentation

Routing Profiles

All SDKs support the same routing profiles:

Configuration

Environment Variables

ClawRouter reads your wallet configuration from OpenClaw:

# Set in OpenClaw settings
BASE_CHAIN_WALLET_KEY=0x...

Advanced Settings

Edit ~/.openclaw/clawrouter.config.json:

{
  "costWeight": 0.7,        // How much to prioritize cost (0-1)
  "qualityWeight": 0.3,     // How much to prioritize quality (0-1)
  "enableFreeModels": true, // Use NVIDIA free models when appropriate
  "maxCostPerRequest": 0.10 // Maximum cost per request in USD
}

Troubleshooting

ClawRouter not routing

Check installation:

openclaw gateway status

Should show:

✓ ClawRouter plugin loaded
✓ Connected to BlockRun Intelligence
✓ Wallet: 0x123...789 (funded)

Wrong model selected

View routing logs:

tail -f ~/.openclaw/logs/clawrouter.log

High costs

Check your settings:

openclaw gateway config show

Adjust cost weight:

openclaw gateway config set costWeight 0.9

FAQ

Do I need API keys?

No. ClawRouter uses x402 micropayments with USDC on Base. Just fund your wallet.

How much should I fund my wallet?

$5 USDC is enough for thousands of requests. Average request costs $0.001-0.01.

Can I use specific models?

Yes. Use /model <model-id> to override smart routing for specific requests.

Is my data sent to BlockRun?

Only your prompts are sent to the AI provider you're routed to. Routing decisions happen locally.

Can I see the routing algorithm?

Yes. ClawRouter is fully open source under MIT license.

Does it work offline?

No. AI model access requires internet. But routing decisions are made locally.

Next Steps

• View All Models
• Check Pricing
• Setup Wallet
• View on GitHub

Support

• GitHub Issues: Report a bug
• Telegram: Join community
• Documentation: BlockRun Docs