clawrouter

name: clawrouter description: Hosted-gateway LLM router — save 67% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 55+ models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 8 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       # installs the model-provider plugin + verifies wallet
hermes clawrouter doctor      # green = ready

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 55+ 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 67% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 55+ models from 9 providers (8 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: https://github.com/BlockRunAI/ClawRouter · npm: https://www.npmjs.com/package/@blockrun/clawrouter · License: MIT.

Data Flow

Your app → localhost proxy (ClawRouter) → https://blockrun.ai/api  (or sol.blockrun.ai/api)
                                              ↓
                                        OpenAI / Anthropic / Google / etc.
                                              ↓
                                        Response → back through proxy → your app

Sent to blockrun.ai on every request: the model name, the full prompt/messages body, sampling params (temperature, max_tokens, tools, etc.), and an X-PAYMENT header containing a signed x402 USDC micropayment.

Not sent: your wallet private key (only the detached payment signature is sent), any other local files, environment variables, or OpenClaw config beyond what's needed for this request.

Blockrun's privacy stance: https://blockrun.ai/privacy. Treat prompts the same way you'd treat prompts sent to any hosted LLM API (OpenAI, Anthropic, etc.) — do not send data you would not share with a third-party API provider.

Credentials & Local Key Storage

ClawRouter does not collect or forward third-party provider API keys. You do not supply OpenAI, Anthropic, Google, DeepSeek, xAI, or NVIDIA credentials — the blockrun.ai gateway owns those relationships.

What models.providers.blockrun stores (fully enumerated):

How and where keys are stored:

• Keys live in the OpenClaw user config file — typically ~/.config/openclaw/config.json on Linux, ~/Library/Application Support/openclaw/config.json on macOS, %APPDATA%\openclaw\config.json on Windows — under the models.providers.blockrun path.
• Written by OpenClaw's standard config writer with 0600 permissions on POSIX systems (owner read/write only).
• Stored in plaintext, the same way every OpenClaw provider's API key is stored. ClawRouter does not add an extra encryption layer; your filesystem permissions are the security boundary. If you require an encrypted keystore, run OpenClaw on an encrypted volume (FileVault, LUKS, BitLocker) or use a dedicated burner wallet funded only with what you intend to spend.
• Auto-generation uses @scure/bip39 to produce a 24-word mnemonic, then BIP-44 derivation for both chains. Source: src/wallet.ts.

Operational guidance: treat the wallet as a spending account with a small top-up, not a long-term store of value. Fund it with what you expect to spend on LLM calls. If the host machine is compromised, the wallet key is compromised — rotate and refund.

Supply-Chain Integrity

• Every release is tagged on GitHub: https://github.com/BlockRunAI/ClawRouter/releases
• Every release publishes to npm with a matching version: https://www.npmjs.com/package/@blockrun/clawrouter?activeTab=versions
• The skills/release/SKILL.md mandatory checklist enforces: same version in package.json, matching git tag, matching GitHub release, and matching npm publish.
• To verify locally: npm pack @blockrun/clawrouter@<version> and compare the tarball contents to the tagged commit.

Install

openclaw plugins install @blockrun/clawrouter

The structured install block above tells OpenClaw to install the auditable npm package @blockrun/clawrouter. Source for every version is on GitHub; every release is tagged.

Setup

# Enable smart routing (auto-picks cheapest model per request)
openclaw models set blockrun/auto

# Or pin a specific model
openclaw models set openai/gpt-4o

How Routing Works

ClawRouter classifies each request into one of four tiers:

• SIMPLE (40% of traffic) — factual lookups, greetings, translations → Gemini Flash ($0.60/M, 99% savings)
• MEDIUM (30%) — summaries, explanations, data extraction → DeepSeek Chat ($0.42/M, 99% savings)
• COMPLEX (20%) — code generation, multi-step analysis → Claude Opus ($75/M, best quality)
• REASONING (10%) — proofs, formal logic, multi-step math → o3 ($8/M, 89% savings)

Rules handle 80% of requests in <1ms. Only ambiguous queries hit the LLM classifier ($0.00003 per classification).

Available Models

55+ models including: gpt-5.5, gpt-5.4, gpt-5.4-mini, claude-opus-4.8, claude-opus-4.7, claude-sonnet-4.6, gemini-3.1-pro, gemini-3.5-flash, deepseek-v4-pro, deepseek-chat, glm-5.2, grok-4.3, grok-build-0.1, kimi-k2.7, minimax-m3, and the curated free models (gpt-oss-120b, gpt-oss-20b, mistral-large-3-675b, qwen3.5-122b-a10b, qwen3-next-80b-a3b-instruct, llama-4-maverick, seed-oss-36b, nemotron-3-nano-omni-30b-a3b-reasoning [vision]).

Built-in Agent Tools

In addition to LLM routing, ClawRouter exposes BlockRun's x402-gated data APIs as ready-to-use OpenClaw tools. Every tool is paid from the same USDC wallet — no extra setup, no extra API keys.

Market Data

Realtime prices and historical OHLC across every asset class. The agent should call these directly instead of scraping finance sites.

Image & Video Generation

Prediction Markets (Predexon)

Full prediction-market toolbox spanning Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + Binance for crypto candles. 57 endpoints (Predexon v2) exposed as 9 agent tools (8 named ergonomic wrappers + 1 catch-all):

• Markets & trading — events, markets list per venue, cross-venue search (markets/search), orderbooks, candlesticks (per-market and per-token), trades, positions, volume charts.
• Leaderboard & smart money — global + per-market leaderboards, smart-money positioning, top holders, smart-activity feed.
• Wallet analytics — full wallet profile, P&L time series, per-market breakdown, similar-wallet discovery, batch profiles, AND/OR filters.
• UMA oracle + wallet identity — UMA optimistic-oracle resolution status (uma/markets, uma/market/{conditionId}); wallet identity labels (ENS / Lens / exchange / risk tags), bulk identity, on-chain cluster discovery.

Pricing: $0.001 per market-data call, $0.005 per analytics / search / wallet call. See the predexon skill for the full endpoint reference.

Example Output

[ClawRouter] google/gemini-2.5-flash (SIMPLE, rules, confidence=0.92)
             Cost: $0.0025 | Baseline: $0.308 | Saved: 99.2%