# ClawRouter

> The agent-native LLM router for OpenClaw. 41+ models, <1ms routing, USDC payments on Base & Solana via x402.

- **URL**: https://www.freshcrate.ai/projects/ClawRouter
- **Author**: BlockRunAI
- **Category**: AI Agents
- **Latest version**: `v0.12.196` (2026-05-24)
- **License**: MIT
- **Source**: https://github.com/BlockRunAI/ClawRouter
- **Language**: TypeScript
- **GitHub**: 6,212 stars, 544 forks
- **Registry**: github
- **Tags**: `ai`, `ai-agents`, `anthropic`, `cost-optimization`, `deepseek`, `gemini`, `llm`, `llm-router`, `typescript`

## Description

The agent-native LLM router for OpenClaw. 41+ models, <1ms routing, USDC payments on Base & Solana via x402.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.12.196` | 2026-05-24 | High | - **Updater recovers from OpenClaw size-drop rejection.** OpenClaw v2026.4.5+ refuses to write a config that would shrink the file by a large amount (data-loss guard). Users on a pre-v0.12.175 install carry ~175 entries in `models.providers.blockrun.models`; upgrading to a current ClawRouter legitimately trims that to ~38 (≈90 KB → 25 KB), tripping OpenClaw's guard. The updater previously surfaced this as a hard failure and rolled back, stranding users on the old version. Fix in `scripts/update |
| `v0.12.194` | 2026-05-18 | High | ## v0.12.194 — May 18, 2026  - **Seedance video pricing aligned with blockrun's token-priced model.** Last week blockrun replaced the flat per-second Seedance pricing with `duration × tokens/sec × $/1M tokens × 1.05 margin` after a verification call against `bytedance/seedance-2.0-fast` measured 10,128 tokens/sec at 480p (token360's default, not the 720p we'd guessed). The old ClawRouter `VIDEO_PRICING` table was both wrong-shaped and ~3–4× off on the high side. Updated `src/proxy.ts`:   - `VIDE |
| `v0.12.190` | 2026-05-13 | High | ## Fix  Renames the `/imagegen` slash command to `/cr-imagegen` to resolve a collision with Telegram channel commands.  OpenClaw runtime previously emitted:  ``` Plugin command "/imagegen" conflicts with an existing Telegram command ```  because Telegram channels reserve `/imagegen` for their own image-gen bots (HuggingFace Spaces et al.). The OpenClaw command registry can't claim the same prefix without inconsistent routing behavior in Telegram.  ## What changed  - `src/index.ts:1768` — `api.re |
| `v0.12.185` | 2026-05-04 | High | ## v0.12.185 — May 4, 2026  - **`clawrouter setup` — new CLI command for users who installed via bare `npm install -g`.** A user reported `/models` in their Telegram bot showing only 7 entries despite having `@blockrun/clawrouter@0.12.184` installed and the gateway restarted. Investigation: bare `npm install -g @blockrun/clawrouter` puts the package on disk and adds the `clawrouter` binary to PATH but performs **zero** OpenClaw integration — no `plugins.entries.clawrouter` registration, no model |
| `v0.12.171` | 2026-04-30 | High | ## v0.12.171 — Apr 29, 2026  - **Three new free NVIDIA-hosted models added.** BlockRun refreshed the free catalog on 2026-04-29 with three additions, all wired into ClawRouter as `free/`-prefixed entries:   - `free/deepseek-v4-pro` — 1.6T MoE / 49B active, 1M context, MMLU-Pro 87.5, GPQA 90.1, SWE-bench 80.6, LiveCodeBench 93.5. NIM ~150 tok/s on Blackwell. Strongest free reasoning model.   - `free/deepseek-v4-flash` — 284B / 13B active MoE, 1M context, ~5x faster than v4-pro. Strong on chat/sum |
| `v0.12.161` | 2026-04-22 | High | - **De-Gemini the Anthropic-primary fallback chains.** When Anthropic hiccups (503s, capacity), Gemini's own "high demand" 503s correlate with the same events — agents fall back from Claude to Gemini together, both overloaded. Reordered `src/router/config.ts` fallback arrays in the two places Anthropic sits primary: `premiumTiers.COMPLEX` (claude-opus-4.7 primary) and `agenticTiers.COMPLEX` (claude-sonnet-4.6 primary). New order: in-family Anthropic hot swap (opus-4.6 / sonnet-4.6) → xAI Grok ( |
| `v0.12.159` | 2026-04-21 | High | - **Market data tools** — BlockRun gateway now exposes realtime and historical market data; ClawRouter wires them into OpenClaw as 6 first-class agent tools so the model stops scraping finance sites. Paid ($0.001 via x402, same wallet as LLM calls): `blockrun_stock_price` and `blockrun_stock_history` across **12 global equity markets** (US, HK, JP, KR, UK, DE, FR, NL, IE, LU, CN, CA). Free (no x402 charge): `blockrun_stock_list` (ticker lookup / company-name search), `blockrun_crypto_price` (BT |
| `v0.12.158` | 2026-04-20 | High | - **SKILL.md data-flow + key-storage transparency** — second-pass fix for the OpenClaw scanner on clawhub.ai. v0.12.157 cleared the original scanner flags (opaque credentials, implied multi-provider keys, no install artifact). A deeper rescan surfaced three new nuanced flags: prompts go to blockrun.ai (data-privacy framing), wallet private-key storage location/encryption undocumented, and users may expect strictly-local routing. All three addressed: description reframed as "Hosted-gateway LLM ro |
| `v0.12.157` | 2026-04-20 | High | - **SKILL.md credential transparency** — rewrote `skills/clawrouter/SKILL.md` to clear the OpenClaw scanner's medium-confidence suspicious verdict on clawhub.ai. Frontmatter now declares `repository: https://github.com/BlockRunAI/ClawRouter`, `license: MIT`, and a structured `metadata.openclaw.install` array (`kind: node`, `package: @blockrun/clawrouter`, `bins: [clawrouter]`) so the registry entry has an auditable install artifact instead of a bare bash block. Body adds a **Credentials & Data H |
| `v0.12.156` | 2026-04-20 | High | ## v0.12.156 — Apr 20, 2026  - **Kimi K2.6 added** — Moonshot's new flagship (`moonshot/kimi-k2.6`, 256K context, vision + reasoning, $0.95 in / $4.00 out per 1M) registered in `BLOCKRUN_MODELS` with `kimi-k2.6` alias. Added to the curated `/model` picker list (`src/index.ts`, `scripts/update.sh`, `scripts/reinstall.sh`), the README pricing table, `docs/routing-profiles.md`, and the AI-agent-facing model catalog in `skills/clawrouter/SKILL.md`. Premium routing tier (`blockrun/premium`) now uses |

## Citation

- HTML: https://www.freshcrate.ai/projects/ClawRouter
- Markdown: https://www.freshcrate.ai/projects/ClawRouter.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ClawRouter/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._