v0.12.70

Fixed

• Plugin crash on string model config — ClawRouter crashed during OpenClaw plugin registration with TypeError: Cannot create property 'primary' on string 'blockrun/auto'. This happened when agents.defaults.model in the OpenClaw config was a plain string instead of the expected object { primary: "blockrun/auto" }. Now auto-converts string/array/non-object model values to the correct object form.

Install / Update

npm i -g @blockrun/clawrouter@latest

v0.12.69

What's Changed

✨ Features

• feat: add GPT-5.4 Nano + Gemini 3.1 Flash Lite, SOL→USDC swap hint
• feat: GEO optimize README with definition and FAQ section

🐛 Bug Fixes

• fix: config duplication on update — full model allowlist reconciliation (#112)
• fix: /stats under-reporting costs — use actual x402 payment amounts
• fix: save npm install error log to ~/clawrouter-npm-install.log
• fix: remove redundant deprecated models list from reinstall step 2
• fix: sync package-lock.json (missing opusscript after viem merge)
• fix: lint errors — unused import and no-useless-assignment

📚 Documentation

• docs: add illustrations to OpenRouter comparison article

🔧 Maintenance

• chore(deps): bump viem from 2.46.3 to 2.47.6 (#115)
• style: fix prettier formatting

Full Changelog: v0.12.66...v0.12.69

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