diff --git a/CLAUDE.md b/CLAUDE.md index fc579190..41a6ac77 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ # ClawRouter -Smart LLM router for autonomous agents. 88 models. Two ways to pay: +Smart LLM router for autonomous agents. 90 models. Two ways to pay: - **Wallet (default)** — x402 USDC micropayments signed per call, against `blockrun.ai/api` (Base) or `sol.blockrun.ai/api` (Solana). New installs default to Solana. - **API key** — `brk_live_…` from [user.blockrun.ai](https://user.blockrun.ai), billed against card-funded account credit, against `api.blockrun.ai`. `src/api-key.ts` resolves it (env → `~/.blockrun/.api-key` → `~/.openclaw/blockrun/api-key`); a key present anywhere wins over a wallet, and no wallet is generated or read in that mode. diff --git a/README.md b/README.md index 82ae6d2f..e6793c02 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ Or neither — 7 models are free, -> **ClawRouter** is an open-source smart LLM router that reduces AI API costs by up to 84%. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. It is the only LLM router that an autonomous agent can pay for by itself — a wallet signature is the account, and USDC micropayments over the x402 protocol are the billing — and it takes an ordinary credit card too: sign up at [user.blockrun.ai](https://user.blockrun.ai), top up, and run the same router on an API key. 88 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 up to 84%. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. It is the only LLM router that an autonomous agent can pay for by itself — a wallet signature is the account, and USDC micropayments over the x402 protocol are the billing — and it takes an ordinary credit card too: sign up at [user.blockrun.ai](https://user.blockrun.ai), top up, and run the same router on an API key. 90 models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed. --- @@ -48,7 +48,7 @@ Not a seat, not a subscription, not a monthly minimum you keep paying while the | | | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Every LLM** | 88 chat models across 9 providers, behind one endpoint and one balance | +| **Every LLM** | 90 chat models across 9 providers, behind one endpoint and one balance | | **Every tool** | 12 image models, 8 video models, music, 5 voices, img2img editing, and outbound phone calls that come back as transcripts | | **Every data source** | web, news and neural search; prediction markets; live crypto and equity quotes; on-chain SQL over 100M+ labeled wallets; DEX routing; RPC across 40 chains | | **Best value per dollar** | 15-dimension local routing sends each request to the cheapest model that can actually do it — 84% below pinning Claude Opus 5 on the same traffic, computed from a published workload mix rather than estimated | @@ -76,7 +76,7 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r ### …and if you are a human, not an agent -Every "no X needed" above is a capability, not a restriction. **ClawRouter takes a credit card too.** Sign up at **[user.blockrun.ai](https://user.blockrun.ai)**, top up, mint an API key, and run `clawrouter login brk_live_…`. Same router, same 88 models, same local routing — calls go to `api.blockrun.ai` on a bearer token and bill your account credit. No crypto, no gas, no seed phrase. +Every "no X needed" above is a capability, not a restriction. **ClawRouter takes a credit card too.** Sign up at **[user.blockrun.ai](https://user.blockrun.ai)**, top up, mint an API key, and run `clawrouter login brk_live_…`. Same router, same 90 models, same local routing — calls go to `api.blockrun.ai` on a bearer token and bill your account credit. No crypto, no gas, no seed phrase. | You are | Pay with | Setup | | ------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------- | @@ -92,7 +92,7 @@ Full walkthrough: [Paying with a credit card](#paying-with-a-credit-card-api-key | | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** | | ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ---------------------------------------------------------------------- | -| **Models** | 200+ | 100+ | Smart routing | Gateway | **88** | +| **Models** | 200+ | 100+ | Smart routing | Gateway | **90** | | **Free tier** | Rate-limited | BYO keys | No | No | **7 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 _or_ API key** | @@ -127,7 +127,7 @@ is all it takes to switch and `clawrouter logout` is all it takes to switch back > **Where do I sign up?** [**user.blockrun.ai**](https://user.blockrun.ai) — sign in with > Google, add credit with a card under **Credits**, mint a key under **API Keys**. That -> one key covers all 88 chat models +> one key covers all 90 chat models > plus images, video, speech and the live-data APIs. No wallet, no crypto, no seed phrase. ### Desktop control plane (macOS) @@ -171,7 +171,7 @@ openclaw gateway restart > **Using Claude Code?** Check out [BRCC](https://github.com/BlockRunAI/brcc) — it's purpose-built for Claude Code with the same smart routing and x402 payments. > -> **Using NousResearch Hermes?** See [ClawRouter-Hermes](https://github.com/BlockRunAI/ClawRouter-Hermes) — a Python plugin that wires Hermes into the ClawRouter proxy. Same wallet, same 88 models, same x402 USDC settlement on Solana & Base. +> **Using NousResearch Hermes?** See [ClawRouter-Hermes](https://github.com/BlockRunAI/ClawRouter-Hermes) — a Python plugin that wires Hermes into the ClawRouter proxy. Same wallet, same 90 models, same x402 USDC settlement on Solana & Base. No OpenClaw required. ClawRouter runs as a local proxy on port 8402. @@ -489,7 +489,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC ## Models & Pricing -88 models across 9 providers, one wallet. **7 models are $0 — paid models start at fractions of a cent.** +90 models across 9 providers, one wallet. **7 models are $0 — paid models start at fractions of a cent.** > **💡** Models are grouped by typical cost of a chat message (~500 input + 500 output tokens). Paid requests also carry a flat **$0.001/tx settlement fee** (covers on-chain gas; already included in the price the gateway quotes). Free models never pay it. @@ -889,7 +889,7 @@ npm test **The LLM router built for autonomous agents** -You're here. 88 models, local smart routing, and two ways to pay — a credit-card-funded API key, or x402 USDC from a wallet, which is what lets an agent operate independently. +You're here. 90 models, local smart routing, and two ways to pay — a credit-card-funded API key, or x402 USDC from a wallet, which is what lets an agent operate independently. `curl -fsSL https://blockrun.ai/ClawRouter-update | bash` @@ -900,7 +900,7 @@ You're here. 88 mod **BlockRun for Claude Code** -Run Claude Code with 88 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. +Run Claude Code with 90 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` @@ -913,7 +913,7 @@ Run Claude Code with 8888 models, same x402 USDC payments on Solana & Base, native Hermes ergonomics. +Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 90 models, same x402 USDC payments on Solana & Base, native Hermes ergonomics. `pip install hermes-plugin-clawrouter` @@ -957,7 +957,7 @@ Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 88 chat models plus image, video, music and speech generation, search, market data and multi-chain RPC, billed per call with USDC over [x402](https://x402.org) or a credit-card-funded API key — no seat, no subscription, no minimum. ClawRouter is the open-source local router agents use to reach it. +BlockRun lets agents pay for the outcome — every LLM, tool and data source, best value per dollar. One endpoint and one balance covering 90 chat models plus image, video, music and speech generation, search, market data and multi-chain RPC, billed per call with USDC over [x402](https://x402.org) or a credit-card-funded API key — no seat, no subscription, no minimum. ClawRouter is the open-source local router agents use to reach it. ### What is ClawRouter? diff --git a/brand-numbers.json b/brand-numbers.json index 4bdafd32..54d8aa3e 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,16 +2,16 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 88, - "totalVisible": 115, + "chatVisible": 90, + "totalVisible": 117, "free": 7, - "freeWithheld": 28, + "freeWithheld": 27, "image": 12, "video": 8, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 28, + "withFallback": 29, "withFallbackAllEntries": 68 }, "clawrouter": { diff --git a/docs/anthropic-cost-savings.md b/docs/anthropic-cost-savings.md index 9a284ec5..26b5bc81 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/ClawRouter) is an open-source local proxy that sits between your app and 88 AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**. +[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and 90 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 f0651850..240b5ec3 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 [ClawRouter](https://github.com/BlockRunAI/ClawRoute ## ClawRouter: Smart Routing for Agents -ClawRouter is an open-source local proxy that sits between your agent and 88 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. +ClawRouter is an open-source local proxy that sits between your agent and 90 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 → ClawRouter (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** — 88 models, switch anytime +- **No vendor lock-in** — 90 models, switch anytime - **You control your wallet** — non-custodial, funds never held by a third party - **Budget caps** — set a max spend per session, ClawRouter 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-vs-openrouter-llm-routing-comparison.md b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md index 1c7c632f..53062c50 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.** ClawRouter 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 88 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 90 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 ClawRouter Solves This -ClawRouter maintains a curated catalog of 88 models across 9 providers (including 7 free models), updated with each release. Delisted models have automatic redirect aliases: +ClawRouter maintains a curated catalog of 90 models across 9 providers (including 7 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 88 models, redirect aliases | +| **Model catalog** | Laggy, silent drops | Curated 90 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 = **84% savings** | diff --git a/package.json b/package.json index 60a726a2..99ce8214 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@blockrun/clawrouter", "version": "0.12.297", - "description": "Smart LLM router — save 84% on inference costs. 88 models (7 free). Pay by credit card (API key) or USDC (x402 wallet).", + "description": "Smart LLM router — save 84% on inference costs. 90 models (7 free). Pay by credit card (API key) or USDC (x402 wallet).", "type": "module", "main": "dist/index.js", "types": "dist/index.d.ts", diff --git a/skills/clawrouter/SKILL.md b/skills/clawrouter/SKILL.md index 01149dcc..acb6fd97 100644 --- a/skills/clawrouter/SKILL.md +++ b/skills/clawrouter/SKILL.md @@ -1,6 +1,6 @@ --- name: clawrouter -description: Hosted-gateway LLM router — save 84% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 88 models from OpenAI, Anthropic, Google, DeepSeek, xAI, Z.AI, and more. 7 free open-weight models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering, phone-number intelligence (carrier + SIM-swap fraud detection) plus AI-powered outbound voice calls (Twilio + Bland.ai), AND the Surf unified crypto data API (84 endpoints — CEX/DEX, on-chain SQL over 80+ ClickHouse tables, 100M+ labeled wallets, prediction markets, social/CT mindshare, news, VC fund intel) as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway. +description: Hosted-gateway LLM router — save 84% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 90 models from OpenAI, Anthropic, Google, DeepSeek, xAI, Z.AI, and more. Free open-weight models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering, phone-number intelligence (carrier + SIM-swap fraud detection) plus AI-powered outbound voice calls (Twilio + Bland.ai) as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway. triggers: - "clawrouter" - "claw router" @@ -53,7 +53,7 @@ metadata: # ClawRouter -Hosted-gateway LLM router that saves 84% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 88 models from 9 providers (7 free open-weight models). All billing flows through one BlockRun credential — either a USDC wallet paying x402 per call, or a BlockRun API key drawing on card-funded account credit. Either way you do not hold provider API keys. +Hosted-gateway LLM router that saves 84% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 90 models from 9 providers (7 free open-weight models). All billing flows through one BlockRun credential — either a USDC wallet paying x402 per call, or a BlockRun API key drawing on card-funded account credit. Either way you do not hold provider API keys. **This is not a local-inference tool.** ClawRouter is a thin local proxy. Your prompts are sent over HTTPS to the blockrun.ai gateway for model execution. If your workload requires inference that never leaves your machine, use a local runtime like Ollama — ClawRouter is not the right tool for that use case. @@ -147,7 +147,7 @@ it against a baseline nobody wrote down. See ## Available Models -88 models including: gpt-6-astra [GPT-6 flagship, 1M ctx], gpt-6-sol, gpt-6.1-sol [refreshed Sol], gpt-6-luna [fast], gpt-5.6-terra [balanced, stable default], gpt-5.6-sol [flagship], gpt-5.6-luna [cost-efficient], gpt-5.6-sol/terra/luna-pro [pro reasoning tiers], gpt-5.5, gpt-5.5-pro [max compute], chat-latest [ChatGPT Instant], gpt-5.4, gpt-5.1, gpt-4o, o3, claude-fable-5.1, claude-fable-5, claude-opus-5.5 [newest Opus], claude-opus-5 [1M ctx], claude-opus-4.8, claude-opus-4.7, claude-opus-4.5, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gemini-3.1-pro, gemini-3.6-flash, gemini-3.5-flash-lite, gemini-2.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, glm-5.3 [Z.AI flagship, 1M ctx], glm-5.3-flash [natively multimodal, 1M ctx], glm-5.2, minimax-m3, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.8-max [Qwen 3.8 flagship, 1M ctx], qwen3.7-max, qwen3.7-plus, qwen3.7-flash, mimo [Xiaomi MiMo-V2.5 Pro, 1M ctx], mistral-large-4 [Mistral flagship, 512K ctx, vision], hy4-preview [Tencent, 770B MoE], laguna-s-2.1 [Poolside, coding], and 7 free open-weight models (nemotron-3.5-lightning [1M ctx, thinking mode — the free default], nemotron-3-ultra-550b [550B/55B MoE, 1M ctx — the largest free model], nemotron-3-nano-omni-30b-a3b-reasoning [256K ctx], llama-3.2-11b-vision [Meta Llama], north-mini-code [Cohere, coding, sub-second], laguna-xs-2.1 [Poolside, coding, ~161 tok/s], muse-glimmer-30b [Meta Muse, reasoning]). The free tier is text-only — image turns route to a paid vision model, because the two free models the catalogs advertise as vision-capable fail a solid-colour probe on both chains and do so with an HTTP 200. +90 models including: gpt-6-astra [GPT-6 flagship, 1M ctx], gpt-6-sol, gpt-6.1-sol [refreshed Sol], gpt-6-luna [fast], gpt-5.6-terra [balanced, stable default], gpt-5.6-sol [flagship], gpt-5.6-luna [cost-efficient], gpt-5.6-sol/terra/luna-pro [pro reasoning tiers], gpt-5.5, gpt-5.5-pro [max compute], chat-latest [ChatGPT Instant], gpt-5.4, gpt-5.1, gpt-4o, o3, claude-fable-5.1, claude-fable-5, claude-opus-5.5 [newest Opus], claude-opus-5 [1M ctx], claude-opus-4.8, claude-opus-4.7, claude-opus-4.5, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gemini-3.1-pro, gemini-3.6-flash, gemini-3.5-flash-lite, gemini-2.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, glm-5.3 [Z.AI flagship, 1M ctx], glm-5.3-flash [natively multimodal, 1M ctx], glm-5.2, minimax-m3, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.8-max [Qwen 3.8 flagship, 1M ctx], qwen3.7-max, qwen3.7-plus, qwen3.7-flash, mimo [Xiaomi MiMo-V2.5 Pro, 1M ctx], mistral-large-4 [Mistral flagship, 512K ctx, vision], hy4-preview [Tencent, 770B MoE], laguna-s-2.1 [Poolside, coding], and 7 free open-weight models (nemotron-3.5-lightning [1M ctx, thinking mode — the free default], nemotron-3-ultra-550b [550B/55B MoE, 1M ctx — the largest free model], nemotron-3-nano-omni-30b-a3b-reasoning [256K ctx], llama-3.2-11b-vision [Meta Llama], north-mini-code [Cohere, coding, sub-second], laguna-xs-2.1 [Poolside, coding, ~161 tok/s], muse-glimmer-30b [Meta Muse, reasoning]). The free tier is text-only — image turns route to a paid vision model, because the two free models the catalogs advertise as vision-capable fail a solid-colour probe on both chains and do so with an HTTP 200. ## Model Prices — Look Them Up Live