Naar hoofdinhoud gaan
ClawRouter geeft OpenClaw één beleidsgebonden sleutel voor meerdere upstream modelproviders. De gebundelde Plugin ontdekt alleen de modellen die voor die sleutel zijn toegestaan, routeert elk model via het gedeclareerde protocol en rapporteert het budget van de sleutel en het geaggregeerde gebruik op de gebruiksoppervlakken van OpenClaw. Je installeert of authenticeert niet elke upstream provider-Plugin op de OpenClaw-host. Upstream inloggegevens en providerspecifieke forwarding blijven in ClawRouter. OpenClaw heeft alleen de gebundelde @openclaw/clawrouter-Plugin nodig en een uitgegeven ClawRouter-inloggegeven.
EigenschapWaarde
Providerclawrouter
Pakket@openclaw/clawrouter
AuthenticatieCLAWROUTER_API_KEY
Standaard-URLhttps://clawrouter.openclaw.ai
ModelcatalogusInloggegeven-gebonden via /v1/catalog
Quota’sMaandelijks budget en gebruik via /v1/usage

​
Aan de slag

1

Vraag een gebonden inloggegeven aan

Vraag je ClawRouter-beheerder om een inloggegeven waarvan het beleid de providers, modellen en het maandelijkse budget bevat die je moet gebruiken. Inloggegevens worden één keer getoond wanneer ze worden uitgegeven.
2

Configureer OpenClaw

export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
De Plugin is gebundeld met OpenClaw. Als je configuratie plugins.allow instelt, voeg dan clawrouter aan die lijst toe voordat je de Plugin inschakelt. Stel voor een aangepaste deployment models.providers.clawrouter.baseUrl in op de ClawRouter-origin; de standaardwaarde is https://clawrouter.openclaw.ai.
3

Toegestane modellen weergeven

openclaw models list --all --provider clawrouter
Gebruik de geretourneerde modelreferenties exact zoals weergegeven. Ze behouden de upstream namespace, zoals clawrouter/openai/..., clawrouter/anthropic/... of clawrouter/google/.... Als agents.defaults.models in je configuratie een allowlist is, voeg dan elke geselecteerde ClawRouter-referentie eraan toe.
4

Selecteer een model

openclaw models set clawrouter/<provider>/<model>
Je kunt ook een geretourneerd model voor één run selecteren met openclaw agent --model clawrouter/<provider>/<model> --message "...".

​
Modeldetectie

GET /v1/catalog is de bron van waarheid. OpenClaw levert geen tweede, vaste lijst met ClawRouter-modellen. Een model dat in ClawRouter is geconfigureerd verschijnt wanneer:
  • het beleid van het inloggegeven de provider toestaat;
  • de providerverbinding is ingeschakeld en gereed is;
  • het catalogusmodel een ondersteunde LLM-capability adverteert; en
  • de catalogus een transportcontract blootlegt dat door de Plugin wordt ondersteund.
Het toevoegen van een ander model aan een ondersteunde ClawRouter-provider vereist daarom geen OpenClaw-release of een andere provider-Plugin. De volgende catalogusverversing ontdekt het. Een model dat een nieuw wire-protocol nodig heeft, vereist ondersteuning in de ClawRouter-Plugin voordat OpenClaw het adverteert.

​
Protocol en provider-Plugins

Je hoeft niet de authenticatie-Plugin van elk upstream bedrijf te installeren. ClawRouter beheert upstream inloggegevens; de catalogus vertelt OpenClaw welk transport moet worden gebruikt. De Plugin ondersteunt:
CatalogusrouteOpenClaw-transport
OpenAI-compatibele chatopenai-completions
OpenAI-compatibele Responsesopenai-responses
Native Anthropic Messagesanthropic-messages
Native Google Gemini-streaminggoogle-generative-ai
De Plugin past ook het bijpassende replay- en tool-schemabeleid toe voor die families. Catalogusrijen die een ander request-/streamformaat gebruiken, worden opzettelijk niet geadverteerd als OpenClaw-tekstmodellen. Normaliseer die providers naar een van de ondersteunde contracten in ClawRouter in plaats van een incompatibele payload te verzenden.

​
Quota’s en gebruik

De /v1/usage-respons van ClawRouter voedt de normale gebruiksoppervlakken voor OpenClaw-providers. /status en gerelateerde dashboardstatus tonen het maandelijkse budgetvenster wanneer de sleutel een limiet heeft, plus totalen voor requests, tokens en uitgaven. Ongemeten sleutels tonen nog steeds geaggregeerd gebruik zonder percentagevenster. Quota-opzoeking gebruikt dezelfde gebonden sleutel als modeldetectie. Een mislukte quota-opzoeking blokkeert de uitvoering van modellen niet. Controleer de live momentopname met: 
openclaw status --usage
openclaw models status
Dezelfde providermomentopname is beschikbaar voor /status in chat en de gebruiks-UI van OpenClaw. Het budget geldt voor het hele beleid, dus requests van een andere client die hetzelfde ClawRouter-beleid gebruikt, kunnen het resterende percentage wijzigen.

​
Probleemoplossing

SymptoomControle
Geen ClawRouter-modellenBevestig dat de Plugin is ingeschakeld en toegestaan door plugins.allow, en controleer daarna of het inloggegeven actief is en ten minste één gereedstaande provider toestaat.
Een geconfigureerd ClawRouter-model ontbreektInspecteer de /v1/catalog-capability en route-indeling ervan. Niet-ondersteunde transportcontracten worden opzettelijk gefilterd.
Unknown model: clawrouter/...Voeg de exacte catalogusreferentie toe aan agents.defaults.models wanneer die configuratiemap als allowlist wordt gebruikt.
401 of 403 van catalogus of gebruikGeef het ClawRouter-inloggegeven opnieuw uit of pas de scope ervan aan; OpenClaw valt niet terug op upstream providersleutels.
Modelaanroep mislukt na detectieControleer de providerverbinding en upstream gezondheid in ClawRouter, en probeer het opnieuw nadat de gereedheidsstatus is hersteld.
Gebruik heeft totalen maar geen percentageHet beleid is ongemeten; voeg een maandelijks budget toe in ClawRouter om een percentagevenster bloot te leggen.

​
Beveiligingsgedrag

  • Catalogusdetectie is gebonden aan de geconfigureerde proxysleutel en wordt per sleutel gecachet.
  • De proxysleutel wordt alleen toegevoegd bij request-dispatch; deze wordt niet opgeslagen in modelmetadata.
  • Native Anthropic- en Gemini-model-id’s worden alleen bij dispatch herschreven naar hun upstream id’s.
  • Niet-ondersteunde of niet-toegestane catalogusrijen falen gesloten en zijn niet selecteerbaar.

​
Gerelateerd

Modelproviders

Providerconfiguratie en modelselectie.

Gebruik bijhouden

OpenClaw-gebruik en statusoppervlakken.