KLAW Router

K-104 Intelligent Model Router. Route AI queries to the cheapest model that can handle them. Up to 48x cheaper than Claude Opus — without sacrificing quality.

Install

Install from this repo (not yet on PyPI): `cd openclaw && pip install -e .`

Quick Start

from klaw import KlawRouter

router = KlawRouter()
result = router.route("How do I center a div?")

print(result["response"])    # The answer
print(result["cost"])        # $0.0001
print(result["savings"])     # $0.0029 saved vs Sonnet baseline
print(result["tier_name"])   # "template" (free)

Pass API keys directly or via environment variables:

router = KlawRouter(api_keys={
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "OPENAI_API_KEY": "sk-...",
    "GEMINI_API_KEY": "AI...",
})

How It Works

Every query gets classified into a K-104 semantic address (4 domains × 13 ranks × 2 polarities = 104 rooms) and routed to the minimum capable model:

The classifier routes ~80% of everyday queries to tier 0–1 (free). Only genuinely complex reasoning reaches premium tiers.

Empirical result: Transformer activations cluster by K-104 suit with silhouette score 0.312 — the geometry is real, not imposed.

Claude Code MCP Integration

Add to your .mcp.json:

{
  "mcpServers": {
    "klaw": {
      "command": "klaw",
      "args": ["mcp"]
    }
  }
}

Then use klaw_route, klaw_classify, and klaw_stats tools in Claude Code.

CLI

klaw route "What is Python?"
klaw classify "Explain quantum physics"
klaw stats
klaw demo
klaw setup

API Keys

Set via environment variables:

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=AI...
export OPENROUTER_API_KEY=sk-or-...

Or pass directly to KlawRouter(api_keys={...}). No keys required for tier 0 template routing.

Classify Only

from klaw import KlawRouter

r = KlawRouter()
c = r.classify("debug this async Python function")
print(c["suit"])       # "spades"
print(c["tier"])       # 2
print(c["k_address"])  # "+5S"

Testing

cd openclaw
pip install pytest
python -m pytest tests/ -v

All 10 tests pass without API keys (template tier is free).

License

MIT