smart-router

# OpenClaw Smart Router

**Save 30-50% on model costs through intelligent, automatic model selection.**

## What is it?

The first OpenClaw skill that **automatically routes requests to optimal models** based on complexity analysis and budget constraints. Stops you from wasting money on expensive models for simple tasks. Learns from your usage patterns and gets smarter over time.

## Key Features

- 🎯 **30-50% Cost Savings** - Automatic model selection based on task complexity
- 🧠 **Complexity Analysis** - Scores tasks 0.0-1.0 and selects appropriate model
- 💰 **Budget Awareness** - Respects spending limits and cost targets
- 📊 **Pattern Learning** - Learns which models work best for your tasks
- 🔄 **Multi-Provider** - Works with Anthropic, OpenAI, Google, and more
- 💸 **x402 Payments** - Agents can pay for unlimited routing (0.5 USDT/month)

## Free vs Pro Tier

**Free Tier:**
- 100 routing decisions per day
- Automatic complexity analysis
- Basic model selection
- Cost tracking

**Pro Tier (0.5 USDT/month):**
- Unlimited routing decisions
- Advanced pattern learning
- Custom routing rules
- Detailed analytics and ROI tracking
- Budget optimization

## Installation

```bash
claw skill install openclaw-smart-router
```

## Commands

```bash
# View routing stats
claw router stats

# Analyze complexity
claw router analyze "Your task description..."

# View routing history
claw router history --limit=10

# Show cost savings
claw router savings

# Open dashboard
claw router dashboard

# Subscribe to Pro
claw router subscribe
```

## How It Works

1. **Intercepts requests** - Hooks before each API call
2. **Analyzes complexity** - Scores task from 0.0 (simple) to 1.0 (expert)
3. **Checks budget** - Considers spending limits
4. **Selects model** - Chooses optimal model:
   - Simple (0.0-0.3) → Haiku/GPT-3.5
   - Medium (0.3-0.6) → Sonnet/GPT-4-Turbo
   - Complex (0.6-0.8) → Opus/GPT-4
   - Expert (...

# OpenClaw Smart Router

**Save 30-50% on model costs through intelligent, automatic model selection.**

Stop wasting money on expensive models for simple tasks. Smart Router automatically analyzes request complexity and routes to the optimal model - using Claude Opus for complex reasoning, Haiku for simple queries, and everything in between. It learns from your usage patterns and gets smarter over time.

🤖 **Agent-powered economy** - agents can autonomously pay 0.5 USDT/month for unlimited routing decisions. [Agent Payments →](AGENT-PAYMENTS.md)

## The Problem

OpenClaw users are experiencing:
- 💸 **Wasted money** - using expensive models for trivial tasks
- 🎯 **Manual selection** - constantly choosing models yourself
- 📊 **No learning** - same mistakes repeated every session
- 🤔 **Guesswork** - "Is this complex enough for Opus?"
- 💰 **Unpredictable costs** - no budget awareness

## The Solution

**Intelligent model routing that analyzes complexity and automatically selects the optimal model for each task.**

## Features

- ✅ **Automatic Model Selection** - No more manual model switching
- ✅ **Complexity Analysis** - Scores requests 0.0-1.0 for difficulty
- ✅ **Budget Awareness** - Respects spending limits and cost targets
- ✅ **Pattern Learning** - Adapts to your workflow over time
- ✅ **Multi-Provider Support** - Works with Anthropic, OpenAI, Google, and more
- ✅ **30-50% Cost Savings** - Proven reduction in model costs
- ✅ **Quota Management** - Free tier (100 decisions/day) + Pro tier (unlimited)
- ✅ **Web Dashboard** - Visualize routing decisions and savings
- ✅ **CLI Interface** - Full control from command line
- 🤖 **x402 Agent Payments** - Agents can autonomously pay for Pro tier (0.5 USDT/month)

## Why Smart Router?

**The ONLY OpenClaw tool that automatically routes to optimal models based on complexity and budget.**

| Feature | Smart Router | Manual Selection | Model Switching Tools | Simple Fallbac...