v0.10.1 - AI-Powered Doctor

🩺 New Feature: blockrun doctor

AI-powered diagnostics when things go wrong. Collects system info and sends to Claude Opus 4.6 for analysis.

Usage

# Run automatic diagnostics
npx @blockrun/clawrouter doctor

# Ask a specific question
npx @blockrun/clawrouter doctor "why is my request failing?"

What it checks

• System: OS, Node version, memory
• Wallet: Key exists, balance, low balance warning
• Network: BlockRun API reachability, local proxy status
• Logs: Recent requests, errors

Example Output

🩺 BlockRun Doctor v0.10.1

🔍 Collecting diagnostics...

System
  ✓ OS: darwin arm64
  ✓ Node: v22.14.0
  ✓ Memory: 0.8GB free / 16.0GB

Wallet
  ✓ Address: 0x1234...abcd
  ⚠ Balance: $0.89 (low)

Network
  ✓ BlockRun API: reachable (156ms)
  ✗ Local proxy: not running on :8402

📤 Sending to Claude Opus 4.6...

🤖 AI Analysis:
[AI provides specific fix commands based on your diagnostics]

Notes

• Works independently of OpenClaw (direct x402 payment to BlockRun API)
• If wallet is empty, prompts user to fund before AI analysis
• Supports questions in any language

Install

npm install -g @blockrun/clawrouter@0.10.1

v0.10.0 - Full OpenClaw 2026.2.21 Alignment

ClawRouter v0.10.0 - Full OpenClaw 2026.2.21 Alignment

Release Date: 2026-02-21

---

🎉 Highlights

• ✅ Claude 4.6 - Using newest Sonnet 4.6 and Opus 4.6 models
• ✅ Gemini 3.1 Pro Preview - Newest Gemini model now available
• ✅ Gemini 2.5 Flash Lite - #2 most popular model on OpenRouter (16.8% of traffic!)
• ✅ 7 New Models - Total now 41 models (was 34)
• ✅ 67% Cheaper ECO Tier - Flash Lite dramatically reduces costs
• ✅ Fixed 5 Pricing Errors - 15-30% better routing decisions
• ✅ 100% OpenClaw Compatible - Fully aligned with OpenClaw 2026.2.21

---

📊 Model Count: 34 → 41 Models (+7)

New Models Added

Model	Price (Input/Output per 1M tokens)	Significance
google/gemini-3.1-pro-preview	$2.00 / $12.00	Newest Gemini with advanced reasoning
google/gemini-3-flash-preview	$0.50 / $3.00	#5 on OpenRouter (6.2% of traffic)
google/gemini-2.5-flash-lite	$0.10 / $0.40	#2 on OpenRouter (16.8% of traffic!)
openai/o1	$15.00 / $60.00	Advanced reasoning model
openai/o1-mini	$1.10 / $4.40	Cost-effective reasoning
openai/gpt-4.1-nano	$0.10 / $0.40	Ultra-cheap GPT-4 class model
xai/grok-2-vision	$2.00 / $10.00	Vision-capable Grok model

---

🔧 Major Fixes

1. Claude Model Version Alignment

Before:

• Used bare claude-sonnet-4 (unclear which version)
• Used claude-opus-4 (4 or 4.5?)

After:

• anthropic/claude-sonnet-4.6 with full provider prefix
• anthropic/claude-opus-4.6 with full provider prefix
• All aliases map to newest 4.6 versions

Impact: Users automatically get the newest, best Claude models.

---

2. Critical Pricing Fixes (5 Models)

Model	Wrong Price	Correct Price	Impact
Gemini 2.5 Flash	$0.15/$0.60	$0.30/$2.50	Router thought it was cheapest, actually 2x more
Kimi K2.5	$0.50/$2.40	$0.60/$3.00	Picked Kimi over cheaper alternatives
GPT-5.2 Codex	$2.50/$12	$1.75/$14	Avoided Codex incorrectly (cheaper input!)
DeepSeek Chat	$0.14/$0.28	$0.28/$0.42	Wrong docs pricing
DeepSeek Reasoner	$0.55/$2.19	$0.28/$0.42	Wrong docs pricing

Example:

• Before: ECO mode → picks Gemini Flash ($0.30) thinking it's $0.15
• After: ECO mode → picks Flash Lite ($0.10) correctly
• Savings: 67% better decision!

Impact: 15-30% cost reduction from better routing decisions.

---

🚀 Routing Optimizations

ECO Tier Dramatic Improvement

Before:

• MEDIUM: Gemini Flash ($0.30/$2.50)
• COMPLEX: Gemini Flash ($0.30/$2.50)

After:

• MEDIUM: Gemini Flash Lite ($0.10/$0.40) - 67% cheaper on input!
• COMPLEX: Gemini Flash Lite ($0.10/$0.40) - 84% cheaper on output!

ECO vs AUTO Savings (Recalculated)

Tier	ECO Cost	AUTO Cost	Savings
SIMPLE	FREE	$3.60	100%
MEDIUM	$0.50	$1.70	71% (was 0%!)
COMPLEX	$0.50	$14.00	96% (was 80%!)
REASONING	$0.70	$0.70	0%

AUTO Tier Updated

• COMPLEX: Now uses gemini-3.1-pro-preview (newest Gemini)
• Fallbacks: All tiers now use flash-lite instead of flash for cheaper failsafe

Premium & Agentic Tiers

• Include Gemini 3.1 Pro Preview in fallback chains for better quality

---

📝 Files Changed

1. src/models.ts

   • Added 7 new models
   • Updated Claude models to 4.6 with full provider prefix
   • Fixed pricing for 5 models
   • Updated aliases to map to newest versions

2. src/router/config.ts

   • ECO tier: Now uses gemini-2.5-flash-lite for MEDIUM/COMPLEX
   • AUTO tier: Uses gemini-3.1-pro-preview for COMPLEX
   • All fallback chains: Replaced flash with flash-lite where appropriate
   • Updated all Claude model references to 4.6

3. README.md

   • Updated model count: 30+ → 41
   • Updated pricing table with 7 new models
   • Updated routing table with new pricing
   • Updated badges (38+ → 41 models)

4. docs/routing-profiles.md

   • Updated all pricing tables
   • Recalculated ECO vs AUTO savings (now 71% and 96%!)
   • Updated tier recommendations

5. package.json

   • Version: 0.9.39 → 0.10.0
   • Description: 30+ → 41 models, 78% → 92% savings

---

✅ Test Results

✓ 207 tests passed
✓ 10 test files
✓ Build successful
✓ All model aliases resolving correctly
✓ Routing tiers selecting correct models

---

🔗 OpenClaw 2026.2.21 Compatibility

ClawRouter v0.10.0 is fully compatible with OpenClaw's massive v2026.2.21 release:

• ✅ Works seamlessly with Gemini 3.1 support
• ✅ Compatible with Discord voice channels
• ✅ Works with thread-bound subagent sessions
• ✅ Benefits from 100+ security fixes
• ✅ Supports improved prompt caching
• ✅ No breaking changes

---

📦 Installation

New Installation

npm install -g @blockrun/clawrouter@latest
openclaw gateway restart

Upgrading from v0.9.x

npm install -g @blockrun/clawrouter@latest
openclaw gateway restart

No action required - all changes are backward compatible!

---

🎯 Migration Guide

What Changes Automatically

• /model claude → Now maps to anthropic/claude-sonnet-4.6 (newest)
• /model opus → Now maps to anthropic/claude-opus-4.6 (newest)
• /model eco → Now uses Flash Lite (67% cheaper!)
• Old model IDs still work (e.g., claude-sonnet-4 auto-upgrades to 4.6)

What You Get

• Better routing: 15-30% cost savings from accurate pricing
• Newest models: Always get the latest Claude 4.6 versions
• Cheaper ECO: 67% reduction in ECO tier costs
• More choices: 7 new models including #2 most popular on OpenRouter

---

🙏 Credits

Discovery: User testing proved Gemini 3.1 was available when initial API check missed it!

Community: Thanks to OpenRouter for popularity data showing Flash Lite is the #2 most requested model

---

🔗 Links

• npm: https://www.npmjs.com/package/@blockrun/clawrouter
• GitHub: https://github.com/BlockRunAI/ClawRouter
• OpenClaw: https://openclaw.ai
• Telegram: https://t.me/blockrunAI

---

📊 Success Metrics (Track for 7 days)

Metric	Baseline	Target
GitHub Stars	~150	300+
npm Downloads	~500/month	2,000/month
OpenClaw Plugin Installs	~200	1,000+
Average Cost per Request	Unknown	15-30% lower
User-reported routing errors	Unknown	0

---

Generated: 2026-02-21
All changes verified against BlockRun API
All 207 tests passing ✅

v0.9.39

Features

• Context Usage Headers: Added x-context-used-kb and x-context-limit-kb response headers to help track token/context usage per request

Fixes

• Model Selection: Fixed issue where ClawRouter was hijacking user model selection, forcing blockrun/auto even when users explicitly selected other providers (#14)

Improvements

• Auto Routing: Removed Minimax models from auto/eco/agentic fallback chains as they don't support tool calling. Users can still explicitly select minimax models when needed

Install

npm install -g @blockrun/clawrouter@0.9.39

v0.9.28

What's Changed

Fixes

• Restore dashed Claude baseline ID for correct baseline/savings calculations (cbad791).
• Add regression tests for Claude legacy dot-version aliases (cbad791).
• Add automatic fallback when upstream returns degraded HTTP 200 responses (overload placeholders / looped garbage output) (044ad2a).

Validation

• npm test (204 passed)
• npm run build

Package

• Published @blockrun/clawrouter@0.9.28 to npm.