Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

<p>Hermes gives your agent a body. ClawRouter gives it a way to pay.<br>
No provider accounts. No per-lab keys. Two rails, one provider block.<br><br>
<strong>One Hermes provider, <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models from 12 labs, paid per request —<br>
<strong>One Hermes provider, <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models from 12 labs, paid per request —<br>
USDC from a local wallet, or account credit on one BlockRun key.</strong><br><br>
<em><!-- br:models.free -->7<!-- /br:models.free --> models free — no crypto, no balance, no signup required.</em></p>

Expand Down Expand Up @@ -35,7 +35,7 @@ USDC from a local wallet, or account credit on one BlockRun key.</strong><br><br

</div>

> **hermes-plugin-clawrouter** wires [NousResearch Hermes](https://github.com/NousResearch/hermes-agent) into [ClawRouter](https://github.com/BlockRunAI/ClawRouter), the open-source LLM router built for autonomous agents. One `pip install` gives Hermes <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> chat models from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, Z.ai, MiniMax, Qwen, NVIDIA and more — plus image, video and web-search tools — behind a single local provider. Requests are scored across <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions --> dimensions and routed to the cheapest capable model in under 1ms, cutting inference cost by <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% versus pinning Claude Opus 5. Pay however suits you: sign a USDC [x402](https://x402.org) micropayment per call from a local wallet on Solana or Base, **or** sign up at [user.blockrun.ai](https://user.blockrun.ai), top up with a card and use one `brk_…` key. <!-- br:models.free -->7<!-- /br:models.free --> models cost nothing on either rail. MIT licensed.
> **hermes-plugin-clawrouter** wires [NousResearch Hermes](https://github.com/NousResearch/hermes-agent) into [ClawRouter](https://github.com/BlockRunAI/ClawRouter), the open-source LLM router built for autonomous agents. One `pip install` gives Hermes <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> chat models from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, Z.ai, MiniMax, Qwen, NVIDIA and more — plus image, video and web-search tools — behind a single local provider. Requests are scored across <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions --> dimensions and routed to the cheapest capable model in under 1ms, cutting inference cost by <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% versus pinning Claude Opus 5. Pay however suits you: sign a USDC [x402](https://x402.org) micropayment per call from a local wallet on Solana or Base, **or** sign up at [user.blockrun.ai](https://user.blockrun.ai), top up with a card and use one `brk_…` key. <!-- br:models.free -->7<!-- /br:models.free --> models cost nothing on either rail. MIT licensed.

---

Expand Down Expand Up @@ -97,7 +97,7 @@ ClawRouter collapses the whole thing into one provider:

| | Hermes + lab API keys | Hermes + OpenRouter | Local Ollama | **ClawRouter for Hermes** |
| ------------------- | --------------------------- | ------------------- | ------------------ | --------------------------------------------------------------------- |
| **Models** | One provider block per lab | Many | Whatever you host | **<!-- br:models.chatVisible -->88<!-- /br:models.chatVisible -->, one block** |
| **Models** | One provider block per lab | Many | Whatever you host | **<!-- br:models.chatVisible -->90<!-- /br:models.chatVisible -->, one block** |
| **Free tier** | No | Rate-limited | Free but local GPU | **<!-- br:models.free -->7<!-- /br:models.free --> models, no signup** |
| **Auth** | An API key per lab | Account + API key | None | **Wallet signature, or one BlockRun key** |
| **Payment** | Per-lab invoices | Credit card | Your electricity | **USDC per request, or account credit** |
Expand Down Expand Up @@ -176,7 +176,7 @@ Check either with `/clawrouter account` in chat, or `hermes-clawrouter account`

### Models

The `/model` picker carries a curated, provider-grouped slice of the catalog (small inline keyboards can't render <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> entries); every other model stays routable by full ID.
The `/model` picker carries a curated, provider-grouped slice of the catalog (small inline keyboards can't render <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> entries); every other model stays routable by full ID.

| Provider | In the picker |
| ----------------- | -------------------------------------------------------------------------------------------------- |
Expand Down Expand Up @@ -431,7 +431,7 @@ pytest

**ClawRouter for NousResearch Hermes**

You're here. <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models, smart routing, wallet or API key.
You're here. <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models, smart routing, wallet or API key.

`pip install hermes-plugin-clawrouter`

Expand All @@ -455,7 +455,7 @@ The canonical TypeScript proxy this plugin wraps. Works with any OpenAI-compatib

**BlockRun for Claude Code**

Claude Code on <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models — no Anthropic account, no rate limits, pay per request.
Claude Code on <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models — no Anthropic account, no rate limits, pay per request.

`curl -fsSL https://blockrun.ai/brcc-install | bash`

Expand Down
12 changes: 6 additions & 6 deletions brand-numbers.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,23 @@
"$schema": "https://blockrun.ai/brand/numbers.schema.json",
"version": 1,
"models": {
"chatVisible": 88,
"totalVisible": 115,
"chatVisible": 90,
"totalVisible": 117,
"free": 7,
"freeWithheld": 28,
"freeWithheld": 27,
"image": 12,
"video": 8,
"music": 1,
"speech": 5,
"soundfx": 1,
"withFallback": 28,
"withFallbackAllEntries": 68
"withFallback": 29,
"withFallbackAllEntries": 69
},
"clawrouter": {
"dimensions": 15,
"tiers": 4,
"profiles": 4,
"aliases": 276
"aliases": 295
},
"mcp": {
"tools": 19,
Expand Down
2 changes: 1 addition & 1 deletion docs/01-vision-analyze-connection-error-custom-provider.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ dominates latency exactly as before.

*If you'd rather not run and maintain your own local proxy, a ready-made option is
[ClawRouter](https://github.com/BlockRunAI/ClawRouter) — a one-command Hermes plugin
that serves a local OpenAI-compatible endpoint and gives you <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models — many
that serves a local OpenAI-compatible endpoint and gives you <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models — many
vision-capable — behind it. It's one way to implement Fix 2; the diagnosis above
stands regardless of which proxy you use.*

Expand Down
2 changes: 1 addition & 1 deletion docs/02-oauth-vision-provider-falls-back-to-auto.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ avoiding the broken OAuth branch.

*If you'd rather not assemble and maintain your own proxy,
[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is a ready-made Hermes plugin
that exposes <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models (MiniMax included) as a single local `api_key` provider — one
that exposes <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models (MiniMax included) as a single local `api_key` provider — one
way to implement the robust setup above. The diagnosis holds regardless of which proxy
you use; track the upstream fix in
[hermes-agent#38685](https://github.com/NousResearch/hermes-agent/issues/38685).*
Expand Down
8 changes: 4 additions & 4 deletions docs/03-one-endpoint-gpt-claude-gemini-deepseek.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Run GPT-5, Claude, Gemini and DeepSeek in Nous Hermes From One Endpoint"
description: "Stop wiring a separate provider, key and OAuth flow for every model in Hermes Agent. Point Hermes at one OpenAI-compatible gateway and switch between <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models from the /model picker."
description: "Stop wiring a separate provider, key and OAuth flow for every model in Hermes Agent. Point Hermes at one OpenAI-compatible gateway and switch between <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models from the /model picker."
keywords:
- hermes multiple llm providers
- hermes one endpoint all models
Expand Down Expand Up @@ -77,7 +77,7 @@ blockrun/minimax/minimax-m3
blockrun/moonshot/kimi-k3
blockrun/deepseek/deepseek-v4-pro
blockrun/free/nemotron-3.5-lightning
…72 curated entries (<!-- br:models.chatVisible@live -->88<!-- /br:models.chatVisible@live --> models via the gateway)
…72 curated entries (<!-- br:models.chatVisible@live -->90<!-- /br:models.chatVisible@live --> models via the gateway)
```

Set the model to `blockrun/auto` and the gateway's router picks a model per request
Expand Down Expand Up @@ -161,11 +161,11 @@ If you prefer a traditional key-based aggregator, the same one-endpoint config
pattern works — you just lose the non-custodial/pay-per-use property.

**How many models are available?**
<!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> across OpenAI, Anthropic, Google, DeepSeek, Moonshot/Kimi, xAI/Grok, MiniMax,
<!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> across OpenAI, Anthropic, Google, DeepSeek, Moonshot/Kimi, xAI/Grok, MiniMax,
Z.AI/GLM, Qwen, NVIDIA-hosted open models, and more — plus a few free tiers.

---

*Last reviewed against Hermes Agent v0.18.x. The single-endpoint pattern is provider-
agnostic; ClawRouter is the implementation that adds non-custodial pay-per-call
billing and <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models behind the one URL.*
billing and <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models behind the one URL.*
4 changes: 2 additions & 2 deletions docs/04-pay-per-call-llm-no-api-keys-hermes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Pay-Per-Call LLM Access for Hermes Agents — No API Keys, No Subscriptions"
description: "Funding and rotating an API key for every model your Hermes agent uses is a chore and a liability. Here's how to give Hermes keyless, pay-per-call access to <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models with USDC micropayments from a wallet you control."
description: "Funding and rotating an API key for every model your Hermes agent uses is a chore and a liability. Here's how to give Hermes keyless, pay-per-call access to <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models with USDC micropayments from a wallet you control."
keywords:
- hermes no api key llm
- hermes pay per use llm
Expand Down Expand Up @@ -49,7 +49,7 @@ Applied to LLM access, that means:

[ClawRouter](https://github.com/BlockRunAI/ClawRouter) implements this for Hermes. It
runs a local OpenAI-compatible gateway that signs an x402 payment for each upstream
call and routes to <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models:
call and routes to <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models:

```bash
curl -fsSL https://raw.githubusercontent.com/BlockRunAI/ClawRouter-Hermes/main/scripts/install.sh | bash
Expand Down
8 changes: 4 additions & 4 deletions src/clawrouter_hermes/skills/clawrouter/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
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 -->88<!-- /br:models.chatVisible --> models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. <!-- br:models.free -->7<!-- /br:models.free --> free 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.
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 -->90<!-- /br:models.chatVisible --> models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. <!-- br:models.free -->7<!-- /br:models.free --> free 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"
Expand Down Expand Up @@ -65,7 +65,7 @@ basics through common OS package managers when available.

Then in a Hermes chat session:

- Pick model `blockrun/auto` for smart routing across <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models.
- Pick model `blockrun/auto` for smart routing across <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models.
- `/clawrouter account` — which rail you're paying on (wallet or API key)
- `/clawrouter wallet` — show address + USDC balance (Solana and Base)
- `/clawrouter stats` — proxy usage
Expand Down Expand Up @@ -100,7 +100,7 @@ Wallet lives at `~/.openclaw/blockrun/mnemonic` (shared with the upstream TS CLI

---

Hosted-gateway LLM router that saves <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across <!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models from 12 providers (<!-- br:models.free -->7<!-- /br:models.free --> free models). Billing flows through one credential — a local USDC wallet, or one BlockRun API key from https://user.blockrun.ai. Either way you do not hold provider API keys.
Hosted-gateway LLM router that saves <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across <!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models from 12 providers (<!-- br:models.free -->7<!-- /br:models.free --> free models). Billing flows through one credential — a local USDC wallet, or one BlockRun API key from https://user.blockrun.ai. Either way 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.

Expand Down Expand Up @@ -192,7 +192,7 @@ Rules handle ~80% of requests in <1ms. Only ambiguous queries hit the LLM classi

## Available Models

<!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6-terra-pro, gpt-5.6-sol-pro, gpt-5.6-luna-pro, gpt-5.5, gpt-5.4, gpt-5.1, gemini-4-argon, gemini-3.1-pro, gemini-3.5-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash-vision-exp [vision], deepseek-v4.1-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.8-max, qwen3.7-max, mistral-large-4 [vision], hy4-preview, and the curated free models (nemotron-3.5-lightning, laguna-xs-2.1, north-mini-code, nemotron-3-nano-omni-30b-a3b-reasoning [vision], nemotron-3-ultra-550b, llama-3.2-11b-vision [vision]).
<!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6-terra-pro, gpt-5.6-sol-pro, gpt-5.6-luna-pro, gpt-5.5, gpt-5.4, gpt-5.1, gemini-4-argon, gemini-3.1-pro, gemini-3.5-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash-vision-exp [vision], deepseek-v4.1-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.8-max, qwen3.7-max, mistral-large-4 [vision], hy4-preview, and the curated free models (nemotron-3.5-lightning, laguna-xs-2.1, north-mini-code, nemotron-3-nano-omni-30b-a3b-reasoning [vision], nemotron-3-ultra-550b, llama-3.2-11b-vision [vision]).

## Model Prices — Look Them Up Live

Expand Down
Loading