v0.12.66

Bug Fixes

Fix: payment settlement failure now falls back to free model

When payment settlement fails on-chain (insufficient funds, simulation failure), ClawRouter now skips all remaining paid models and falls back to nvidia/gpt-oss-120b (free). Previously, payment settlement errors returned non-standard HTTP codes that weren't recognized as provider errors, so the fallback loop broke immediately with "Payment settlement failed" — even though the free model was available.

Fix: pre-auth cache key includes model ID (v0.12.65)

Cached payment requirements from a paid model were incorrectly applied to free model requests.

npm install -g @blockrun/clawrouter@0.12.66

v0.12.65

Bug Fix

Fix: payment error when using free model — The pre-auth cache keyed on URL path alone, so cached payment requirements from a paid model (e.g. sonnet) would be applied to nvidia/gpt-oss-120b. Users switching to free model with an empty wallet got payment errors even though the server never charged for free requests. Cache key now includes model ID.

npm install -g @blockrun/clawrouter@0.12.65

v0.12.64

What's New

Cost Visibility & Routing Transparency

• Cost headers on every response: x-clawrouter-cost and x-clawrouter-savings show per-request cost and savings percentage
• SSE cost comment: Streaming responses include a cost summary before [DONE]
• Model field injection: SSE chunks and non-streaming responses now show the actual routed model (not the upstream provider's name)

Improved Error Handling

• Structured fallback error: When all models fail, error message lists every attempted model and failure reason: "All 6 models failed. Tried: gemini-2.5-flash (rate_limited), deepseek-chat (server_error), ..."

Model Allowlist Expansion

• Expanded to 33 models in the OpenClaw model picker allowlist

Code Quality

• Removed dead code (isProviderError function, FALLBACK_STATUS_CODES constant)
• Fixed Prettier formatting across 11 files
• Renamed blog docs to SEO-friendly slugs

Documentation

• New article: ClawRouter vs OpenRouter — LLM Routing Comparison (100 OpenClaw issues analyzed)

v0.12.56

• Add zai/glm-5 and zai/glm-5-turbo models to model picker
• Aliases: glm, glm-5, glm-5-turbo

v0.12.30

chore: bump version to 0.12.30

v0.12.25

• Image generation docs — new docs/image-generation.md with API reference, curl/TypeScript/Python/OpenAI SDK examples, model pricing table, and /imagegen command reference
• Comprehensive docs refresh — architecture updated for dual-chain (Base + Solana), configuration updated with all env vars (CLAWROUTER_SOLANA_RPC_URL, CLAWROUTER_WORKER), troubleshooting updated for USDC-on-Solana funding, CHANGELOG backfilled for v0.11.14–v0.12.24

v0.12.24

• Preserve user-defined blockrun/ allowlist entries* — injectModelsConfig() no longer removes user-added blockrun/* allowlist entries on gateway restarts

v0.12.10 — /stats clear

What's New

/stats clear — Reset usage statistics

Users can now wipe all local usage logs and start fresh:

• /stats clear (or /stats reset) — deletes all usage-*.jsonl log files and confirms how many were removed
• DELETE /stats HTTP endpoint — programmatic access for the same operation, returns { cleared: true, deletedFiles: N }

These are local usage tracking files only — billing records on BlockRun's server are unaffected.

Use cases

• Clean metrics after testing
• Fresh start for a new billing period
• Benchmark a new routing config without old data

Install / Update

openclaw plugins install @blockrun/clawrouter

v0.12.9

Fix: Gemini 3 models break tool calling (#73)

• Removed toolCalling from google/gemini-3-flash-preview — this model returns empty responses on tool calls, so it's now excluded from tool-heavy routing entirely
• Added google/gemini-3-pro-preview and google/gemini-3.1-pro to TOOL_NONCOMPLIANT_MODELS — these models return tool JSON as plain text instead of structured tool_calls, so they're deprioritized when better alternatives exist in the fallback chain

v0.12.8 — GPT-5.4 & GPT-5.4 Pro

New Models

• GPT-5.4 (openai/gpt-5.4) — $2.50/$15 per 1M tokens, 400K context, reasoning + vision + agentic + tool calling
• GPT-5.4 Pro (openai/gpt-5.4-pro) — $30/$180 per 1M tokens, 400K context, reasoning + tool calling

Aliases

• gpt5 now points to openai/gpt-5.4 (was 5.2)
• New: gpt-5.4, gpt-5.4-pro

Smart Router Updates

• Auto COMPLEX: GPT-5.4 replaces GPT-5.2 as fallback (newer, same price tier)
• Premium COMPLEX: GPT-5.4 added as fallback option
• Agentic COMPLEX: GPT-5.4 replaces GPT-5.2 as fallback

GPT-5.4 Pro ($30/$180) is not in routing tiers — request it explicitly via blockrun/openai/gpt-5.4-pro.

Update

bash ~/.openclaw/extensions/clawrouter/scripts/update.sh