# ClawRouter

> An open-source, agent-native LLM router that reduces AI API costs by up to 92% using 15-dimension local routing, wallet-based auth, and USDC micropayments via the x402 protocol.

ClawRouter is an open-source (MIT licensed) smart LLM router built specifically for autonomous AI agents. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally — no external API calls needed for routing decisions. Unlike other routers that require accounts, API keys, and credit cards, ClawRouter uses wallet signatures for authentication and USDC micropayments via the x402 protocol, enabling agents to operate fully independently. With 55+ models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more, and 10 NVIDIA-hosted models available completely free, ClawRouter delivers a blended average cost of $2.05/M tokens versus $25/M for Claude Opus — a 92% savings.

- **Agent-native authentication** — wallet signatures replace API keys; agents sign transactions instead of managing credentials
- **15-dimension local routing** — every request is scored across 15 dimensions in under 1ms with zero external API calls, automatically selecting the cheapest capable model
- **10 free models** — NVIDIA-hosted models including DeepSeek V4, Qwen3, and Nemotron Omni are permanently free with no signup required
- **USDC micropayments via x402** — pay per-request with USDC on Base (EVM) or Solana; non-custodial, price visible before signing
- **55+ models across 9 providers** — OpenAI, Anthropic, Google, xAI, DeepSeek, MiniMax, Moonshot, Zhipu, and NVIDIA all accessible through one wallet
- **Routing profiles** — choose `/model free`, `/model auto`, `/model eco`, or `/model premium` to balance cost and quality
- **Image & video generation** — built-in `/imagegen`, `/videogen`, and `/img2img` commands supporting DALL-E 3, Flux, Grok Imagine, Seedance, and more
- **OpenAI-compatible proxy** — runs locally on port 8402; works with continue.dev, Cursor, VS Code extensions, ElizaOS, and any OpenAI SDK client
- **OpenClaw plugin** — installs as a plugin for the OpenClaw AI coding agent with slash commands and usage reports
- **AI-powered diagnostics** — `npx @blockrun/clawrouter doctor` collects system info and sends to Claude Sonnet for analysis
- **Model exclusions** — block specific models from routing with `/exclude add <model>`, persisted across restarts
- **Dual-chain wallet** — Base (EVM) and Solana wallets derived from a single BIP-39 mnemonic, with `/wallet` commands for balance, export, and recovery

## Features
- 15-dimension local LLM routing in under 1ms
- 10 permanently free NVIDIA-hosted models
- Wallet-based authentication (no API keys)
- USDC micropayments via x402 protocol on Base and Solana
- 55+ models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more
- Routing profiles: free, auto, eco, premium
- Image generation with /imagegen (DALL-E 3, Flux, Grok Imagine, etc.)
- Video generation with /videogen (Seedance, Grok Imagine Video)
- Image editing with /img2img
- OpenAI-compatible local proxy on port 8402
- OpenClaw plugin integration
- AI-powered diagnostics via doctor command
- Model exclusion list with persistence
- Dual-chain wallet (Base EVM + Solana) from single BIP-39 mnemonic
- 92% cost savings vs Claude Opus blended average

## Integrations
OpenAI, Anthropic, Google Gemini, xAI Grok, DeepSeek, NVIDIA, MiniMax, Moonshot (Kimi), Zhipu (ZAI), continue.dev, Cursor, VS Code, ElizaOS, OpenClaw, Base (EVM), Solana, x402 protocol, DALL-E 3, Flux, ByteDance Seedance

## Platforms
WEB, API, VSC_EXTENSION, CLI

## Pricing
Open Source, Free tier available

## Version
v0.12.171

## Links
- Website: https://github.com/BlockRunAI/ClawRouter
- Documentation: https://blockrun.ai/docs
- Repository: https://github.com/BlockRunAI/ClawRouter
- EveryDev.ai: https://www.everydev.ai/tools/clawrouter
