From dadad788fb1522cc4e1a18b5375881eb12774a05 Mon Sep 17 00:00:00 2001 From: 1bcMax Date: Wed, 5 Aug 2026 09:02:36 -0500 Subject: [PATCH] =?UTF-8?q?chore(brand):=20refresh=20the=20snapshot=20?= =?UTF-8?q?=E2=80=94=20the=20markers=20were=20rendering=20a=20stale=20cata?= =?UTF-8?q?log?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit brand-numbers.json here was a catalog generation behind, so every br: marker in this repo rendered a number that has not been true for some time. The markers did their job — they rendered the input they were given. Nothing refreshes that input: sync-brand-numbers.mjs reads the local snapshot and only re-fetches under --refresh, and --check is offline on purpose so PR CI stays deterministic. Its header defers freshness to a fan-out job that was never built, so every consumer validated markers against its own stale copy and reported green. Produced by --refresh, not by hand. --- CLAUDE.md | 2 +- README.md | 16 ++++++++-------- brand-numbers.json | 16 ++++++++-------- docs/anthropic-cost-savings.md | 2 +- docs/anthropic-third-party-harness-changes.md | 4 ++-- docs/clawrouter-cuts-llm-api-costs-500x.md | 2 +- ...outer-vs-openrouter-llm-routing-comparison.md | 6 +++--- ...router-benchmark-46-models-sub-1ms-routing.md | 4 ++-- docs/plans/2026-02-03-smart-routing-design.md | 2 +- docs/smart-llm-router-14-dimension-classifier.md | 8 ++++---- skills/xclawrouter/SKILL.md | 4 ++-- 11 files changed, 33 insertions(+), 33 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index f4047ec..1ba7470 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ # XClawRouter -Smart LLM router for autonomous agents. 66 models. Wallet-based auth. USDC micropayments via x402. +Smart LLM router for autonomous agents. 71 models. Wallet-based auth. USDC micropayments via x402. ## Commands diff --git a/README.md b/README.md index b75b04a..06f8ba4 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@

Agents can't sign up for accounts. Agents can't enter credit cards.
Agents can only sign transactions.

ClawRouter is the only LLM router that lets agents operate independently.

-8 models free, no crypto required. No signup. No API key. No credit card.

+6 models free, no crypto required. No signup. No API key. No credit card.


@@ -34,7 +34,7 @@ Agents can only sign transactions.

-> **ClawRouter** is an open-source smart LLM router that reduces AI API costs by 87%. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. ClawRouter is the only LLM router built for autonomous AI agents — it uses wallet signatures for authentication (no API keys) and USDC micropayments via the x402 protocol (no credit cards). 66 models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed. +> **ClawRouter** is an open-source smart LLM router that reduces AI API costs by 87%. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. ClawRouter is the only LLM router built for autonomous AI agents — it uses wallet signatures for authentication (no API keys) and USDC micropayments via the x402 protocol (no credit cards). 71 models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed. --- @@ -62,7 +62,7 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r | | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** | | ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ---------------------------------------------------------------------- | | **Models** | 200+ | 100+ | Smart routing | Gateway | **60+** | -| **Free tier** | Rate-limited | BYO keys | No | No | **8 models, no signup** | +| **Free tier** | Rate-limited | BYO keys | No | No | **6 models, no signup** | | **Routing** | Manual selection | Manual selection | Smart (closed) | Observability | **Smart (open source)** | | **Auth** | Account + API key | Your API keys | Account + API key | Account + API key | **Wallet signature** | | **Payment** | Credit card | BYO keys | Credit card | $49-499/mo | **USDC per-request** | @@ -78,7 +78,7 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r ## Quick Start -> **No wallet? 8 models work free out of the box.** Install, run, and pin `free/gpt-oss-120b` (or any of the 7) — no crypto, no signup, no balance required. Add USDC later when you want paid models. +> **No wallet? 6 models work free out of the box.** Install, run, and pin `free/gpt-oss-120b` (or any of the 7) — no crypto, no signup, no balance required. Add USDC later when you want paid models. ### Option A — OpenClaw Agent @@ -297,7 +297,7 @@ Edit existing images with `/img2img`: ## Models & Pricing -66 models across 9 providers, one wallet. **Starting at $0.0002/request.** +71 models across 9 providers, one wallet. **Starting at $0.0002/request.** > **💡 "Cost per request"** = estimated cost for a typical chat message (~500 input + 500 output tokens). @@ -382,7 +382,7 @@ Edit existing images with `/img2img`: | openai/gpt-5.2-pro | $21.00 | $168.00 | $0.0945 | 400K | reasoning, tools | | openai/gpt-5.4-pro | $30.00 | $180.00 | $0.1050 | 400K | reasoning, tools | -> **Free tier:** 8 models cost nothing — `/model free` points to gpt-oss-120b, or pick any free model directly (e.g., `/model nemotron-omni` for vision, `/model qwen-coder` for coding, `/model deepseek-v4-flash` for reasoning + 1M context, `/model maverick` for general chat). +> **Free tier:** 6 models cost nothing — `/model free` points to gpt-oss-120b, or pick any free model directly (e.g., `/model nemotron-omni` for vision, `/model qwen-coder` for coding, `/model deepseek-v4-flash` for reasoning + 1M context, `/model maverick` for general chat). > **Best value:** `gpt-5-nano` and `gemini-2.5-flash-lite` deliver strong results at ~$0.0003/request. --- @@ -552,7 +552,7 @@ npm test **The LLM router built for autonomous agents** -You're here. 66 models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently. +You're here. 71 models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently. `curl -fsSL https://blockrun.ai/XClawRouter-update | bash` @@ -563,7 +563,7 @@ You're here. 66 mod **BlockRun for Claude Code** -Run Claude Code with 66 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. +Run Claude Code with 71 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. `curl -fsSL https://blockrun.ai/brcc-install | bash` diff --git a/brand-numbers.json b/brand-numbers.json index 312505d..70a5380 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,17 +2,17 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 66, - "totalVisible": 86, - "free": 8, - "freeWithheld": 17, - "image": 8, + "chatVisible": 71, + "totalVisible": 92, + "free": 6, + "freeWithheld": 19, + "image": 9, "video": 5, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 44, - "withFallbackAllEntries": 75 + "withFallback": 46, + "withFallbackAllEntries": 79 }, "clawrouter": { "dimensions": 15, @@ -21,7 +21,7 @@ "aliases": 202 }, "mcp": { - "tools": 19 + "tools": 20 }, "chains": { "rpc": 40 diff --git a/docs/anthropic-cost-savings.md b/docs/anthropic-cost-savings.md index dad2f0b..8eec707 100644 --- a/docs/anthropic-cost-savings.md +++ b/docs/anthropic-cost-savings.md @@ -50,7 +50,7 @@ This is where you're paying for real value: ## The Solution: ClawRouter -[ClawRouter](https://github.com/BlockRunAI/XClawRouter) is an open-source local proxy that sits between your app and 66 AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**. +[ClawRouter](https://github.com/BlockRunAI/XClawRouter) is an open-source local proxy that sits between your app and 71 AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**. ``` ┌─────────────┐ ┌──────────────────────────────┐ ┌──────────────────┐ diff --git a/docs/anthropic-third-party-harness-changes.md b/docs/anthropic-third-party-harness-changes.md index b22c421..67bcdd2 100644 --- a/docs/anthropic-third-party-harness-changes.md +++ b/docs/anthropic-third-party-harness-changes.md @@ -31,7 +31,7 @@ This is exactly the problem [XClawRouter](https://github.com/BlockRunAI/XClawRou ## XClawRouter: Smart Routing for Agents -XClawRouter is an open-source local proxy that sits between your agent and 66 LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally. +XClawRouter is an open-source local proxy that sits between your agent and 71 LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally. ``` Your Agent → XClawRouter (localhost:8402) → Best model for the job @@ -74,7 +74,7 @@ Then point your agent at `http://localhost:8402/v1/` with any OpenAI-compatible - **No API keys to manage** — wallet-based cryptographic auth - **No subscriptions** — pay per request in USDC (Base or Solana) -- **No vendor lock-in** — 66 models, switch anytime +- **No vendor lock-in** — 71 models, switch anytime - **You control your wallet** — non-custodial, funds never held by a third party - **Budget caps** — set a max spend per session, XClawRouter gracefully downgrades when budget runs low - **Token compression** — 7-layer pipeline reduces token costs by 7–40% before they hit any provider diff --git a/docs/clawrouter-cuts-llm-api-costs-500x.md b/docs/clawrouter-cuts-llm-api-costs-500x.md index 990c975..7d1ee29 100644 --- a/docs/clawrouter-cuts-llm-api-costs-500x.md +++ b/docs/clawrouter-cuts-llm-api-costs-500x.md @@ -135,7 +135,7 @@ Less context repeated = fewer tokens = lower cost. Agents that need to recall ea ### 7. x402 Micropayments — Wallet-Based Budget Control -

Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly

+

Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly

XClawRouter pays for inference via [x402](https://x402.org/) USDC micropayments (Base or Solana). You load a wallet. Each inference call costs exactly what it costs. When the wallet runs low, requests stop cleanly. diff --git a/docs/clawrouter-vs-openrouter-llm-routing-comparison.md b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md index bc09c9d..aa1aa59 100644 --- a/docs/clawrouter-vs-openrouter-llm-routing-comparison.md +++ b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md @@ -222,7 +222,7 @@ OpenRouter doesn't always pass through provider-specific features correctly. Ima **Direct provider routing.** XClawRouter routes through BlockRun's API directly to providers — not through a second aggregator. One hop, not two. Provider-specific features work because there's no middleman translating them. -![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated 66 models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png) +![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated 71 models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png) --- @@ -240,7 +240,7 @@ When new models launch, OpenRouter's catalog lags. Users configure a model that ### How XClawRouter Solves This -XClawRouter maintains a curated catalog of 66 models across 9 providers (including 11 free models), updated with each release. Delisted models have automatic redirect aliases: +XClawRouter maintains a curated catalog of 71 models across 9 providers (including 11 free models), updated with each release. Delisted models have automatic redirect aliases: ```typescript // Delisted models redirect automatically @@ -268,7 +268,7 @@ No silent drops. No stale catalog. Models are benchmarked for speed, quality, an | **Rate limits** | Per-key, shared | Per-wallet, independent | | **Vision support** | Images sometimes dropped | Auto-detected, vision-only fallback | | **Tool calling** | Silent failures with some models | Flag-based filtering, guaranteed support | -| **Model catalog** | Laggy, silent drops | Curated 66 models, redirect aliases | +| **Model catalog** | Laggy, silent drops | Curated 71 models, redirect aliases | | **Budget control** | Monthly invoice | Per-session cap (`maxCostPerRun`) | | **Setup** | Create account, paste key | Agent generates wallet, auto-configured | | **Average cost** | $25/M tokens (Opus direct) | auto-routed = **87% savings** | diff --git a/docs/llm-router-benchmark-46-models-sub-1ms-routing.md b/docs/llm-router-benchmark-46-models-sub-1ms-routing.md index 1062ac4..15d742e 100644 --- a/docs/llm-router-benchmark-46-models-sub-1ms-routing.md +++ b/docs/llm-router-benchmark-46-models-sub-1ms-routing.md @@ -13,7 +13,7 @@ The results changed how we route requests. ## Why We Did This -BlockRun is an x402 micropayment gateway that sits between your AI agent and 66 LLM providers. Every request flows through our payment verification layer before hitting the model API. That means our latency numbers include everything a real user experiences: payment auth, provider API call, and response delivery. +BlockRun is an x402 micropayment gateway that sits between your AI agent and 71 LLM providers. Every request flows through our payment verification layer before hitting the model API. That means our latency numbers include everything a real user experiences: payment auth, provider API call, and response delivery. Most benchmarks measure model speed in isolation. We wanted to measure what users actually feel. @@ -136,7 +136,7 @@ Raw benchmark data: [benchmark-results.json](https://github.com/BlockRunAI/XClaw --- -_BlockRun is the x402 micropayment gateway for AI. One wallet, 66 models, pay-per-request with USDC. [Get started](https://blockrun.ai)_ +_BlockRun is the x402 micropayment gateway for AI. One wallet, 71 models, pay-per-request with USDC. [Get started](https://blockrun.ai)_ --- diff --git a/docs/plans/2026-02-03-smart-routing-design.md b/docs/plans/2026-02-03-smart-routing-design.md index f0d9bcf..d76b1b4 100644 --- a/docs/plans/2026-02-03-smart-routing-design.md +++ b/docs/plans/2026-02-03-smart-routing-design.md @@ -6,7 +6,7 @@ Simple queries go to Claude Opus at $75/M output tokens when Gemini Flash could handle them at $0.60/M. No cost-aware model selection. -Phase 1 solved API key management (one wallet for 66 models). Phase 2 solves cost optimization by routing queries to the cheapest capable model. +Phase 1 solved API key management (one wallet for 71 models). Phase 2 solves cost optimization by routing queries to the cheapest capable model. ## Why Client-Side diff --git a/docs/smart-llm-router-14-dimension-classifier.md b/docs/smart-llm-router-14-dimension-classifier.md index 7719268..8c24d3f 100644 --- a/docs/smart-llm-router-14-dimension-classifier.md +++ b/docs/smart-llm-router-14-dimension-classifier.md @@ -7,7 +7,7 @@ _March 20, 2026 | BlockRun Engineering_ > the benchmark. For current figures see > [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json). -When you route AI requests across 66 models from 8 providers, you can't just pick the cheapest one. You can't just pick the fastest one either. We learned this the hard way. +When you route AI requests across 71 models from 8 providers, you can't just pick the cheapest one. You can't just pick the fastest one either. We learned this the hard way. This is the technical story of how we benchmarked every model on our platform, discovered that speed and intelligence are poorly correlated, and built a production routing system that classifies requests in under 1ms using 14 weighted dimensions with sigmoid confidence calibration. @@ -26,7 +26,7 @@ We needed a system that could classify any request and route it to the optimal m ## Step 1: Benchmarking the Fleet -Before building the router, we needed ground truth. We benchmarked all 66 models through our production payment pipeline. +Before building the router, we needed ground truth. We benchmarked all 71 models through our production payment pipeline. ### Methodology @@ -317,7 +317,7 @@ We originally designed a two-stage system where low-confidence rules-based class ## Appendix: Full Benchmark Data -Raw data (66 models, latency, throughput, IQ scores, pricing): [`benchmark-merged.json`](https://github.com/BlockRunAI/XClawRouter/blob/main/benchmark-merged.json) +Raw data (71 models, latency, throughput, IQ scores, pricing): [`benchmark-merged.json`](https://github.com/BlockRunAI/XClawRouter/blob/main/benchmark-merged.json) Routing configuration: [`src/router/config.ts`](https://github.com/BlockRunAI/XClawRouter/blob/main/src/router/config.ts) @@ -325,4 +325,4 @@ Scoring implementation: [`src/router/rules.ts`](https://github.com/BlockRunAI/XC --- -_BlockRun is the x402 micropayment gateway for AI. One wallet, 66 models, pay-per-request with USDC. [blockrun.ai](https://blockrun.ai)_ +_BlockRun is the x402 micropayment gateway for AI. One wallet, 71 models, pay-per-request with USDC. [blockrun.ai](https://blockrun.ai)_ diff --git a/skills/xclawrouter/SKILL.md b/skills/xclawrouter/SKILL.md index eae1584..922dc96 100644 --- a/skills/xclawrouter/SKILL.md +++ b/skills/xclawrouter/SKILL.md @@ -19,7 +19,7 @@ metadata: { "openclaw": { "emoji": "🦀", "requires": { "config": ["models.prov # XClawRouter -Smart LLM router that saves 87% on inference costs by routing each request to the cheapest model that can handle it. 66 models across 9 providers (11 free NVIDIA models), all through one wallet. +Smart LLM router that saves 87% on inference costs by routing each request to the cheapest model that can handle it. 71 models across 9 providers (11 free NVIDIA models), all through one wallet. ## Install @@ -55,7 +55,7 @@ Rules handle ~~80% of requests in <1ms. Only ambiguous queries hit the LLM class ## Available Models -66 models including: gpt-5.5, gpt-5.4, gpt-4o, o3, claude-opus-4.8, claude-opus-4.7, claude-sonnet-4.6, gemini-3.1-pro, gemini-3.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.3, grok-build-0.1, kimi-k2.6, kimi-k2.5, and free NVIDIA-hosted models (gpt-oss-120b [default], gpt-oss-20b, deepseek-v4-flash, qwen3-coder-480b, llama-4-maverick, nemotron-3-nano-omni-30b-a3b-reasoning [vision]). +71 models including: gpt-5.5, gpt-5.4, gpt-4o, o3, claude-opus-4.8, claude-opus-4.7, claude-sonnet-4.6, gemini-3.1-pro, gemini-3.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.3, grok-build-0.1, kimi-k2.6, kimi-k2.5, and free NVIDIA-hosted models (gpt-oss-120b [default], gpt-oss-20b, deepseek-v4-flash, qwen3-coder-480b, llama-4-maverick, nemotron-3-nano-omni-30b-a3b-reasoning [vision]). ## Example Output