@blockrun/clawrouter 0.12.244 → 0.12.246
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 +28 -21
- package/dist/cli.js +275 -70
- package/dist/index.d.ts +9 -2
- package/dist/index.js +275 -70
- package/dist/router/index.js +48 -34
- package/docs/configuration.md +2 -9
- package/package.json +3 -3
- package/skills/clawrouter/SKILL.md +4 -4
- package/src/top-models.json +0 -1
package/README.md
CHANGED
|
@@ -7,11 +7,11 @@
|
|
|
7
7
|
<p>Agents can't sign up for accounts. Agents can't enter credit cards.<br>
|
|
8
8
|
Agents can only sign transactions.<br><br>
|
|
9
9
|
<strong>ClawRouter is the only LLM router that lets agents operate independently.</strong><br><br>
|
|
10
|
-
<em><!-- br:models.free -->
|
|
10
|
+
<em><!-- br:models.free -->5<!-- /br:models.free --> models free, no crypto required. No signup. No API key. No credit card.</em></p>
|
|
11
11
|
|
|
12
12
|
<br>
|
|
13
13
|
|
|
14
|
-
<img src="https://img.shields.io/badge/🆓
|
|
14
|
+
<img src="https://img.shields.io/badge/🆓_5_Free_Models-success?style=for-the-badge" alt="5 free models">
|
|
15
15
|
<img src="https://img.shields.io/badge/🤖_Agent--Native-black?style=for-the-badge" alt="Agent native">
|
|
16
16
|
<img src="https://img.shields.io/badge/🔑_Zero_API_Keys-blue?style=for-the-badge" alt="No API keys">
|
|
17
17
|
<img src="https://img.shields.io/badge/⚡_Local_Routing-yellow?style=for-the-badge" alt="Local routing">
|
|
@@ -46,7 +46,7 @@ Every other LLM router was built for **human developers** — create an account,
|
|
|
46
46
|
|
|
47
47
|
ClawRouter is built for the agent-first world:
|
|
48
48
|
|
|
49
|
-
- **Starts at $0** — <!-- br:models.free -->
|
|
49
|
+
- **Starts at $0** — <!-- br:models.free -->5<!-- /br:models.free --> NVIDIA models are free forever (incl. 1M-context DeepSeek V4 Flash + a vision-capable Nemotron Omni)
|
|
50
50
|
- **No accounts** — a wallet is generated locally, no signup
|
|
51
51
|
- **No API keys** — your wallet signature IS authentication
|
|
52
52
|
- **No model selection** — <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions -->-dimension scoring picks the right model automatically
|
|
@@ -62,7 +62,7 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r
|
|
|
62
62
|
| | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** |
|
|
63
63
|
| ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ---------------------------------------------------------------------- |
|
|
64
64
|
| **Models** | 200+ | 100+ | Smart routing | Gateway | **<!-- br:models.chatVisible -->71<!-- /br:models.chatVisible -->** |
|
|
65
|
-
| **Free tier** | Rate-limited | BYO keys | No | No | **<!-- br:models.free -->
|
|
65
|
+
| **Free tier** | Rate-limited | BYO keys | No | No | **<!-- br:models.free -->5<!-- /br:models.free --> models, no signup** |
|
|
66
66
|
| **Routing** | Manual selection | Manual selection | Smart (closed) | Observability | **Smart (open source)** |
|
|
67
67
|
| **Auth** | Account + API key | Your API keys | Account + API key | Account + API key | **Wallet signature** |
|
|
68
68
|
| **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
|
|
|
78
78
|
|
|
79
79
|
## Quick Start
|
|
80
80
|
|
|
81
|
-
> **No wallet? <!-- br:models.free -->
|
|
81
|
+
> **No wallet? <!-- br:models.free -->5<!-- /br:models.free --> models work free out of the box.** Install, run, and pin `free/mistral-nemotron` (or any of the <!-- br:models.free -->5<!-- /br:models.free -->) — no crypto, no signup, no balance required. Add USDC later when you want paid models.
|
|
82
82
|
|
|
83
83
|
### Option A — OpenClaw Agent
|
|
84
84
|
|
|
@@ -118,7 +118,7 @@ npx @blockrun/clawrouter
|
|
|
118
118
|
```
|
|
119
119
|
|
|
120
120
|
**2. Fund your wallet** — optional, skip for free tier
|
|
121
|
-
Your wallet address is printed on first run. For paid models, send a few USDC on Base or Solana — $5 covers thousands of requests. To stay at $0, pin any of the <!-- br:models.free -->
|
|
121
|
+
Your wallet address is printed on first run. For paid models, send a few USDC on Base or Solana — $5 covers thousands of requests. To stay at $0, pin any of the <!-- br:models.free -->5<!-- /br:models.free --> free models (e.g. `free/mistral-nemotron`) or use `/model free` inside OpenClaw.
|
|
122
122
|
|
|
123
123
|
**3. Point your client at `http://localhost:8402`**
|
|
124
124
|
|
|
@@ -213,7 +213,7 @@ Request → Weighted Scorer → Tier → Best Model → Response
|
|
|
213
213
|
|
|
214
214
|
| Tier | ECO Model | AUTO Model | PREMIUM Model |
|
|
215
215
|
| --------- | --------------------------------------- | --------------------------------------- | ---------------------------- |
|
|
216
|
-
| SIMPLE |
|
|
216
|
+
| SIMPLE | step-3.7-flash (**FREE**) | gemini-2.5-flash ($0.30/$2.50) | kimi-k2.7 † ($0.95/$4.00) |
|
|
217
217
|
| MEDIUM | gemini-3.1-flash-lite ($0.25/$1.50) | kimi-k2.7 ($0.95/$4.00) | gpt-5.3-codex ($1.75/$14.00) |
|
|
218
218
|
| COMPLEX | gemini-3.1-flash-lite ($0.25/$1.50) | gemini-3.1-pro ($2/$12) | claude-fable-5 ($10/$50) |
|
|
219
219
|
| REASONING | grok-4-1-fast-reasoning † ($0.20/$0.50) | grok-4-1-fast-reasoning † ($0.20/$0.50) | claude-sonnet-4.6 ($3/$15) |
|
|
@@ -393,7 +393,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
393
393
|
|
|
394
394
|
## Models & Pricing
|
|
395
395
|
|
|
396
|
-
<!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->
|
|
396
|
+
<!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->5<!-- /br:models.free --> models are $0 — paid models start at fractions of a cent.**
|
|
397
397
|
|
|
398
398
|
> **💡 "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.
|
|
399
399
|
|
|
@@ -401,31 +401,35 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
401
401
|
|
|
402
402
|
| Model | Input $/M | Output $/M | ~$/request | Context | Features |
|
|
403
403
|
| ------------------------------------------- | --------: | ---------: | ---------: | ------- | -------------------------------------------- |
|
|
404
|
-
| free/deepseek-v4-flash | **FREE** | **FREE** | **$0** | 1M | reasoning + coding, huge context |
|
|
405
404
|
| free/nemotron-3-nano-omni-30b-a3b-reasoning | **FREE** | **FREE** | **$0** | 256K | reasoning, **vision** (text+img+video+audio) |
|
|
406
405
|
| free/mistral-nemotron | **FREE** | **FREE** | **$0** | 131K | instruction following |
|
|
407
406
|
| free/step-3.7-flash | **FREE** | **FREE** | **$0** | 131K | reasoning |
|
|
408
407
|
| free/nemotron-nano-9b-v2 | **FREE** | **FREE** | **$0** | 131K | fast lightweight generalist |
|
|
409
408
|
| free/nemotron-nano-12b-v2-vl | **FREE** | **FREE** | **$0** | 131K | vision (text + image) |
|
|
409
|
+
| qwen/qwen3.7-flash | $0.03 | $0.13 | $0.0001 | 1M | reasoning, tools (fastest Qwen tier) |
|
|
410
410
|
| openai/gpt-5-nano | $0.05 | $0.40 | $0.0002 | 128K | tools |
|
|
411
|
+
| openai/gpt-5.6-luna-pro | $0.10 | $0.60 | $0.0004 | 1M | reasoning, vision, agentic, tools |
|
|
411
412
|
| openai/gpt-4.1-nano | $0.10 | $0.40 | $0.0003 | 128K | tools |
|
|
412
413
|
| google/gemini-2.5-flash-lite | $0.10 | $0.40 | $0.0003 | 1M | tools |
|
|
413
414
|
| openai/gpt-4o-mini | $0.15 | $0.60 | $0.0004 | 128K | tools |
|
|
415
|
+
| tencent/hy3 | $0.132 | $0.528 | $0.0003 | 262K | reasoning (Tencent Hy3) |
|
|
414
416
|
| xai/grok-4-fast | $0.20 | $0.50 | $0.0004 | 131K | tools |
|
|
417
|
+
| openai/gpt-5.6-luna | $0.20 | $1.20 | $0.0007 | 1M | vision, agentic, tools |
|
|
415
418
|
| xai/grok-4-fast-reasoning | $0.20 | $0.50 | $0.0004 | 131K | reasoning, tools |
|
|
416
419
|
| xai/grok-4-1-fast | $0.20 | $0.50 | $0.0004 | 131K | tools |
|
|
417
420
|
| openai/gpt-5-mini | $0.25 | $2.00 | $0.0011 | 200K | tools |
|
|
418
|
-
|
|
|
419
|
-
| deepseek/deepseek-
|
|
421
|
+
| qwen/qwen3.7-plus | $0.32 | $1.28 | $0.0008 | 1M | reasoning, agentic, tools (balanced Qwen) |
|
|
422
|
+
| deepseek/deepseek-chat | $0.14 | $0.28 | $0.0002 | 1M | tools (V4 Flash chat) |
|
|
423
|
+
| deepseek/deepseek-reasoner | $0.14 | $0.28 | $0.0002 | 1M | reasoning, tools (V4 Flash thinking) |
|
|
420
424
|
| deepseek/deepseek-v4-pro | $0.435 | $0.87 | $0.0007 | 1M | reasoning, agentic, tools (V4 flagship) |
|
|
421
|
-
|
|
|
425
|
+
| xiaomi/mimo-v2.5-pro | $0.435 | $0.87 | $0.0007 | 1M | reasoning (Xiaomi MiMo-V2.5 Pro) |
|
|
422
426
|
| zai/glm-5-turbo | $1.20 | $4.00 | $0.0026 | 200K | tools |
|
|
423
427
|
| minimax/minimax-m3 | $0.30 | $1.20 | $0.0008 | 1M | reasoning, agentic, tools |
|
|
424
428
|
| minimax/minimax-m2.7 | $0.30 | $1.20 | $0.0008 | 205K | reasoning, agentic, tools |
|
|
425
429
|
| minimax/minimax-m2.5 | $0.30 | $1.20 | $0.0008 | 205K | reasoning, agentic, tools |
|
|
426
430
|
| google/gemini-2.5-flash | $0.30 | $2.50 | $0.0014 | 1M | vision, tools |
|
|
431
|
+
| google/gemini-3.5-flash-lite | $0.30 | $2.50 | $0.0014 | 1M | reasoning, tools (thinking built-in) |
|
|
427
432
|
| openai/gpt-4.1-mini | $0.40 | $1.60 | $0.0010 | 128K | tools |
|
|
428
|
-
| google/gemini-3.5-flash | $0.50 | $3.00 | $0.0018 | 1M | reasoning, vision, tools (thinking built-in) |
|
|
429
433
|
| google/gemini-3-flash-preview | $0.50 | $3.00 | $0.0018 | 1M | vision |
|
|
430
434
|
| moonshot/kimi-k2.5 | $0.60 | $3.00 | $0.0018 | 262K | reasoning, vision, agentic, tools |
|
|
431
435
|
| moonshot/kimi-k2.7 | $0.95 | $4.00 | $0.0025 | 262K | reasoning, vision, agentic, tools |
|
|
@@ -436,7 +440,8 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
436
440
|
| Model | Input $/M | Output $/M | ~$/request | Context | Features |
|
|
437
441
|
| --------------------------- | --------: | ---------: | ---------: | ------- | ----------------------------------------- |
|
|
438
442
|
| anthropic/claude-haiku-4.5 | $1.00 | $5.00 | $0.0030 | 200K | vision, agentic, tools |
|
|
439
|
-
|
|
|
443
|
+
| zai/glm-5 | $1.00 | $3.20 | $0.0021 | 200K | reasoning, tools |
|
|
444
|
+
| openai/gpt-5.6-terra-pro | $1.00 | $6.00 | $0.0035 | 1M | reasoning, vision, agentic, tools |
|
|
440
445
|
| openai/o1-mini | $1.10 | $4.40 | $0.0028 | 128K | reasoning, tools |
|
|
441
446
|
| openai/o3-mini | $1.10 | $4.40 | $0.0028 | 128K | reasoning, tools |
|
|
442
447
|
| openai/o4-mini | $1.10 | $4.40 | $0.0028 | 128K | reasoning, tools |
|
|
@@ -445,6 +450,8 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
445
450
|
| zai/glm-5.1 | $1.40 | $4.40 | $0.0029 | 200K | reasoning, tools (promo ended 2026-06-05) |
|
|
446
451
|
| qwen/qwen3.7-max | $1.475 | $4.425 | $0.0030 | 1M | reasoning, agentic, tools (Qwen flagship) |
|
|
447
452
|
| xai/grok-4.3 | $1.50 | $4.00 | $0.0028 | 1M | reasoning, vision, agentic, tools |
|
|
453
|
+
| google/gemini-3.6-flash | $1.50 | $7.50 | $0.0045 | 1M | reasoning, vision, tools (newest Flash) |
|
|
454
|
+
| google/gemini-3.5-flash | $1.50 | $9.00 | $0.0053 | 1M | reasoning, vision, tools (thinking) |
|
|
448
455
|
| xai/grok-4.5 | $2.50 | $9.00 | $0.0058 | 500K | reasoning, vision, agentic, tools |
|
|
449
456
|
| xai/grok-build-0.1 | $1.50 | $3.00 | $0.0023 | 256K | agentic coding, tools |
|
|
450
457
|
| openai/gpt-5.2 | $1.75 | $14.00 | $0.0079 | 400K | reasoning, vision, agentic, tools |
|
|
@@ -457,7 +464,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
457
464
|
| xai/grok-2-vision | $2.00 | $10.00 | $0.0060 | 131K | vision, tools |
|
|
458
465
|
| openai/gpt-4o | $2.50 | $10.00 | $0.0063 | 128K | vision, agentic, tools |
|
|
459
466
|
| openai/gpt-5.4 | $2.50 | $15.00 | $0.0088 | 400K | reasoning, vision, agentic, tools |
|
|
460
|
-
| openai/gpt-5.6-terra | $2.
|
|
467
|
+
| openai/gpt-5.6-terra | $2.00 | $12.00 | $0.0070 | 1M | reasoning, vision, agentic, tools |
|
|
461
468
|
|
|
462
469
|
### Premium Models ($0.01+/request)
|
|
463
470
|
|
|
@@ -468,6 +475,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
468
475
|
| anthropic/claude-opus-5 | $5.00 | $25.00 | $0.0150 | 1M | reasoning, vision, agentic, tools |
|
|
469
476
|
| anthropic/claude-opus-4.8 | $5.00 | $25.00 | $0.0150 | 1M | reasoning, vision, agentic, tools |
|
|
470
477
|
| openai/gpt-5.6-sol | $5.00 | $30.00 | $0.0175 | 1M | reasoning, vision, agentic, tools |
|
|
478
|
+
| openai/gpt-5.6-sol-pro | $5.00 | $30.00 | $0.0175 | 1M | reasoning, vision, agentic, tools |
|
|
471
479
|
| openai/gpt-5.5 | $5.00 | $30.00 | $0.0175 | 1M | reasoning, vision, agentic, tools |
|
|
472
480
|
| openai/chat-latest | $5.00 | $30.00 | $0.0175 | 128K | vision, tools |
|
|
473
481
|
| openai/o1 | $15.00 | $60.00 | $0.0375 | 200K | reasoning, tools |
|
|
@@ -475,7 +483,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
|
|
|
475
483
|
| openai/gpt-5.4-pro | $30.00 | $180.00 | $0.1050 | 400K | reasoning, tools |
|
|
476
484
|
| openai/gpt-5.5-pro | $30.00 | $180.00 | $0.1050 | 1M | reasoning, vision, tools |
|
|
477
485
|
|
|
478
|
-
> **Free tier:** several NVIDIA-hosted models cost nothing — `/model free` smart-routes across them, or pick one directly (e.g., `/model nemotron-omni` for vision, `/model
|
|
486
|
+
> **Free tier:** several NVIDIA-hosted models cost nothing — `/model free` smart-routes across them, or pick one directly (e.g., `/model nemotron-omni` for vision, `/model step-flash` for reasoning, `/model mistral-nemotron` for instruction following).
|
|
479
487
|
> **Best value:** `gpt-5-nano` and `gemini-2.5-flash-lite` deliver strong results at ~$0.0003/request.
|
|
480
488
|
|
|
481
489
|
---
|
|
@@ -490,15 +498,14 @@ Request → 402 (price: $0.003) → wallet signs USDC → retry → response
|
|
|
490
498
|
|
|
491
499
|
USDC stays in your wallet until spent — non-custodial. Price is visible in the 402 header before signing.
|
|
492
500
|
|
|
493
|
-
**Dual-chain support:** Pay with **USDC** on **Base (EVM)** or **USDC on Solana**. Both wallets are derived from a single BIP-39 mnemonic on first run.
|
|
501
|
+
**Dual-chain support:** Pay with **USDC** on **Base (EVM)** or **USDC on Solana**. Both wallets are derived from a single BIP-39 mnemonic on first run. New installs default to **Solana**; existing installs stay on **Base** unless switched with `/wallet solana`.
|
|
494
502
|
|
|
495
503
|
```bash
|
|
496
504
|
/wallet # Check balance and address (both chains)
|
|
497
505
|
/wallet export # Export mnemonic + keys for backup
|
|
498
506
|
/wallet recover # Restore wallet from mnemonic on a new machine
|
|
499
507
|
/wallet solana # Switch to Solana USDC payments
|
|
500
|
-
/wallet base # Switch
|
|
501
|
-
/chain solana # Alias for /wallet solana
|
|
508
|
+
/wallet base # Switch to Base (EVM) USDC payments
|
|
502
509
|
/stats # View usage and savings
|
|
503
510
|
/stats clear # Reset usage statistics
|
|
504
511
|
/exclude # Show excluded models
|
|
@@ -552,7 +559,7 @@ For basic usage, no configuration needed. For advanced options:
|
|
|
552
559
|
Block specific models from being routed to. Useful if a model doesn't follow your agent instructions or you want to control costs.
|
|
553
560
|
|
|
554
561
|
```bash
|
|
555
|
-
/exclude add free/
|
|
562
|
+
/exclude add free/step-3.7-flash # Block a free model (e.g. not for your workload)
|
|
556
563
|
/exclude add grok-4 # Aliases work — blocks all grok-4 variants
|
|
557
564
|
/exclude add gpt-5.4 # Skip expensive models
|
|
558
565
|
/exclude # Show current exclusions
|
|
@@ -734,7 +741,7 @@ ClawRouter works with any tool that makes OpenAI-compatible API calls — point
|
|
|
734
741
|
|
|
735
742
|
### Is ClawRouter free?
|
|
736
743
|
|
|
737
|
-
ClawRouter itself is free and MIT licensed. You pay only for the LLM API calls routed through it — and several NVIDIA-hosted models (`
|
|
744
|
+
ClawRouter itself is free and MIT licensed. You pay only for the LLM API calls routed through it — and several NVIDIA-hosted models (`nemotron-3-nano-omni-30b-a3b-reasoning`, `mistral-nemotron`, `step-3.7-flash`, `nemotron-nano-9b-v2`, `nemotron-nano-12b-v2-vl`) are completely free. Use `/model free` to smart-route across them, or pick any by name.
|
|
738
745
|
|
|
739
746
|
---
|
|
740
747
|
|