diff --git a/CHANGELOG.md b/CHANGELOG.md index 77e47234..6b0d3d0a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -555,7 +555,7 @@ Both now forward verbatim through the existing paid-passthrough, verified live a ### Fixed — the API-key docs described a gateway that no longer exists -The 404 hint and the README both said `api.blockrun.ai` "currently carries chat and text completions" and that "image, video, audio and the partner APIs are still wallet-only". Probing the live gateway on 2026-09-05 disproved it: chat, `/v1/messages`, `/v1/models`, image generation, speech, video, Surf, Exa, prediction markets and phone lookup/fraud **all work on an API key**, and so do all 6 free models. The genuine wallet-only exceptions are the routes that bind a lease or a position to a payer address — buying/renewing/releasing phone numbers, and Polymarket trading — and those are now what the hint names. +The 404 hint and the README both said `api.blockrun.ai` "currently carries chat and text completions" and that "image, video, audio and the partner APIs are still wallet-only". Probing the live gateway on 2026-09-05 disproved it: chat, `/v1/messages`, `/v1/models`, image generation, speech, video, Surf, Exa, prediction markets and phone lookup/fraud **all work on an API key**, and so do all 7 free models. The genuine wallet-only exceptions are the routes that bind a lease or a position to a payer address — buying/renewing/releasing phone numbers, and Polymarket trading — and those are now what the hint names. ### Changed — Solana is the stated preference, without stranding Base wallets diff --git a/CLAUDE.md b/CLAUDE.md index 70e27092..fc579190 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ # ClawRouter -Smart LLM router for autonomous agents. 82 models. Two ways to pay: +Smart LLM router for autonomous agents. 88 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 e1afaef5..a5b1ed36 100644 --- a/README.md +++ b/README.md @@ -9,11 +9,11 @@ Agents can only sign transactions.

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

Pay however you like: credit card — sign up at user.blockrun.ai, top up, mint an API key
or USDC on Solana or Base (x402 wallet, no account at all).
-Or neither — 6 models are free, with no signup, no key and no wallet.

+Or neither — 7 models are free, with no signup, no key and no wallet.


-6 free models  +7 free models  Agent native  Card or USDC  Local routing  @@ -36,7 +36,7 @@ Or neither — 6 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. 82 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. 88 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** | 82 chat models across 9 providers, behind one endpoint and one balance | +| **Every LLM** | 88 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 | @@ -65,7 +65,7 @@ Every other LLM router was built for **human developers** — create an account, ClawRouter is built for the agent-first world: -- **Starts at $0** — 6 open-weight models are free forever (incl. a 1M-context reasoner and two sub-second coders). Image turns route to paid models — see the free-tier note below. +- **Starts at $0** — 7 open-weight models are free forever (incl. a 1M-context reasoner and two sub-second coders). Image turns route to paid models — see the free-tier note below. - **No accounts needed** — a wallet is generated locally, no signup - **No API keys needed** — your wallet signature IS authentication - **No model selection** — 15-dimension scoring + constraint-first ranking ([router-core](https://github.com/BlockRunAI/router-core)) picks the right model automatically @@ -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 82 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 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. | You are | Pay with | Setup | | ------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------- | @@ -92,8 +92,8 @@ 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 | **82** | -| **Free tier** | Rate-limited | BYO keys | No | No | **6 models, no signup** | +| **Models** | 200+ | 100+ | Smart routing | Gateway | **88** | +| **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** | | **Payment** | Credit card | BYO keys | Credit card | $49-499/mo | **USDC per-request _or_ card credit** | @@ -109,7 +109,7 @@ Full walkthrough: [Paying with a credit card](#paying-with-a-credit-card-api-key ## Quick Start -> **No wallet? 6 models work free out of the box.** Install, run, and pin `free/nemotron-3.5-lightning` (or any of the 6) — no crypto, no signup, no balance required. Add a credit card or USDC later when you want paid models. +> **No wallet? 7 models work free out of the box.** Install, run, and pin `free/nemotron-3.5-lightning` (or any of the 7) — no crypto, no signup, no balance required. Add a credit card or USDC later when you want paid models. **Two ways to pay for the paid ones — pick one, the rest of ClawRouter is identical:** @@ -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 82 chat models +> one key covers all 88 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 82 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 88 models, same x402 USDC settlement on Solana & Base. No OpenClaw required. ClawRouter runs as a local proxy on port 8402. @@ -182,7 +182,7 @@ npx @blockrun/clawrouter ``` **2. Fund your wallet** — optional, skip for free tier -Your wallet address is printed on first run. For paid models, send a few USDC on Solana (the default chain) or Base — $5 covers thousands of requests. Prefer a card? [Sign up at user.blockrun.ai](https://user.blockrun.ai) and run `clawrouter login brk_live_…` instead. To stay at $0, pin any of the 6 free models (e.g. `free/nemotron-3.5-lightning`) or use `/model free` inside OpenClaw. +Your wallet address is printed on first run. For paid models, send a few USDC on Solana (the default chain) or Base — $5 covers thousands of requests. Prefer a card? [Sign up at user.blockrun.ai](https://user.blockrun.ai) and run `clawrouter login brk_live_…` instead. To stay at $0, pin any of the 7 free models (e.g. `free/nemotron-3.5-lightning`) or use `/model free` inside OpenClaw. **3. Point your client at `http://localhost:8402`** @@ -485,7 +485,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC ## Models & Pricing -82 models across 9 providers, one wallet. **6 models are $0 — paid models start at fractions of a cent.** +88 models across 9 providers, one wallet. **7 models are $0 — paid models start at fractions of a cent.** > **💡 "Cost per request"** = estimated cost for a typical 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. @@ -585,7 +585,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC | openai/gpt-5.4-pro | $30.00 | $180.00 | $0.1050 | 1M | reasoning, tools | | openai/gpt-5.5-pro | $30.00 | $180.00 | $0.1050 | 1M | reasoning, vision, tools | -> **Free tier:** 6 open-weight models cost nothing — `/model free` pins the free default (`nemotron-3.5-lightning`, with the other five as fallbacks), `/model eco` opens on it, or pick one directly (e.g., `/model lightning` for 1M-context reasoning, `/model north-mini` or `/model laguna` for fast coding). +> **Free tier:** 7 open-weight models cost nothing — `/model free` pins the free default (`nemotron-3.5-lightning`, with the other five as fallbacks), `/model eco` opens on it, or pick one directly (e.g., `/model lightning` for 1M-context reasoning, `/model north-mini` or `/model laguna` for fast coding). > > **No free vision.** Two free models are catalogued as vision-capable and neither reliably is: on a 64×64 solid-colour probe `nemotron-3-nano-omni` was right 1 of 4 times on Base and answered "white" for red on Solana, and `llama-3.2-11b-vision` replied "I'm unable to see the image" 3 of 3 while answering text fine. Both return HTTP 200, so a wrong answer arrives with no error to branch on. ClawRouter therefore does not flag them for vision, and requests carrying an `image_url` route to a paid vision model instead. > **Best value:** `gpt-5-nano` and `gemini-2.5-flash-lite` deliver strong results at ~$0.0003/request. @@ -728,7 +728,7 @@ chains, the response cache and the local spend controls. - **Balance lives server-side.** There is no local balance to check: a call that outruns your credit comes back as HTTP `402 insufficient_quota`, naming the top-up page. Free models stay free and need no credit at all — all - 6 are served on the API-key gateway too. + 7 are served on the API-key gateway too. - **One key covers nearly everything.** Verified live against `api.blockrun.ai` on 2026-09-05: chat completions (`/v1/chat/completions`), the Anthropic-shaped `/v1/messages`, `/v1/models`, image generation, speech, video, and the partner @@ -881,7 +881,7 @@ npm test **The LLM router built for autonomous agents** -You're here. 82 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. 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. `curl -fsSL https://blockrun.ai/ClawRouter-update | bash` @@ -892,7 +892,7 @@ You're here. 82 mod **BlockRun for Claude Code** -Run Claude Code with 82 models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity. +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. `curl -fsSL https://blockrun.ai/brcc-install | bash` @@ -905,7 +905,7 @@ Run Claude Code with 8282 models, same x402 USDC payments on Solana & Base, native Hermes ergonomics. +Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 88 models, same x402 USDC payments on Solana & Base, native Hermes ergonomics. `pip install hermes-plugin-clawrouter` @@ -949,7 +949,7 @@ Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 82 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 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. ### What is ClawRouter? @@ -977,7 +977,7 @@ No. A wallet is the default because it is what lets an _agent_ pay for itself, but you can sign up at **[user.blockrun.ai](https://user.blockrun.ai)**, top up with a credit card, mint an API key and run `clawrouter login brk_live_…`. Calls then go to `api.blockrun.ai` on a bearer token and bill your account credit — no -crypto, no gas, no seed phrase. And the 6 free models need neither: no +crypto, no gas, no seed phrase. And the 7 free models need neither: no wallet, no key, no signup. See [Paying with a credit card](#paying-with-a-credit-card-api-key). ### Is ClawRouter free? diff --git a/brand-numbers.json b/brand-numbers.json index 635432fe..a71dfa5a 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": 82, - "totalVisible": 109, - "free": 6, - "freeWithheld": 27, + "chatVisible": 88, + "totalVisible": 115, + "free": 7, + "freeWithheld": 28, "image": 12, "video": 8, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 25, - "withFallbackAllEntries": 64 + "withFallback": 28, + "withFallbackAllEntries": 68 }, "clawrouter": { "dimensions": 15, @@ -29,6 +29,15 @@ "chains": { "rpc": 40 }, + "agentPayments": { + "rank": 1, + "windowDays": 30, + "tx": 8241102, + "volumeUsd": 97598, + "runnerUpTx": 466221, + "measuredAt": "2026-10-02", + "source": "https://www.x402scan.com" + }, "savings": { "baselineModel": "anthropic/claude-opus-5", "ecoVsBaselinePct": 98, diff --git a/docs/9-free-ai-models-zero-cost-blockrun.md b/docs/9-free-ai-models-zero-cost-blockrun.md index 39913a81..de3ed0d3 100644 --- a/docs/9-free-ai-models-zero-cost-blockrun.md +++ b/docs/9-free-ai-models-zero-cost-blockrun.md @@ -1,7 +1,7 @@ # 9 Free AI Models, Zero Cost: How BlockRun Gives Developers Top-Tier LLMs for Nothing > **The count in this title is a snapshot, and so is every model name below.** -> It was 9 when this was written; the published free tier is 6 today, and _none_ of the +> It was 9 when this was written; the published free tier is 7 today, and _none_ of the > nine originals is still in it. Free hosting is volatile — NVIDIA retired four > of the five visible free models in a single sweep on 2026-08-30 — so the tier > gets rebuilt rather than topped up. The URL keeps its original slug so existing @@ -23,7 +23,7 @@ BlockRun's answer: just take them. --- -## The Lineup: 6 Models, $0.00 +## The Lineup: 7 Models, $0.00 Through [ClawRouter](https://github.com/BlockRunAI/ClawRouter) — BlockRun's local AI routing proxy — you get zero-cost access to the following (checked against the live catalog 2026-09-29): @@ -236,13 +236,13 @@ Look at the cost trajectory over the past three years: - **2023:** GPT-4 dominates alone at $30/$60 per M tokens - **2024:** Open-source models surge, prices halve repeatedly - **2025:** DeepSeek, Qwen push top-tier inference below $1/M -- **2026:** BlockRun offers 6 free models through a single API +- **2026:** BlockRun offers 7 free models through a single API **A free tier that gets rebuilt rather than retired isn't just a product feature — it's a signal.** Baseline AI capability is becoming infrastructure. Like internet bandwidth before it, the cost of "good enough" AI inference is converging toward zero. BlockRun and ClawRouter exist to be the **routing layer** in this transition: not locked to any single provider, not bound to any single model, always giving developers the lowest-cost path to the right capability. -Today it's 6 free models, and they are not the same seven as last month. Tomorrow it could be 50. Prices will only drop. Capabilities will only improve. The names will keep churning. +Today it's 7 free models, and they are not the same seven as last month. Tomorrow it could be 50. Prices will only drop. Capabilities will only improve. The names will keep churning. **The one constant: your code doesn't need to change.** @@ -257,7 +257,7 @@ clawrouter start Point your `base_url` to `http://localhost:8402/v1`. That's the whole setup. -6 free models. Up to 1M context. Unlimited calls. Zero cost. +7 free models. Up to 1M context. Unlimited calls. Zero cost. Go build something. diff --git a/docs/anthropic-cost-savings.md b/docs/anthropic-cost-savings.md index 86e3f4a1..9a284ec5 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 82 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 88 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 111dec17..f0651850 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 82 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 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. ``` Your Agent → ClawRouter (localhost:8402) → Best model for the job @@ -74,12 +74,12 @@ 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** — 82 models, switch anytime +- **No vendor lock-in** — 88 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 - **Response caching** — identical requests within 10 minutes cost $0 -- **6 free models** — for tasks that don't need a paid model at all +- **7 free models** — for tasks that don't need a paid model at all ### Routing Profiles diff --git a/docs/clawrouter-vs-openrouter-llm-routing-comparison.md b/docs/clawrouter-vs-openrouter-llm-routing-comparison.md index 8fbffdee..1c7c632f 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 82 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 88 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 82 models across 9 providers (including 6 free models), updated with each release. Delisted models have automatic redirect aliases: +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: ```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 82 models, redirect aliases | +| **Model catalog** | Laggy, silent drops | Curated 88 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 fa4eb26b..dd09957d 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@blockrun/clawrouter", "version": "0.12.282", - "description": "Smart LLM router — save 84% on inference costs. 82 models (6 free). Pay by credit card (API key) or USDC (x402 wallet).", + "description": "Smart LLM router — save 84% on inference costs. 88 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 8c2a59f4..28401d2e 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 82 models from OpenAI, Anthropic, Google, DeepSeek, xAI, Z.AI, and more. 6 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 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. 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 82 models from 9 providers (6 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 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. **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 -82 models including: gpt-6-astra [GPT-6 flagship, 1M ctx], gpt-6-sol, gpt-6-luna [fast, $0.10/$0.50], 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, $4/$20], 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 — $0.15/$0.50], glm-5.2, minimax-m3, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.7-max [Qwen flagship, 1M ctx], qwen3.7-plus, qwen3.7-flash, mimo [Xiaomi MiMo-V2.5 Pro, 1M ctx], and 6 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]). 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. +88 models including: gpt-6-astra [GPT-6 flagship, 1M ctx], gpt-6-sol, gpt-6-luna [fast, $0.10/$0.50], 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, $4/$20], 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 — $0.15/$0.50], glm-5.2, minimax-m3, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.7-max [Qwen flagship, 1M ctx], qwen3.7-plus, qwen3.7-flash, mimo [Xiaomi MiMo-V2.5 Pro, 1M ctx], 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]). 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. ## Built-in Agent Tools