Skip to content

Commit 4a354f7

Browse files
steipetesteipete
authored
feat(providers): add ClawRouter routing and quotas (#99658)
* feat(providers): add ClawRouter routing and quotas * docs(plugins): refresh Ollama inventory * test(plugins): register ClawRouter boundary coverage * docs(i18n): add ClawRouter glossary terms * docs(providers): expand ClawRouter setup guide
1 parent 28bbb43 commit 4a354f7

30 files changed

Lines changed: 1552 additions & 4 deletions

‎.github/labeler.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -359,6 +359,11 @@
359359
- any-glob-to-any-file:
360360
- "extensions/cerebras/**"
361361
- "docs/providers/cerebras.md"
362+
"extensions: clawrouter":
363+
- changed-files:
364+
- any-glob-to-any-file:
365+
- "extensions/clawrouter/**"
366+
- "docs/providers/clawrouter.md"
362367
"extensions: deepseek":
363368
- changed-files:
364369
- any-glob-to-any-file:

‎CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ Docs: https://docs.openclaw.ai
1616

1717
### Changes
1818

19+
- **ClawRouter routing and quotas:** add the bundled ClawRouter provider plugin with credential-scoped dynamic model discovery, OpenAI-compatible and native Anthropic/Gemini transports, and managed budget reporting across OpenClaw usage surfaces. (#99658)
1920
- **Model and provider coverage:** add GPT-5.6 support, use Nemotron Super's 1M context window, and preserve explicit OpenRouter authentication headers. (#98333, #98726, #98187) Thanks @steipete-oai, @eleqtrizit, @sunlit-deng, and @laurencebrown.
2021
- **CLI and node workflows:** add `openclaw attach`, node context-path support, actionable device-approval recovery guidance, and clearer plugin install exit diagnostics. (#96454, #97679, #98115, #98146, #98497) Thanks @anagnorisis2peripeteia, @obviyus, @wm0018, @welfo-beo, @RomneyDa, @Sanjays2402, and @vincentkoc.
2122
- **Cron and usage:** add exit-triggered schedules, detached session-targeted runs, an in-flight job doctor warning, and a built-in full usage footer. (#92037, #98755, #98620, #92657, #92877) Thanks @anagnorisis2peripeteia, @obviyus, @EthanSK, @masatohoshino, and @Marvinthebored.

‎docs/.i18n/glossary.zh-CN.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,22 @@
4343
"source": "ClawHub",
4444
"target": "ClawHub"
4545
},
46+
{
47+
"source": "ClawRouter (managed multi-provider routing)",
48+
"target": "ClawRouter（托管式多提供商路由）"
49+
},
50+
{
51+
"source": "ClawRouter",
52+
"target": "ClawRouter"
53+
},
54+
{
55+
"source": "ClawRouter plugin",
56+
"target": "ClawRouter 插件"
57+
},
58+
{
59+
"source": "clawrouter",
60+
"target": "clawrouter"
61+
},
4662
{
4763
"source": "OpenAI",
4864
"target": "OpenAI"

‎docs/concepts/model-providers.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -283,6 +283,7 @@ messages and normalizes `stats.cached` into `cacheRead`; legacy
283283
| Provider | Id | Auth env | Example model |
284284
| --------------------------------------- | -------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------- |
285285
| BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` |
286+
| ClawRouter | `clawrouter` | `CLAWROUTER_API_KEY` | `clawrouter/anthropic/claude-sonnet-4-6` |
286287
| Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-03-2025` |
287288
| GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - |
288289
| Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` or `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` |

‎docs/docs.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1428,6 +1428,7 @@
14281428
"providers/azure-speech",
14291429
"providers/cerebras",
14301430
"providers/chutes",
1431+
"providers/clawrouter",
14311432
"providers/cohere",
14321433
"providers/claude-max-api-proxy",
14331434
"providers/cloudflare-ai-gateway",

‎docs/docs_map.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5857,6 +5857,15 @@ Do not edit it by hand; run `pnpm docs:map:gen`.
58575857
- H2: Surface
58585858
- H2: Related docs
58595859

5860+
## plugins/reference/clawrouter.md
5861+
5862+
- Route: /plugins/reference/clawrouter
5863+
- Headings:
5864+
- H1: ClawRouter plugin
5865+
- H2: Distribution
5866+
- H2: Surface
5867+
- H2: Related docs
5868+
58605869
## plugins/reference/clickclack.md
58615870

58625871
- Route: /plugins/reference/clickclack
@@ -7272,6 +7281,18 @@ Do not edit it by hand; run `pnpm docs:map:gen`.
72727281
- H2: Notes
72737282
- H2: Related
72747283

7284+
## providers/clawrouter.md
7285+
7286+
- Route: /providers/clawrouter
7287+
- Headings:
7288+
- H2: Getting started
7289+
- H2: Model discovery
7290+
- H2: Protocol and provider plugins
7291+
- H2: Quotas and usage
7292+
- H2: Troubleshooting
7293+
- H2: Security behavior
7294+
- H2: Related
7295+
72757296
## providers/cloudflare-ai-gateway.md
72767297

72777298
- Route: /providers/cloudflare-ai-gateway

‎docs/plugins/plugin-inventory.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Each entry lists the package, distribution route, and description.
5151

5252
## Core npm package
5353

54-
59 plugins
54+
60 plugins
5555

5656
- **[admin-http-rpc](/plugins/reference/admin-http-rpc)** (`@openclaw/admin-http-rpc`) - included in OpenClaw. OpenClaw admin HTTP RPC endpoint.
5757

@@ -69,6 +69,8 @@ Each entry lists the package, distribution route, and description.
6969

7070
- **[canvas](/plugins/reference/canvas)** (`@openclaw/canvas-plugin`) - included in OpenClaw. Experimental Canvas control and A2UI rendering surfaces for paired nodes.
7171

72+
- **[clawrouter](/plugins/reference/clawrouter)** (`@openclaw/clawrouter`) - included in OpenClaw. Adds ClawRouter model provider support to OpenClaw.
73+
7274
- **[codex-supervisor](/plugins/reference/codex-supervisor)** (`@openclaw/codex-supervisor`) - included in OpenClaw. Supervise Codex app-server sessions from OpenClaw.
7375

7476
- **[cohere](/plugins/reference/cohere)** (`@openclaw/cohere-provider`) - included in OpenClaw; npm; ClawHub: `clawhub:@openclaw/cohere-provider`. OpenClaw Cohere provider plugin.

‎docs/plugins/reference.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,5 +15,5 @@ This page is generated from `extensions/*/package.json` and
1515
pnpm plugins:inventory:gen
1616
```
1717

18-
Use [Plugin inventory](/plugins/plugin-inventory) to browse all 129
18+
Use [Plugin inventory](/plugins/plugin-inventory) to browse all 130
1919
generated plugin reference pages by distribution, package, and description.

‎docs/plugins/reference/clawrouter.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
summary: "Adds ClawRouter model provider support to OpenClaw."
3+
read_when:
4+
- You are installing, configuring, or auditing the clawrouter plugin
5+
title: "ClawRouter plugin"
6+
---
7+
8+
# ClawRouter plugin
9+
10+
Adds ClawRouter model provider support to OpenClaw.
11+
12+
## Distribution
13+
14+
- Package: `@openclaw/clawrouter`
15+
- Install route: included in OpenClaw
16+
17+
## Surface
18+
19+
providers: clawrouter
20+
21+
## Related docs
22+
23+
- [clawrouter](/providers/clawrouter)

‎docs/plugins/reference/ollama.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Adds Ollama, Ollama Cloud model provider support to OpenClaw.
1616

1717
## Surface
1818

19-
providers: ollama, ollama-cloud; contracts: memoryEmbeddingProviders, webSearchProviders
19+
providers: ollama, ollama-cloud; contracts: memoryEmbeddingProviders, tools, webSearchProviders
2020

2121
## Related docs
2222

0 commit comments

Comments
 (0)