{"_id":"@ampersend_ai/clawrouter","_rev":"20-4f3134f39ddf3ae4e34de44cf59c02a1","name":"@ampersend_ai/clawrouter","dist-tags":{"latest":"0.10.1005"},"versions":{"0.10.1002":{"name":"@ampersend_ai/clawrouter","version":"0.10.1002","keywords":["llm","router","smart-routing","ai","openclaw","blockrun","x402","usdc","cost-optimization","openai","anthropic","gemini","deepseek","usdc-hackathon-winner","agentic-commerce"],"author":{"name":"BlockRun","email":"hello@blockrun.ai"},"license":"MIT","_id":"@ampersend_ai/clawrouter@0.10.1002","maintainers":[{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},{"name":"pcarranzav_edgeandnode","email":"pablo@edgeandnode.com"}],"homepage":"https://github.com/edgeandnode/ClawRouter#readme","bugs":{"url":"https://github.com/edgeandnode/ClawRouter/issues"},"bin":{"clawrouter":"dist/cli.js"},"dist":{"shasum":"60f8e88388a7f57389974cd6865d75b576e52b8a","tarball":"https://registry.npmjs.org/@ampersend_ai/clawrouter/-/clawrouter-0.10.1002.tgz","fileCount":13,"integrity":"sha512-rnwAdwsz03HIdRCyRfQcearQUW3d8reUdJY3rXuOSbaWrkPb/YNk1OKw/rFR4GnS8WizTTWiT6x03HjXIAXwhA==","signatures":[{"sig":"MEUCIAbL2TlK9NKh4iyjCDWAx/371h4JGbnp9QwgfyVJczDTAiEA+Ddg+U49irZptaQlv1b1b8jWQm8kB8Zxth0B9rjWnK0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1350333},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1197f983bb549f38c48822e346c6b35c5a0771c8","scripts":{"dev":"tsup --watch","lint":"eslint src/","test":"vitest run","build":"tsup","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check .","test:e2e:tool-ids":"tsx test/e2e-tool-id-sanitization.ts","test:docker:install":"bash test/run-docker-test.sh","test:resilience:full":"npm run test:resilience:errors && npm run test:resilience:lifecycle && npm run test:resilience:stability:full","test:resilience:quick":"npm run test:resilience:errors && npm run test:resilience:lifecycle","test:docker:edge-cases":"bash test/docker/run-edge-cases.sh","test:resilience:errors":"tsx test/resilience-errors.ts","test:docker:integration":"docker compose -f test/integration/docker-compose.yml up --build --abort-on-container-exit --exit-code-from integration","test:resilience:lifecycle":"tsx test/resilience-lifecycle.ts","test:resilience:stability":"DURATION_MINUTES=5 tsx test/resilience-stability.ts","test:resilience:stability:full":"DURATION_MINUTES=240 tsx test/resilience-stability.ts"},"_npmUser":{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},"openclaw":{"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/edgeandnode/ClawRouter.git","type":"git"},"_npmVersion":"10.9.2","description":"Smart LLM router — save 92% on inference costs. 41+ models, one wallet, x402 micropayments.","directories":{},"_nodeVersion":"22.15.1","dependencies":{"viem":"^2.39.3","@x402/core":"^2.1.0","@x402/fetch":"^2.1.0","@ampersend_ai/ampersend-sdk":"^0.0.8"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","eslint":"^9.39.2","vitest":"^4.0.18","openclaw":"latest","prettier":"^3.8.1","@eslint/js":"^9.39.2","typescript":"^5.7.0","typescript-eslint":"^8.54.0"},"peerDependencies":{"openclaw":">=2025.1.0"},"peerDependenciesMeta":{"openclaw":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/clawrouter_0.10.1002_1772032964996_0.44760092227389214","host":"s3://npm-registry-packages-npm-production"}},"0.10.1003":{"name":"@ampersend_ai/clawrouter","version":"0.10.1003","keywords":["llm","router","smart-routing","ai","openclaw","blockrun","x402","usdc","cost-optimization","openai","anthropic","gemini","deepseek","usdc-hackathon-winner","agentic-commerce"],"author":{"name":"BlockRun","email":"hello@blockrun.ai"},"license":"MIT","_id":"@ampersend_ai/clawrouter@0.10.1003","maintainers":[{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},{"name":"pcarranzav_edgeandnode","email":"pablo@edgeandnode.com"}],"homepage":"https://github.com/edgeandnode/ClawRouter#readme","bugs":{"url":"https://github.com/edgeandnode/ClawRouter/issues"},"bin":{"clawrouter":"dist/cli.js"},"dist":{"shasum":"9bf5cdbd2c1661ec456ad413fdb892789ff02602","tarball":"https://registry.npmjs.org/@ampersend_ai/clawrouter/-/clawrouter-0.10.1003.tgz","fileCount":13,"integrity":"sha512-KaP1YEwS5PHNDVluYzcMJR7Y37Joq8l3OsW3FTciFAUZDw0GNvq6DDTNYWuLIw2h+HlvdVR5cKhGf2SWx6VWXQ==","signatures":[{"sig":"MEUCICkjn9jtSb8MCylQxEQIFv9cF/HWzXkfHZxo8V2zsxdMAiEAsGwFWzHD7pMJ6jUpXOWxm9Xj98sGzTvaEGm4q5BKY+c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1349902},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"4cd073372b68b091014df346fab6fb7be7332a60","scripts":{"dev":"tsup --watch","lint":"eslint src/","test":"vitest run","build":"tsup","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check .","test:e2e:tool-ids":"tsx test/e2e-tool-id-sanitization.ts","test:docker:install":"bash test/run-docker-test.sh","test:resilience:full":"npm run test:resilience:errors && npm run test:resilience:lifecycle && npm run test:resilience:stability:full","test:resilience:quick":"npm run test:resilience:errors && npm run test:resilience:lifecycle","test:docker:edge-cases":"bash test/docker/run-edge-cases.sh","test:resilience:errors":"tsx test/resilience-errors.ts","test:docker:integration":"docker compose -f test/integration/docker-compose.yml up --build --abort-on-container-exit --exit-code-from integration","test:resilience:lifecycle":"tsx test/resilience-lifecycle.ts","test:resilience:stability":"DURATION_MINUTES=5 tsx test/resilience-stability.ts","test:resilience:stability:full":"DURATION_MINUTES=240 tsx test/resilience-stability.ts"},"_npmUser":{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},"openclaw":{"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/edgeandnode/ClawRouter.git","type":"git"},"_npmVersion":"10.9.2","description":"Smart LLM router — save 92% on inference costs. 41+ models, one wallet, x402 micropayments.","directories":{},"_nodeVersion":"22.15.1","dependencies":{"viem":"^2.39.3","@x402/fetch":"^2.1.0","@ampersend_ai/ampersend-sdk":"^0.0.9-rc.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","eslint":"^9.39.2","vitest":"^4.0.18","openclaw":"latest","prettier":"^3.8.1","@eslint/js":"^9.39.2","typescript":"^5.7.0","typescript-eslint":"^8.54.0"},"peerDependencies":{"openclaw":">=2025.1.0"},"peerDependenciesMeta":{"openclaw":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/clawrouter_0.10.1003_1772043330907_0.6439796681982246","host":"s3://npm-registry-packages-npm-production"}},"0.10.1004":{"name":"@ampersend_ai/clawrouter","version":"0.10.1004","keywords":["llm","router","smart-routing","ai","openclaw","blockrun","x402","usdc","cost-optimization","openai","anthropic","gemini","deepseek","usdc-hackathon-winner","agentic-commerce"],"author":{"name":"BlockRun","email":"hello@blockrun.ai"},"license":"MIT","_id":"@ampersend_ai/clawrouter@0.10.1004","maintainers":[{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},{"name":"pcarranzav_edgeandnode","email":"pablo@edgeandnode.com"}],"homepage":"https://github.com/edgeandnode/ClawRouter#readme","bugs":{"url":"https://github.com/edgeandnode/ClawRouter/issues"},"bin":{"clawrouter":"dist/cli.js"},"dist":{"shasum":"7ebb5e1dfc01f5b30f45b14ae97954d500a91632","tarball":"https://registry.npmjs.org/@ampersend_ai/clawrouter/-/clawrouter-0.10.1004.tgz","fileCount":13,"integrity":"sha512-nawTTMsQQhaatT6tlir2jf4WCJopsmx/G7NGONr0RE0uqTTEYw/f7mAu5zjeVy2EM7sq7ujn65SKu5QFkcG4XA==","signatures":[{"sig":"MEYCIQCgwLS1pccnCg31yEQi0PlxRfMEEf/8K+9yyaBjrOr3+QIhAO0mxSHuHN7bTs3/AHHshlQinXgHhBhoOBU3bxPIxCgE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1353015},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"db3bbd690c13077c5a6b04d5827f8dfa659e1163","scripts":{"dev":"tsup --watch","lint":"eslint src/","test":"vitest run","build":"tsup","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check .","test:e2e:tool-ids":"tsx test/e2e-tool-id-sanitization.ts","test:docker:install":"bash test/run-docker-test.sh","test:resilience:full":"npm run test:resilience:errors && npm run test:resilience:lifecycle && npm run test:resilience:stability:full","test:resilience:quick":"npm run test:resilience:errors && npm run test:resilience:lifecycle","test:docker:edge-cases":"bash test/docker/run-edge-cases.sh","test:resilience:errors":"tsx test/resilience-errors.ts","test:docker:integration":"docker compose -f test/integration/docker-compose.yml up --build --abort-on-container-exit --exit-code-from integration","test:resilience:lifecycle":"tsx test/resilience-lifecycle.ts","test:resilience:stability":"DURATION_MINUTES=5 tsx test/resilience-stability.ts","test:resilience:stability:full":"DURATION_MINUTES=240 tsx test/resilience-stability.ts"},"_npmUser":{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},"openclaw":{"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/edgeandnode/ClawRouter.git","type":"git"},"_npmVersion":"10.9.2","description":"Smart LLM router — save 92% on inference costs. 41+ models, one wallet, x402 micropayments.","directories":{},"_nodeVersion":"22.15.1","dependencies":{"viem":"^2.39.3","@x402/fetch":"^2.1.0","@ampersend_ai/ampersend-sdk":"^0.0.9-rc.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","eslint":"^9.39.2","vitest":"^4.0.18","openclaw":"latest","prettier":"^3.8.1","@eslint/js":"^9.39.2","typescript":"^5.7.0","typescript-eslint":"^8.54.0"},"peerDependencies":{"openclaw":">=2025.1.0"},"peerDependenciesMeta":{"openclaw":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/clawrouter_0.10.1004_1772065645643_0.6669809566940377","host":"s3://npm-registry-packages-npm-production"}},"0.10.1005":{"name":"@ampersend_ai/clawrouter","version":"0.10.1005","description":"Smart LLM router — save 92% on inference costs. 41+ models, one wallet, x402 micropayments.","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"clawrouter":"dist/cli.js"},"openclaw":{"extensions":["./dist/index.js"]},"exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","lint":"eslint src/","format":"prettier --write .","format:check":"prettier --check .","test:resilience:errors":"tsx test/resilience-errors.ts","test:resilience:stability":"DURATION_MINUTES=5 tsx test/resilience-stability.ts","test:resilience:stability:full":"DURATION_MINUTES=240 tsx test/resilience-stability.ts","test:resilience:lifecycle":"tsx test/resilience-lifecycle.ts","test:resilience:quick":"npm run test:resilience:errors && npm run test:resilience:lifecycle","test:resilience:full":"npm run test:resilience:errors && npm run test:resilience:lifecycle && npm run test:resilience:stability:full","test:e2e:tool-ids":"tsx test/e2e-tool-id-sanitization.ts","test:docker:install":"bash test/run-docker-test.sh","test:docker:edge-cases":"bash test/docker/run-edge-cases.sh","test:docker:integration":"docker compose -f test/integration/docker-compose.yml up --build --abort-on-container-exit --exit-code-from integration"},"keywords":["llm","router","smart-routing","ai","openclaw","blockrun","x402","usdc","cost-optimization","openai","anthropic","gemini","deepseek","usdc-hackathon-winner","agentic-commerce"],"author":{"name":"BlockRun","email":"hello@blockrun.ai"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/edgeandnode/ClawRouter.git"},"dependencies":{"@ampersend_ai/ampersend-sdk":"^0.0.9-rc.2","@x402/fetch":"^2.1.0","viem":"^2.39.3"},"peerDependencies":{"openclaw":">=2025.1.0"},"peerDependenciesMeta":{"openclaw":{"optional":true}},"devDependencies":{"@eslint/js":"^9.39.2","eslint":"^9.39.2","openclaw":"latest","prettier":"^3.8.1","tsup":"^8.0.0","tsx":"^4.21.0","typescript":"^5.7.0","typescript-eslint":"^8.54.0","vitest":"^4.0.18"},"engines":{"node":">=20"},"_id":"@ampersend_ai/clawrouter@0.10.1005","gitHead":"4f45219f5566e961beda9ad784adfbb12fe752b9","bugs":{"url":"https://github.com/edgeandnode/ClawRouter/issues"},"homepage":"https://github.com/edgeandnode/ClawRouter#readme","_nodeVersion":"22.15.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-evozGaVZxruV6hYn2YIDBRJrPzGOsVkxQLy82vwAVVIrmVUbIOG7i8rB+eTLxDH68hpl3aKO7LO61xZqfXrRqw==","shasum":"73ec53dbfcbec516a192465a8f0529556ef30729","tarball":"https://registry.npmjs.org/@ampersend_ai/clawrouter/-/clawrouter-0.10.1005.tgz","fileCount":13,"unpackedSize":1353015,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICNh9kngdVTEqy5CKntiDpTGh680r0hIgLqWd15i9u2PAiAndP7srNasryPxqcQbfK1Kc+77hi9X40wY+gO0iNrTpg=="}]},"_npmUser":{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},"directories":{},"maintainers":[{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},{"name":"pcarranzav_edgeandnode","email":"pablo@edgeandnode.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clawrouter_0.10.1005_1772119466357_0.5332253247472887"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-23T18:39:15.822Z","modified":"2026-02-26T15:24:26.652Z","0.0.1":"2026-02-23T18:39:16.104Z","0.0.2":"2026-02-23T18:47:14.783Z","0.0.3":"2026-02-23T18:58:20.488Z","0.0.4":"2026-02-23T19:23:20.357Z","0.0.5":"2026-02-24T16:32:53.687Z","0.10.6":"2026-02-25T14:24:46.239Z","0.10.10":"2026-02-25T14:49:51.068Z","0.10.1001":"2026-02-25T15:06:42.722Z","0.10.1002":"2026-02-25T15:22:45.192Z","0.10.1003":"2026-02-25T18:15:31.123Z","0.10.1004":"2026-02-26T00:27:25.835Z","0.10.1005":"2026-02-26T15:24:26.540Z"},"bugs":{"url":"https://github.com/edgeandnode/ClawRouter/issues"},"author":{"name":"BlockRun","email":"hello@blockrun.ai"},"license":"MIT","homepage":"https://github.com/edgeandnode/ClawRouter#readme","keywords":["llm","router","smart-routing","ai","openclaw","blockrun","x402","usdc","cost-optimization","openai","anthropic","gemini","deepseek","usdc-hackathon-winner","agentic-commerce"],"repository":{"type":"git","url":"git+https://github.com/edgeandnode/ClawRouter.git"},"description":"Smart LLM router — save 92% on inference costs. 41+ models, one wallet, x402 micropayments.","maintainers":[{"name":"matiasedgeandnode","email":"matias@edgeandnode.com"},{"name":"pcarranzav_edgeandnode","email":"pablo@edgeandnode.com"}],"readme":"<div align=\"center\">\n\n<img src=\"assets/banner.png\" alt=\"ClawRouter Banner\" width=\"600\">\n\n<h3>The agent-native LLM router for <a href=\"https://openclaw.ai\">OpenClaw</a></h3>\n\nRoute every request to the right model at the right price.<br>\n15-dimension scoring, <1ms local routing, optimized for autonomous agents.<br>\nOne wallet, 41+ models, zero API keys.\n\n<img src=\"https://img.shields.io/badge/🚀_92%25_Cost_Savings-success?style=for-the-badge\" alt=\"92% savings\">&nbsp;\n<img src=\"https://img.shields.io/badge/🔑_Zero_API_Keys-blue?style=for-the-badge\" alt=\"No API keys\">&nbsp;\n<img src=\"https://img.shields.io/badge/🤖_41+_Models-purple?style=for-the-badge\" alt=\"38+ models\">&nbsp;\n<img src=\"https://img.shields.io/badge/💰_Non--Custodial-orange?style=for-the-badge\" alt=\"Non-custodial\">&nbsp;\n<img src=\"https://img.shields.io/badge/⚡_<1ms_Routing-yellow?style=for-the-badge\" alt=\"Fast routing\">\n\n[![npm version](https://img.shields.io/npm/v/@blockrun/clawrouter.svg?style=flat-square&color=cb3837)](https://npmjs.com/package/@blockrun/clawrouter)\n[![npm downloads](https://img.shields.io/npm/dm/@blockrun/clawrouter.svg?style=flat-square&color=blue)](https://npmjs.com/package/@blockrun/clawrouter)\n[![GitHub stars](https://img.shields.io/github/stars/BlockRunAI/ClawRouter?style=flat-square)](https://github.com/BlockRunAI/ClawRouter)\n[![CI](https://img.shields.io/github/actions/workflow/status/BlockRunAI/ClawRouter/ci.yml?style=flat-square&label=CI)](https://github.com/BlockRunAI/ClawRouter/actions)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://typescriptlang.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)\n\n[![USDC Hackathon Winner](https://img.shields.io/badge/🏆_USDC_Hackathon-Agentic_Commerce_Winner-gold?style=flat-square)](https://x.com/USDC/status/2021625822294216977)\n[![x402 Protocol](https://img.shields.io/badge/x402-Micropayments-purple?style=flat-square)](https://x402.org)\n[![Base Network](https://img.shields.io/badge/Base-USDC-0052FF?style=flat-square&logo=coinbase&logoColor=white)](https://base.org)\n[![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-orange?style=flat-square)](https://openclaw.ai)\n[![Telegram](https://img.shields.io/badge/Telegram-Community-26A5E4?style=flat-square&logo=telegram)](https://t.me/blockrunAI)\n\n</div>\n\n---\n\n## 📑 Quick Navigation\n\n| Section                                   | Description                     |\n| ----------------------------------------- | ------------------------------- |\n| [Quick Start](#-quick-start)              | Install in 2 minutes            |\n| [Routing Profiles](#-routing-profiles)    | eco / auto / premium / free     |\n| [How It Works](#-how-it-works)            | 15-dimension local routing      |\n| [Models & Pricing](#-models--pricing)     | 41+ models, full price list     |\n| [Screenshots](#-screenshots)              | See it in action                |\n| [Payment](#-payment)                      | x402 non-custodial USDC         |\n| [Configuration](#%EF%B8%8F-configuration) | Environment variables           |\n| [Troubleshooting](#-troubleshooting)      | `doctor` AI-powered diagnostics |\n| [vs OpenRouter](#-vs-openrouter)          | Why ClawRouter wins             |\n| [Support](#-support)                      | Telegram, X, founders           |\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# 1. Install with smart routing enabled\ncurl -fsSL https://blockrun.ai/ClawRouter-update | bash\nopenclaw gateway restart\n\n# 2. Fund your wallet with USDC on Base (address printed on install)\n# $5 is enough for thousands of requests\n```\n\nDone! Smart routing (`blockrun/auto`) is now your default model.\n\n---\n\n## 🎯 Routing Profiles\n\nChoose your routing strategy with `/model <profile>`:\n\n| Profile          | Strategy           | Savings | Best For         |\n| ---------------- | ------------------ | ------- | ---------------- |\n| `/model auto`    | Balanced (default) | 74-100% | General use      |\n| `/model eco`     | Cheapest possible  | 95-100% | Maximum savings  |\n| `/model premium` | Best quality       | 0%      | Mission-critical |\n| `/model free`    | Free tier only     | 100%    | Zero cost        |\n\n**Shortcuts:** `/model grok`, `/model br-sonnet`, `/model gpt5`, `/model o3`\n\n---\n\n## ⚡ How It Works\n\n**100% local routing. <1ms latency. Zero external API calls.**\n\n```\nRequest → Weighted Scorer (15 dimensions) → Tier → Cheapest Model → Response\n```\n\n| Tier      | ECO Model                           | AUTO Model                   | PREMIUM Model                |\n| --------- | ----------------------------------- | ---------------------------- | ---------------------------- |\n| SIMPLE    | nvidia/gpt-oss-120b (FREE)          | kimi-k2.5 ($0.60/$3.00)      | kimi-k2.5                    |\n| MEDIUM    | gemini-2.5-flash-lite ($0.10/$0.40) | grok-code-fast ($0.20/$1.50) | gpt-5.2-codex ($1.75/$14.00) |\n| COMPLEX   | gemini-2.5-flash-lite ($0.10/$0.40) | gemini-3.1-pro ($2/$12)      | claude-opus-4.6 ($5/$25)     |\n| REASONING | grok-4-fast ($0.20/$0.50)           | grok-4-fast ($0.20/$0.50)    | claude-sonnet-4.6 ($3/$15)   |\n\n**Blended average: $2.05/M** vs $25/M for Claude Opus = **92% savings**\n\n---\n\n## 💰 Models & Pricing\n\n41+ models across 7 providers, one wallet:\n\n<details>\n<summary><strong>Click to expand full model list</strong></summary>\n\n| Model                   | Input $/M | Output $/M | Context | Reasoning |\n| ----------------------- | --------- | ---------- | ------- | :-------: |\n| **OpenAI**              |           |            |         |           |\n| gpt-5.2                 | $1.75     | $14.00     | 400K    |    \\*     |\n| gpt-4o                  | $2.50     | $10.00     | 128K    |           |\n| gpt-4o-mini             | $0.15     | $0.60      | 128K    |           |\n| gpt-oss-120b            | **FREE**  | **FREE**   | 128K    |           |\n| o1                      | $15.00    | $60.00     | 200K    |    \\*     |\n| o1-mini                 | $1.10     | $4.40      | 128K    |    \\*     |\n| o3                      | $2.00     | $8.00      | 200K    |    \\*     |\n| o4-mini                 | $1.10     | $4.40      | 128K    |    \\*     |\n| **Anthropic**           |           |            |         |           |\n| claude-opus-4.5         | $5.00     | $25.00     | 200K    |    \\*     |\n| claude-sonnet-4.6       | $3.00     | $15.00     | 200K    |    \\*     |\n| claude-haiku-4.5        | $1.00     | $5.00      | 200K    |           |\n| **Google**              |           |            |         |           |\n| gemini-3.1-pro-preview  | $2.00     | $12.00     | 1M      |    \\*     |\n| gemini-3-pro-preview    | $2.00     | $12.00     | 1M      |    \\*     |\n| gemini-3-flash-preview  | $0.50     | $3.00      | 1M      |           |\n| gemini-2.5-pro          | $1.25     | $10.00     | 1M      |    \\*     |\n| gemini-2.5-flash        | $0.30     | $2.50      | 1M      |           |\n| gemini-2.5-flash-lite   | $0.10     | $0.40      | 1M      |           |\n| **DeepSeek**            |           |            |         |           |\n| deepseek-chat           | $0.28     | $0.42      | 128K    |           |\n| deepseek-reasoner       | $0.28     | $0.42      | 128K    |    \\*     |\n| **xAI**                 |           |            |         |           |\n| grok-4-0709             | $0.20     | $1.50      | 131K    |    \\*     |\n| grok-4-1-fast-reasoning | $0.20     | $0.50      | 131K    |    \\*     |\n| grok-code-fast-1        | $0.20     | $1.50      | 131K    |           |\n| **Moonshot**            |           |            |         |           |\n| kimi-k2.5               | $0.60     | $3.00      | 262K    |    \\*     |\n| **MiniMax**             |           |            |         |           |\n| minimax-m2.5            | $0.30     | $1.20      | 205K    |    \\*     |\n\n</details>\n\n> **Free tier:** `gpt-oss-120b` costs nothing and serves as automatic fallback when wallet is empty.\n\n---\n\n## 📸 Screenshots\n\n<table>\n<tr>\n<td width=\"50%\" align=\"center\">\n<strong>Smart Routing in Action</strong><br><br>\n<img src=\"docs/clawrouter-savings.png\" alt=\"ClawRouter savings\" width=\"400\">\n</td>\n<td width=\"50%\" align=\"center\">\n<strong>Telegram Integration</strong><br><br>\n<img src=\"assets/telegram-demo.png\" alt=\"Telegram demo\" width=\"400\">\n</td>\n</tr>\n</table>\n\n**The flow:**\n\n1. **Wallet auto-generated** on Base (L2) — saved at `~/.openclaw/blockrun/wallet.key`\n2. **Fund with $1 USDC** — enough for hundreds of requests\n3. **Request any model** — ClawRouter picks the cheapest capable one\n4. **Pay per request** — non-custodial, you hold your keys\n\n---\n\n## 💳 Payment\n\nNo account. No API key. **Payment IS authentication** via [x402](https://x402.org).\n\n```\nRequest → 402 (price: $0.003) → wallet signs USDC → retry → response\n```\n\nUSDC stays in your wallet until spent — non-custodial. Price is visible in the 402 header before signing.\n\n```bash\n/wallet     # Check balance and address\n/stats      # View usage and savings\n```\n\n**Fund your wallet:**\n\n- **Coinbase:** Buy USDC, send to Base\n- **Bridge:** Move USDC from any chain to Base\n- **CEX:** Withdraw USDC to Base network\n\n---\n\n## ⚙️ Configuration\n\nFor basic usage, no configuration needed. For advanced options:\n\n| Variable              | Default        | Description             |\n| --------------------- | -------------- | ----------------------- |\n| `BLOCKRUN_WALLET_KEY` | auto-generated | Your wallet private key |\n| `BLOCKRUN_PROXY_PORT` | `8402`         | Local proxy port        |\n| `CLAWROUTER_DISABLED` | `false`        | Disable smart routing   |\n\n**Full reference:** [docs/configuration.md](docs/configuration.md)\n\n---\n\n## 🥊 vs OpenRouter\n\n|                 | OpenRouter / LiteLLM        | ClawRouter                       |\n| --------------- | --------------------------- | -------------------------------- |\n| **Setup**       | Human creates account       | Agent generates wallet           |\n| **Auth**        | API key (shared secret)     | Wallet signature (cryptographic) |\n| **Payment**     | Prepaid balance (custodial) | Per-request (non-custodial)      |\n| **Routing**     | Proprietary / closed        | Open source, client-side         |\n| **Rate limits** | Per-key quotas              | None (your wallet, your limits)  |\n| **Cost**        | $25/M (Opus equivalent)     | $2.05/M blended average          |\n\n**[Full comparison →](docs/vs-openrouter.md)**\n\n---\n\n## 🩺 Troubleshooting\n\n**When things go wrong, run the doctor:**\n\n```bash\nnpx @blockrun/clawrouter doctor\n```\n\nThis collects diagnostics and sends them to Claude Sonnet for AI-powered analysis:\n\n```\n🩺 BlockRun Doctor v0.10.4\n\nSystem\n  ✓ OS: darwin arm64\n  ✓ Node: v20.11.0\n\nWallet\n  ✓ Address: 0x1234...abcd\n  ✓ Balance: $12.50\n\nNetwork\n  ✓ BlockRun API: reachable (142ms)\n  ✗ Local proxy: not running on :8402\n\n📤 Sending to Claude Sonnet 4.6 (~$0.003)...\n\n🤖 AI Analysis:\nThe local proxy isn't running. Run `openclaw gateway restart` to fix.\n```\n\n**Use Opus for complex issues:**\n\n```bash\nnpx @blockrun/clawrouter doctor opus\n```\n\n**Ask a specific question:**\n\n```bash\nnpx @blockrun/clawrouter doctor \"why is my request failing?\"\nnpx @blockrun/clawrouter doctor opus \"深度分析我的配置\"\n```\n\n**Cost:** Sonnet ~$0.003 (default) | Opus ~$0.01\n\n---\n\n## 🛠 Development\n\n```bash\ngit clone https://github.com/BlockRunAI/ClawRouter.git\ncd ClawRouter\nnpm install\nnpm run build\nnpm test\n```\n\n---\n\n## 📞 Support\n\n| Channel               | Link                                                               |\n| --------------------- | ------------------------------------------------------------------ |\n| 📅 Schedule Demo      | [calendly.com/vickyfu9/30min](https://calendly.com/vickyfu9/30min) |\n| 💬 Community Telegram | [t.me/blockrunAI](https://t.me/blockrunAI)                         |\n| 🐦 X / Twitter        | [x.com/BlockRunAI](https://x.com/BlockRunAI)                       |\n| 📱 Founder Telegram   | [@bc1max](https://t.me/bc1max)                                     |\n| ✉️ Email              | vicky@blockrun.ai                                                  |\n\n---\n\n## 📚 More Resources\n\n| Resource                                     | Description              |\n| -------------------------------------------- | ------------------------ |\n| [Documentation](https://blockrun.ai/docs)    | Full docs                |\n| [Model Pricing](https://blockrun.ai/models)  | All models & prices      |\n| [Routing Profiles](docs/routing-profiles.md) | ECO/AUTO/PREMIUM details |\n| [Architecture](docs/architecture.md)         | Technical deep dive      |\n| [Configuration](docs/configuration.md)       | Environment variables    |\n| [vs OpenRouter](docs/vs-openrouter.md)       | Why ClawRouter wins      |\n| [Features](docs/features.md)                 | All features             |\n| [Troubleshooting](docs/troubleshooting.md)   | Common issues            |\n\n---\n\n<div align=\"center\">\n\n**MIT License** · [BlockRun](https://blockrun.ai) — Pay-per-request AI infrastructure\n\n⭐ If ClawRouter saves you money, consider starring the repo!\n\n</div>\n","readmeFilename":"README.md"}