Hermes Atlas
Models, providers & proxies

ClawRouter for Hermes

BlockRunAI/ClawRouter-Hermes

Plugin that adds BlockRun's ClawRouter LLM router to Hermes as one provider, paid per request

In short

ClawRouter for Hermes is a Python plugin, published as hermes-plugin-clawrouter, that adds BlockRun's ClawRouter LLM router to Hermes Agent as a single provider. The README puts the catalog at 86 models from 12 labs, billed per request by USDC wallet or account credit.

What ClawRouter for Hermes does

Stock Hermes needs a provider block and an API key for each model lab. This plugin replaces that with one local provider: the /model picker shows a curated catalog grouped by lab, and image, video and web-search tools bill through the same credential. A blockrun/auto option scores each request across 15 dimensions and picks the cheapest model judged capable of the job. Seven models are free on either payment rail.

There are two ways to pay. The wallet rail signs a USDC x402 micropayment per call from a local wallet on Solana or Base, with no sign-up. The API-key rail uses a brk_live key minted at user.blockrun.ai and funded by card, and when both a wallet and a key exist the key wins. The README says to enter the key in a terminal, never in a chat, and describes a fix for two Hermes auxiliary-vision issues, #38679 and #38685, using a single api_key provider on 127.0.0.1.

Key features

  • One Hermes provider covering models from OpenAI, Anthropic, Google, xAI, DeepSeek and others
  • blockrun/auto routing that picks the cheapest capable model per request
  • Wallet rail with USDC x402 micropayments on Solana or Base
  • API-key rail with account credit and per-request receipts
  • hermes-clawrouter login, account and logout commands, and a /clawrouter stats slash command
  • Seven free models usable before any payment

When to use it

  • Using Claude, GPT, Gemini and Grok from Hermes without opening an account with each lab
  • Letting an agent pay for its own model calls from a wallet it controls
  • Cutting model spend by routing simple requests to cheaper models

Who it is for: Hermes Agent users who want many models behind a single provider and prefer pay-per-request billing over per-lab subscriptions.

How it fits with Hermes Agent

A Python plugin built for NousResearch/hermes-agent that wraps the ClawRouter proxy as a Hermes provider.

Requirements: A local USDC wallet on Solana or Base, or a BlockRun account key (brk_live_...); the seven free models need neither

Note: Models other than the seven free ones are billed per request; the README lists a $0.001 per-call fee on the wallet rail and a 5.5% plus $0.30 fee on card top-ups.

FAQ

What is ClawRouter for Hermes?

It is a Hermes Agent plugin, published on PyPI as hermes-plugin-clawrouter, that connects Hermes to BlockRun's ClawRouter. Hermes then sees many models from many labs as one provider.

Does ClawRouter for Hermes work with Hermes Agent?

Yes, it is built for Hermes Agent. The README says one pip install gives Hermes the full catalog, plus image, video and web-search tools, behind a local provider.

Is ClawRouter for Hermes free and open source?

The plugin is MIT licensed. Seven models are free on both payment rails, while the other models are billed per request.

Similar models for Hermes Agent

All models

Related guides: How to install Hermes Agent