| name | clawrouter |
| description | Hosted-gateway LLM router — save 87% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. <!-- br:models.free -->6<!-- /br:models.free --> free NVIDIA models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, and prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway. |
| triggers | ["clawrouter","claw router","@blockrun/clawrouter","blockrun gateway","blockrun llm router","blockrun ai gateway","blockrun.ai inference","save on llm costs blockrun","cheapest model blockrun","free nvidia models blockrun","x402 llm payment","usdc llm gateway","openrouter alternative"] |
| homepage | https://blockrun.ai/clawrouter.md |
| repository | https://github.com/BlockRunAI/ClawRouter |
| license | MIT |
| metadata | {"openclaw":{"emoji":"🦀","requires":{"config":["models.providers.blockrun"]},"install":[{"id":"node","kind":"node","package":"@blockrun/clawrouter","bins":["clawrouter"],"label":"Install ClawRouter (npm)"}]}} |
ClawRouter (Hermes)
Quick Start (Hermes plugin)
Recommended:
curl -fsSL https://raw.githubusercontent.com/BlockRunAI/ClawRouter-Hermes/main/scripts/install.sh | bash
Manual install, if you know Hermes' Python venv path:
~/.hermes/hermes-agent/venv/bin/python -m pip install -U hermes-plugin-clawrouter
hermes plugins enable clawrouter
hermes clawrouter setup
hermes clawrouter doctor
If plain pip install hermes-plugin-clawrouter fails with Debian/Ubuntu's
externally-managed-environment, do not use --break-system-packages; install
into Hermes' venv or use the one-command installer. The installer also checks
for Python, pip/venv support, pipx, and Node/npm/npx, and installs missing
basics through common OS package managers when available.
Then in a Hermes chat session:
- Pick model
blockrun/auto for smart routing across 71 models.
/clawrouter wallet — show address + USDC balance/clawrouter stats — proxy usage/clawrouter status — proxy health/clawrouter route <eco|auto|premium> — switch routing profile- Tools:
clawrouter_image_generate, clawrouter_video_generate, clawrouter_web_search
Wallet lives at ~/.openclaw/blockrun/mnemonic (shared with the upstream TS CLI — fund once, use everywhere). Override with BLOCKRUN_WALLET_KEY env for headless setups. Set CLAWROUTER_PROXY_URL to point at an externally-managed proxy.
Hosted-gateway LLM router that saves 88% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 71 models from 12 providers (6 free NVIDIA models). All billing flows through one USDC wallet; 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.
Source: · npm: · License: MIT.
71 models including: claude-fable-5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5, claude-sonnet-4.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gemini-3.1-pro, gemini-3.5-flash, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.7-max, and the curated free models (seed-oss-36b, nemotron-3-nano-omni-30b-a3b-reasoning [vision], mistral-nemotron, step-3.7-flash, nemotron-nano-9b-v2, nemotron-nano-12b-v2-vl [vision]).
