@blockrun/clawrouter 0.12.279 → 0.12.280
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -14
- package/dist/cli.js +5789 -1681
- package/dist/index.d.ts +2 -2
- package/dist/index.js +5779 -1671
- package/dist/router/index.js +9 -10
- package/docs/9-free-ai-models-zero-cost-blockrun.md +5 -13
- package/docs/anthropic-cost-savings.md +1 -1
- package/docs/anthropic-third-party-harness-changes.md +2 -2
- package/docs/clawrouter-cuts-llm-api-costs-500x.md +2 -2
- package/docs/clawrouter-vs-openrouter-llm-routing-comparison.md +4 -4
- package/docs/routing-profiles.md +9 -9
- package/openclaw.plugin.json +1 -1
- package/package.json +8 -5
- package/scripts/reinstall.sh +0 -1
- package/skills/clawrouter/SKILL.md +3 -3
- package/src/top-models.json +0 -1
package/dist/router/index.js
CHANGED
|
@@ -656,18 +656,12 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
|
|
|
656
656
|
supportsTools: false,
|
|
657
657
|
supportsVision: true
|
|
658
658
|
},
|
|
659
|
-
"nvidia/nemotron-3-nano-30b": {
|
|
660
|
-
// supportsTools: not probed — fails closed
|
|
661
|
-
contextWindow: 131072,
|
|
662
|
-
maxOutputTokens: 16384,
|
|
663
|
-
supportsTools: false,
|
|
664
|
-
supportsVision: false
|
|
665
|
-
},
|
|
666
659
|
"nvidia/nemotron-3-nano-omni-30b-a3b-reasoning": {
|
|
660
|
+
// override: The catalog tags this model "vision", but a correctly sized probe does not hold up (ClawRouter, 2026-08-31): a 64x64 solid-red PNG was named correctly 1 of 4 times on Base, and on Solana the image was silently dropped and a text model answered "white". An HTTP 200 with a confident wrong answer gives the caller nothing to branch on, so image turns must not be routed here. It is ecoTiers.SIMPLE.fallback[0] since nemotron-3-nano-30b was delisted (2026-09-08); remove once a probe of this size comes back right on both chains.
|
|
667
661
|
contextWindow: 256e3,
|
|
668
662
|
maxOutputTokens: 16384,
|
|
669
663
|
supportsTools: false,
|
|
670
|
-
supportsVision:
|
|
664
|
+
supportsVision: false
|
|
671
665
|
},
|
|
672
666
|
"nvidia/nemotron-3-ultra-550b": {
|
|
673
667
|
// supportsTools: not probed — fails closed
|
|
@@ -3484,8 +3478,13 @@ var DEFAULT_ROUTING_CONFIG = {
|
|
|
3484
3478
|
primary: "nvidia/nemotron-3.5-lightning",
|
|
3485
3479
|
// FREE — NVIDIA free tier flagship, 1M ctx
|
|
3486
3480
|
fallback: [
|
|
3487
|
-
|
|
3488
|
-
//
|
|
3481
|
+
// Was nvidia/nemotron-3-nano-30b until blockrun delisted it on 2026-09-08
|
|
3482
|
+
// (NVIDIA deprovisioned it for the account — a structured per-account
|
|
3483
|
+
// 404). nano-omni is blockrun's own redirect target for that id, so this
|
|
3484
|
+
// follows the same rule as the head: the router and the gateway name the
|
|
3485
|
+
// same model.
|
|
3486
|
+
"nvidia/nemotron-3-nano-omni-30b-a3b-reasoning",
|
|
3487
|
+
// FREE — nano-30b's successor, 256K ctx
|
|
3489
3488
|
// The free head keeps rotting with NVIDIA's hosting (deepseek-v4-flash
|
|
3490
3489
|
// 410 2026-08-12, seed-oss-36b 410 2026-08-03, gpt-oss-120b/20b 400
|
|
3491
3490
|
// 2026-08-21, and on 2026-08-30 FOUR of the five visible free models at
|
|
@@ -25,12 +25,11 @@ BlockRun's answer: just take them.
|
|
|
25
25
|
|
|
26
26
|
## The Lineup: <!-- br:models.free -->6<!-- /br:models.free --> Models, $0.00
|
|
27
27
|
|
|
28
|
-
Through [ClawRouter](https://github.com/BlockRunAI/ClawRouter) — BlockRun's local AI routing proxy — you get zero-cost access to the following (
|
|
28
|
+
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):
|
|
29
29
|
|
|
30
30
|
| Model | Context | Reasoning | Best For |
|
|
31
31
|
| ---------------------------- | ------- | --------- | ------------------------------------------ |
|
|
32
32
|
| **Nemotron 3.5 Lightning** | 1M | ✅ | The free default — thinking-mode reasoning |
|
|
33
|
-
| **Nemotron 3 Nano 30B** | 131K | ✅ | Fastest free model (~121 tok/s) |
|
|
34
33
|
| **Nemotron 3 Ultra 550B** | 1M | ✅ | Largest free model — 550B / 55B active MoE |
|
|
35
34
|
| **Nemotron 3 Nano Omni 30B** | 256K | ✅ | Strong generalist (text only in practice) |
|
|
36
35
|
| **Llama 3.2 11B Vision** | 128K | — | Meta Llama (text only in practice) |
|
|
@@ -99,12 +98,6 @@ A 30B-A3B mixture-of-experts model with a **1M-token context** and thinking-mode
|
|
|
99
98
|
|
|
100
99
|
**Best for:** Long-context reasoning, multi-step planning, anything where the input is big. If you remember one free model name, remember this one.
|
|
101
100
|
|
|
102
|
-
### Nemotron 3 Nano 30B — The Fast One
|
|
103
|
-
|
|
104
|
-
The **fastest free model in the catalog** — around 121 tokens/second on realistic workloads, not just short pings. Returns reasoning content. When you are iterating rapidly and each round-trip is a tax on your attention, this is the one to pin.
|
|
105
|
-
|
|
106
|
-
**Best for:** Rapid iteration, prompt engineering, high-volume light tasks.
|
|
107
|
-
|
|
108
101
|
### Nemotron 3 Ultra 550B — The Big One
|
|
109
102
|
|
|
110
103
|
550 billion total parameters, 55B active, 1M context — the **largest free model ever listed**. It is genuinely strong, and it is genuinely slower than the rest of the tier; treat it as the one you reach for when the task is hard rather than the one you leave pinned.
|
|
@@ -176,7 +169,6 @@ If you're using Claude Code, one command switches you to any free model:
|
|
|
176
169
|
|
|
177
170
|
```
|
|
178
171
|
/model free → Nemotron 3.5 Lightning (1M ctx, the default)
|
|
179
|
-
/model nano-30b → Nemotron 3 Nano 30B (fastest)
|
|
180
172
|
/model ultra-550b → Nemotron 3 Ultra 550B (largest)
|
|
181
173
|
/model vision-free → Nemotron 3 Nano Omni (text only, see below)
|
|
182
174
|
/model llama-vision → Llama 3.2 11B Vision (text only, see below)
|
|
@@ -198,17 +190,17 @@ The gateway will return structured tool calls from these models, but ClawRouter
|
|
|
198
190
|
|
|
199
191
|
### 2. Reasoning Has a Ceiling
|
|
200
192
|
|
|
201
|
-
|
|
193
|
+
Four of the six are reasoning-capable and handle most tasks well. On the hardest problems — competition-level math, formal proofs, deep multi-step planning — they don't match Claude Opus 5 or Sonnet 5. That's why ClawRouter's REASONING tier doesn't use free models.
|
|
202
194
|
|
|
203
195
|
### 3. There Is No Working Free Vision
|
|
204
196
|
|
|
205
|
-
Two of the
|
|
197
|
+
Two of the six are catalogued as vision-capable, and neither survives a real probe. On a 64×64 solid-red PNG, `nemotron-3-nano-omni` answered correctly 1 time in 4 on Base and returned "white" on Solana — where the response's own `model` field revealed a silent fallback to a text model. `llama-3.2-11b-vision` replied "I'm unable to see the image" on 3 of 3 attempts while answering plain text fine. Every one of those failures is an **HTTP 200**: the image is dropped and a confident wrong answer comes back with no error to branch on.
|
|
206
198
|
|
|
207
199
|
ClawRouter therefore ships no `vision` flag on any free model, so requests carrying an image route to a paid vision model instead. The general lesson is worth more than the specific finding: **a catalog's capability list is a claim, not a measurement** — and one passing sample is not a measurement either. The first probe here returned the right colour; it took four to see that was luck.
|
|
208
200
|
|
|
209
201
|
### 4. Free Hosting Is Volatile
|
|
210
202
|
|
|
211
|
-
This is the real limitation, and it is worth more than the other two. On 2026-08-30 NVIDIA retired four of the five visible free models in one sweep, and none of the nine models this article originally listed is still in the tier. Free capacity comes from whatever a provider is willing to give away this quarter. Pin a free model if you like — but build so that losing it costs you a config line, not a rewrite. That is the entire argument for putting a router in front of them.
|
|
203
|
+
This is the real limitation, and it is worth more than the other two. On 2026-08-30 NVIDIA retired four of the five visible free models in one sweep, and none of the nine models this article originally listed is still in the tier. Nine days after the replacements were listed, NVIDIA deprovisioned one of them — `nemotron-3-nano-30b`, the fastest in the tier — and it was delisted on 2026-09-08. Free capacity comes from whatever a provider is willing to give away this quarter. Pin a free model if you like — but build so that losing it costs you a config line, not a rewrite. That is the entire argument for putting a router in front of them.
|
|
212
204
|
|
|
213
205
|
---
|
|
214
206
|
|
|
@@ -219,7 +211,7 @@ This is the real limitation, and it is worth more than the other two. On 2026-08
|
|
|
219
211
|
Don't use one model for everything. Route by task type:
|
|
220
212
|
|
|
221
213
|
```
|
|
222
|
-
Quick chat, formatting → Nemotron 3 Nano 30B
|
|
214
|
+
Quick chat, formatting → Nemotron 3 Nano Omni 30B
|
|
223
215
|
Code generation → North Mini Code or Laguna XS 2.1
|
|
224
216
|
Reasoning required → Nemotron 3.5 Lightning (1M ctx)
|
|
225
217
|
Hardest free reasoning → Nemotron 3 Ultra 550B
|
|
@@ -50,7 +50,7 @@ This is where you're paying for real value:
|
|
|
50
50
|
|
|
51
51
|
## The Solution: ClawRouter
|
|
52
52
|
|
|
53
|
-
[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and <!-- br:models.chatVisible -->
|
|
53
|
+
[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**.
|
|
54
54
|
|
|
55
55
|
```
|
|
56
56
|
┌─────────────┐ ┌──────────────────────────────┐ ┌──────────────────┐
|
|
@@ -31,7 +31,7 @@ This is exactly the problem [ClawRouter](https://github.com/BlockRunAI/ClawRoute
|
|
|
31
31
|
|
|
32
32
|
## ClawRouter: Smart Routing for Agents
|
|
33
33
|
|
|
34
|
-
ClawRouter is an open-source local proxy that sits between your agent and <!-- br:models.chatVisible -->
|
|
34
|
+
ClawRouter is an open-source local proxy that sits between your agent and <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> 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.
|
|
35
35
|
|
|
36
36
|
```
|
|
37
37
|
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
|
|
|
74
74
|
|
|
75
75
|
- **No API keys to manage** — wallet-based cryptographic auth
|
|
76
76
|
- **No subscriptions** — pay per request in USDC (Base or Solana)
|
|
77
|
-
- **No vendor lock-in** — <!-- br:models.chatVisible -->
|
|
77
|
+
- **No vendor lock-in** — <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models, switch anytime
|
|
78
78
|
- **You control your wallet** — non-custodial, funds never held by a third party
|
|
79
79
|
- **Budget caps** — set a max spend per session, ClawRouter gracefully downgrades when budget runs low
|
|
80
80
|
- **Token compression** — 7-layer pipeline reduces token costs by 7–40% before they hit any provider
|
|
@@ -135,7 +135,7 @@ Less context repeated = fewer tokens = lower cost. Agents that need to recall ea
|
|
|
135
135
|
|
|
136
136
|
### 7. x402 Micropayments — Wallet-Based Budget Control
|
|
137
137
|
|
|
138
|
-
<p align="center"><img src="assets/blockrun-clawrouter-x402-usdc-micropayment-wallet-budget-control.png" alt="Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across
|
|
138
|
+
<p align="center"><img src="assets/blockrun-clawrouter-x402-usdc-micropayment-wallet-budget-control.png" alt="Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across 82 models, balance hits zero and the valve shuts cleanly" width="720"></p>
|
|
139
139
|
|
|
140
140
|
ClawRouter 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.
|
|
141
141
|
|
|
@@ -144,7 +144,7 @@ There is no monthly invoice. There is no 3am email. There is a wallet balance, a
|
|
|
144
144
|
**`maxCostPerRun`** — a per-session cost ceiling that stops or downgrades requests once a session exceeds a configured threshold (e.g., `$0.50`). This closes the remaining gap ([#3181](https://github.com/openclaw/openclaw/issues/3181)) where a wallet with sufficient funds can still accumulate within a single run. Two modes: `graceful` (downgrade to cheaper models) and `strict` (hard 429 once the cap is hit).
|
|
145
145
|
|
|
146
146
|
```
|
|
147
|
-
|
|
147
|
+
82 models. One wallet. Pay per call.
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
---
|
|
@@ -222,7 +222,7 @@ OpenRouter doesn't always pass through provider-specific features correctly. Ima
|
|
|
222
222
|
|
|
223
223
|
**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.
|
|
224
224
|
|
|
225
|
-

|
|
226
226
|
|
|
227
227
|
---
|
|
228
228
|
|
|
@@ -240,7 +240,7 @@ When new models launch, OpenRouter's catalog lags. Users configure a model that
|
|
|
240
240
|
|
|
241
241
|
### How ClawRouter Solves This
|
|
242
242
|
|
|
243
|
-
ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->
|
|
243
|
+
ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models across 9 providers (including <!-- br:models.free -->6<!-- /br:models.free --> free models), updated with each release. Delisted models have automatic redirect aliases:
|
|
244
244
|
|
|
245
245
|
```typescript
|
|
246
246
|
// Delisted models redirect automatically
|
|
@@ -250,7 +250,7 @@ ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->78<!-- /
|
|
|
250
250
|
|
|
251
251
|
No silent drops. No stale catalog. Models are benchmarked for speed, quality, and tool support before inclusion.
|
|
252
252
|
|
|
253
|
-

|
|
254
254
|
|
|
255
255
|
---
|
|
256
256
|
|
|
@@ -268,7 +268,7 @@ No silent drops. No stale catalog. Models are benchmarked for speed, quality, an
|
|
|
268
268
|
| **Rate limits** | Per-key, shared | Per-wallet, independent |
|
|
269
269
|
| **Vision support** | Images sometimes dropped | Auto-detected, vision-only fallback |
|
|
270
270
|
| **Tool calling** | Silent failures with some models | Flag-based filtering, guaranteed support |
|
|
271
|
-
| **Model catalog** | Laggy, silent drops | Curated <!-- br:models.chatVisible -->
|
|
271
|
+
| **Model catalog** | Laggy, silent drops | Curated <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models, redirect aliases |
|
|
272
272
|
| **Budget control** | Monthly invoice | Per-session cap (`maxCostPerRun`) |
|
|
273
273
|
| **Setup** | Create account, paste key | Agent generates wallet, auto-configured |
|
|
274
274
|
| **Average cost** | $25/M tokens (Opus direct) | auto-routed = **<!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% savings** |
|
package/docs/routing-profiles.md
CHANGED
|
@@ -32,12 +32,12 @@ Use `blockrun/auto` (or `/model auto`) for the best quality/price balance.
|
|
|
32
32
|
|
|
33
33
|
Use `blockrun/eco` for maximum cost savings. The first stop is the free tier, so simple requests can cost $0.00.
|
|
34
34
|
|
|
35
|
-
| Tier | Primary Model | Input | Output | Fallback chain (in order)
|
|
36
|
-
| --------- | --------------------------- | ----- | ------ |
|
|
37
|
-
| SIMPLE | free/nemotron-3.5-lightning | $0.00 | $0.00 | nemotron-3-nano-
|
|
38
|
-
| MEDIUM | zai/glm-5.3-flash | $0.15 | $0.50 | deepseek-chat → gemini-3.1-flash-lite → gpt-5.6-luna → gpt-5.4-nano → gemini-2.5-flash-lite → gemini-2.5-flash
|
|
39
|
-
| COMPLEX | zai/glm-5.3-flash | $0.15 | $0.50 | deepseek-chat → minimax-m3 → deepseek-v4-pro → gemini-3.1-flash-lite → gemini-2.5-flash
|
|
40
|
-
| REASONING | deepseek/deepseek-reasoner | $0.14 | $0.28 | deepseek-v4-pro → qwen3.7-plus → minimax-m3 → glm-5.3-flash
|
|
35
|
+
| Tier | Primary Model | Input | Output | Fallback chain (in order) |
|
|
36
|
+
| --------- | --------------------------- | ----- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|
|
37
|
+
| SIMPLE | free/nemotron-3.5-lightning | $0.00 | $0.00 | nemotron-3-nano-omni (free) → gemini-2.5-flash-lite → glm-5.3-flash → gpt-5.6-luna → gpt-5.4-nano → gemini-3.1-flash-lite |
|
|
38
|
+
| MEDIUM | zai/glm-5.3-flash | $0.15 | $0.50 | deepseek-chat → gemini-3.1-flash-lite → gpt-5.6-luna → gpt-5.4-nano → gemini-2.5-flash-lite → gemini-2.5-flash |
|
|
39
|
+
| COMPLEX | zai/glm-5.3-flash | $0.15 | $0.50 | deepseek-chat → minimax-m3 → deepseek-v4-pro → gemini-3.1-flash-lite → gemini-2.5-flash |
|
|
40
|
+
| REASONING | deepseek/deepseek-reasoner | $0.14 | $0.28 | deepseek-v4-pro → qwen3.7-plus → minimax-m3 → glm-5.3-flash |
|
|
41
41
|
|
|
42
42
|
The two free rungs at the head of ECO SIMPLE follow NVIDIA's free hosting, which retires models without notice (deepseek-v4-flash 410'd 2026-08-12, seed-oss-36b 2026-08-03, gpt-oss-120b hung 2026-08-16, and on 2026-08-30 NVIDIA retired FOUR of the five visible free models at once). Each retirement retargets the free rungs to the current free tier; the paid rungs never move. `src/router/free-model-liveness.test.ts` fails the build if a chain names a free model the picker no longer lists.
|
|
43
43
|
|
|
@@ -75,11 +75,11 @@ Set `routing.overrides.agenticMode: false` to disable the agentic tier set, or `
|
|
|
75
75
|
|
|
76
76
|
## FREE (`/model free`)
|
|
77
77
|
|
|
78
|
-
`free` is an alias, not a routed profile: it pins the free-tier default, currently **`free/nemotron-3.5-lightning`** — the same model that opens ECO SIMPLE. If that model is excluded (`/exclude add lightning`) or the budget cap forces a free fallback, the proxy walks the free cascade in this order: nemotron-3.5-lightning →
|
|
78
|
+
`free` is an alias, not a routed profile: it pins the free-tier default, currently **`free/nemotron-3.5-lightning`** — the same model that opens ECO SIMPLE. If that model is excluded (`/exclude add lightning`) or the budget cap forces a free fallback, the proxy walks the free cascade in this order: nemotron-3.5-lightning → laguna-xs-2.1 → north-mini-code → nemotron-3-nano-omni-30b-a3b-reasoning → nemotron-3-ultra-550b → llama-3.2-11b-vision. All six are $0.00 and need no USDC, and all six are treated as **text-only** — see the vision note below.
|
|
79
79
|
|
|
80
|
-
The order is not arbitrary. The head is whatever the gateway itself redirects the previous head to, so the proxy and the gateway never name different models. After it
|
|
80
|
+
The order is not arbitrary. The head is whatever the gateway itself redirects the previous head to, so the proxy and the gateway never name different models. After it come the two sub-second coders — adjacent on purpose, because they sit on _different_ capacity pools (our own NVIDIA key vs OpenRouter's $0 pool), so one pool's outage cannot take both. The vision model sits mid-chain, and the two slowest rungs go last. The tier stopped being NVIDIA-only on 2026-08-30: two of the six come from Cohere and Poolside. The fastest rung, `nemotron-3-nano-30b`, left on 2026-09-08 when NVIDIA deprovisioned it for blockrun's account; its aliases (`nano-30b`, `nemotron-nano`) now follow the gateway's redirect to `nemotron-3-nano-omni`.
|
|
81
81
|
|
|
82
|
-
Pin any of them directly with `/model lightning`, `/model
|
|
82
|
+
Pin any of them directly with `/model lightning`, `/model laguna`, `/model north-mini`, `/model nemotron-omni`, `/model ultra-550b` or `/model llama-vision`.
|
|
83
83
|
|
|
84
84
|
**No free model carries the `vision` flag,** even the two the upstream catalogs advertise as vision-capable. A 64×64 solid-colour probe on 2026-08-31 got the right answer 1 time in 4 from `nemotron-3-nano-omni` on Base, and "white" for red on Solana — where the response's own `model` field showed a silent fallback to a text model. `llama-3.2-11b-vision`, despite the name, said "I'm unable to see the image" on 3 of 3 while a plain-text control passed. Every one of those is an HTTP 200, so the caller gets a confident wrong answer with nothing to branch on. Since `vision` is what `filterByVision()` uses to _aim_ image turns at a model, flagging them would route real traffic into that. Requests carrying an `image_url` go to a paid vision model.
|
|
85
85
|
|
package/openclaw.plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "blockrun-clawrouter",
|
|
3
3
|
"name": "BlockRun ClawRouter",
|
|
4
|
-
"description": "Smart LLM router \u2014
|
|
4
|
+
"description": "Smart LLM router \u2014 82 models, x402 micropayments, 84% cost savings. Phone lookup + AI voice calls (Twilio + Bland.ai). Surf crypto-data API (84 endpoints, on-chain SQL, 100M+ labeled wallets) via skill.",
|
|
5
5
|
"skills": ["./skills"],
|
|
6
6
|
"activation": {
|
|
7
7
|
"onStartup": true
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@blockrun/clawrouter",
|
|
3
|
-
"version": "0.12.
|
|
4
|
-
"description": "Smart LLM router — save 84% on inference costs.
|
|
3
|
+
"version": "0.12.280",
|
|
4
|
+
"description": "Smart LLM router — save 84% on inference costs. 82 models (6 free). Pay by credit card (API key) or USDC (x402 wallet).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"types": "dist/index.d.ts",
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
"@polymarket/clob-client-v2": "1.0.8",
|
|
96
96
|
"@scure/bip32": "^2.0.1",
|
|
97
97
|
"@scure/bip39": "^1.5.0",
|
|
98
|
-
"@solana/kit": "^
|
|
98
|
+
"@solana/kit": "^8.4.0",
|
|
99
99
|
"@x402/core": "^2.9.0",
|
|
100
100
|
"@x402/evm": "^2.9.0",
|
|
101
101
|
"@x402/fetch": "^2.9.0",
|
|
@@ -115,7 +115,7 @@
|
|
|
115
115
|
}
|
|
116
116
|
},
|
|
117
117
|
"devDependencies": {
|
|
118
|
-
"@blockrun/router-core": "https://codeload.github.com/BlockRunAI/router-core/tar.gz/
|
|
118
|
+
"@blockrun/router-core": "https://codeload.github.com/BlockRunAI/router-core/tar.gz/e38958bba9af0aaa788c5baafbdaff539638b7c9",
|
|
119
119
|
"@eslint/js": "^10.0.1",
|
|
120
120
|
"eslint": "^10.2.0",
|
|
121
121
|
"openclaw": "^2026.7.2-beta.7",
|
|
@@ -137,7 +137,10 @@
|
|
|
137
137
|
"tar": "^7.5.22",
|
|
138
138
|
"hono": "^4.13.5",
|
|
139
139
|
"@hono/node-server": "^2.1.0",
|
|
140
|
-
"ip-address": "^10.4.0"
|
|
140
|
+
"ip-address": "^10.4.0",
|
|
141
|
+
"@solana-program/compute-budget": "^0.18.1",
|
|
142
|
+
"@solana-program/token": "^0.16.1",
|
|
143
|
+
"@solana-program/token-2022": "^0.16.1"
|
|
141
144
|
},
|
|
142
145
|
"engines": {
|
|
143
146
|
"node": ">=22"
|
package/scripts/reinstall.sh
CHANGED
|
@@ -988,7 +988,6 @@ echo " /model free → nemotron-3.5-lightning (default free)"
|
|
|
988
988
|
echo ""
|
|
989
989
|
echo "Free models (no wallet needed):"
|
|
990
990
|
echo " /model lightning → nemotron-3.5-lightning (1M ctx, reasoning)"
|
|
991
|
-
echo " /model nano-30b → nemotron-3-nano-30b (fastest, ~121 tok/s)"
|
|
992
991
|
echo " /model north-mini → north-mini-code (Cohere, coding, sub-second)"
|
|
993
992
|
echo " /model laguna → laguna-xs-2.1 (Poolside, coding, ~161 tok/s)"
|
|
994
993
|
echo " /model vision-free → nemotron-3-nano-omni (text/image/video/audio)"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: clawrouter
|
|
3
|
-
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
|
|
3
|
+
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.
|
|
4
4
|
triggers:
|
|
5
5
|
- "clawrouter"
|
|
6
6
|
- "claw router"
|
|
@@ -53,7 +53,7 @@ metadata:
|
|
|
53
53
|
|
|
54
54
|
# ClawRouter
|
|
55
55
|
|
|
56
|
-
Hosted-gateway LLM router that saves <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across <!-- br:models.chatVisible -->
|
|
56
|
+
Hosted-gateway LLM router that saves <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across <!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models from 9 providers (<!-- br:models.free -->6<!-- /br:models.free --> 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.
|
|
57
57
|
|
|
58
58
|
**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.
|
|
59
59
|
|
|
@@ -147,7 +147,7 @@ it against a baseline nobody wrote down. See
|
|
|
147
147
|
|
|
148
148
|
## Available Models
|
|
149
149
|
|
|
150
|
-
<!-- br:models.chatVisible -->
|
|
150
|
+
<!-- br:models.chatVisible -->82<!-- /br:models.chatVisible --> models including: 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-4o, o3, claude-fable-5, claude-opus-5 [Anthropic flagship, 1M ctx], claude-opus-4.8, claude-opus-4.7, claude-opus-4.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.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, hy3 [Tencent], mimo [Xiaomi MiMo-V2.5 Pro, 1M ctx], and <!-- br:models.free -->6<!-- /br:models.free --> 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.
|
|
151
151
|
|
|
152
152
|
## Built-in Agent Tools
|
|
153
153
|
|
package/src/top-models.json
CHANGED