Przejdź do głównej treści
ClawRouter daje OpenClaw jeden klucz ograniczony zasadami dla wielu nadrzędnych dostawców modeli. Dołączony Plugin wykrywa tylko modele dozwolone dla tego klucza, kieruje każdy model przez zadeklarowany protokół i raportuje budżet klucza oraz łączne użycie w powierzchniach użycia OpenClaw. Nie instalujesz ani nie uwierzytelniasz każdego nadrzędnego Plugin dostawcy na hoście OpenClaw. Poświadczenia nadrzędne i przekazywanie specyficzne dla dostawcy pozostają w ClawRouter. OpenClaw potrzebuje tylko dołączonego Plugin @openclaw/clawrouter oraz wydanego poświadczenia ClawRouter.
WłaściwośćWartość
Dostawcaclawrouter
Pakiet@openclaw/clawrouter
UwierzytelnianieCLAWROUTER_API_KEY
Domyślny URLhttps://clawrouter.openclaw.ai
Katalog modeliOgraniczony poświadczeniem przez /v1/catalog
LimityMiesięczny budżet i użycie przez /v1/usage

​
Pierwsze kroki

1

Get a scoped credential

Poproś administratora ClawRouter o poświadczenie, którego zasady obejmują dostawców, modele i miesięczny budżet, z których masz korzystać. Poświadczenia są ujawniane jednorazowo w momencie wydania.
2

Configure OpenClaw

export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
Plugin jest dołączony do OpenClaw. Jeśli Twoja konfiguracja ustawia plugins.allow, dodaj clawrouter do tej listy przed jego włączeniem. W przypadku niestandardowego wdrożenia ustaw models.providers.clawrouter.baseUrl na źródło ClawRouter; wartość domyślna to https://clawrouter.openclaw.ai.
3

List granted models

openclaw models list --all --provider clawrouter
Używaj zwróconych odwołań do modeli dokładnie tak, jak pokazano. Zachowują one nadrzędną przestrzeń nazw, taką jak clawrouter/openai/..., clawrouter/anthropic/... lub clawrouter/google/.... Jeśli agents.defaults.models jest listą dozwolonych w Twojej konfiguracji, dodaj do niej każde wybrane odwołanie ClawRouter.
4

Select a model

openclaw models set clawrouter/<provider>/<model>
Możesz też wybrać zwrócony model dla pojedynczego uruchomienia za pomocą openclaw agent --model clawrouter/<provider>/<model> --message "...".

​
Wykrywanie modeli

GET /v1/catalog jest źródłem prawdy. OpenClaw nie dostarcza drugiej, stałej listy modeli ClawRouter. Model skonfigurowany w ClawRouter pojawia się, gdy:
  • zasady poświadczenia przyznają dostęp do jego dostawcy;
  • połączenie dostawcy jest włączone i gotowe;
  • model katalogu ogłasza obsługiwaną zdolność LLM; oraz
  • katalog udostępnia kontrakt transportowy obsługiwany przez Plugin.
Dodanie kolejnego modelu do obsługiwanego dostawcy ClawRouter nie wymaga więc wydania OpenClaw ani kolejnego Plugin dostawcy. Następne odświeżenie katalogu go wykryje. Model, który wymaga nowego protokołu przewodowego, wymaga obsługi w Plugin ClawRouter, zanim OpenClaw go ogłosi.

​
Protokół i Plugin dostawcy

Nie musisz instalować Plugin uwierzytelniania każdej firmy nadrzędnej. ClawRouter posiada poświadczenia nadrzędne; jego katalog mówi OpenClaw, którego transportu użyć. Plugin obsługuje:
Trasa kataloguTransport OpenClaw
Czat zgodny z OpenAIopenai-completions
Responses zgodne z OpenAIopenai-responses
Natywne Anthropic Messagesanthropic-messages
Natywne strumieniowanie Google Geminigoogle-generative-ai
Plugin stosuje również pasujące zasady odtwarzania i schematu narzędzi dla tych rodzin. Wiersze katalogu używające innego formatu żądania/strumienia celowo nie są ogłaszane jako modele tekstowe OpenClaw. Normalizuj tych dostawców do jednego z obsługiwanych kontraktów w ClawRouter zamiast wysyłać niezgodny payload.

​
Limity i użycie

Odpowiedź /v1/usage z ClawRouter zasila standardowe powierzchnie użycia dostawcy OpenClaw. /status i powiązany status pulpitu pokazują miesięczne okno budżetu, gdy klucz ma limit, a także łączne wartości żądań, tokenów i wydatków. Klucze bez pomiaru nadal pokazują łączne użycie bez okna procentowego. Wyszukiwanie limitu używa tego samego ograniczonego klucza co wykrywanie modeli. Nieudane wyszukanie limitu nie blokuje wykonania modelu. Sprawdź bieżący zrzut za pomocą: 
openclaw status --usage
openclaw models status
Ten sam zrzut dostawcy jest dostępny dla /status na czacie i w interfejsie użycia OpenClaw. Budżet obejmuje całe zasady, więc żądania wykonane przez innego klienta używającego tych samych zasad ClawRouter mogą zmienić pozostały procent.

​
Rozwiązywanie problemów

ObjawSprawdź
Brak modeli ClawRouterPotwierdź, że Plugin jest włączony i dozwolony przez plugins.allow, a następnie sprawdź, czy poświadczenie jest aktywne i przyznaje dostęp do co najmniej jednego gotowego dostawcy.
Brakuje skonfigurowanego modelu ClawRouterSprawdź jego zdolność i format trasy w /v1/catalog. Nieobsługiwane kontrakty transportowe są celowo filtrowane.
Unknown model: clawrouter/...Dodaj dokładne odwołanie z katalogu do agents.defaults.models, gdy ta mapa konfiguracji jest używana jako lista dozwolonych.
401 lub 403 z katalogu albo użyciaWydaj ponownie albo zmień zakres poświadczenia ClawRouter; OpenClaw nie przełącza się awaryjnie na klucze nadrzędnych dostawców.
Wywołanie modelu kończy się niepowodzeniem po wykryciuSprawdź połączenie dostawcy i kondycję nadrzędną w ClawRouter, a następnie ponów próbę po przywróceniu stanu gotowości.
Użycie ma sumy, ale nie ma procentuZasady są niemierzone; dodaj miesięczny budżet w ClawRouter, aby udostępnić okno procentowe.

​
Zachowanie bezpieczeństwa

  • Wykrywanie katalogu jest ograniczone do skonfigurowanego klucza proxy i buforowane per klucz.
  • Klucz proxy jest dołączany tylko podczas wysyłania żądania; nie jest przechowywany w metadanych modelu.
  • Natywne identyfikatory modeli Anthropic i Gemini są przepisywane na ich identyfikatory nadrzędne tylko podczas wysyłania.
  • Nieobsługiwane lub nieprzyznane wiersze katalogu zawodzą w sposób zamknięty i nie można ich wybrać.

​
Powiązane

Model providers

Konfiguracja dostawcy i wybór modelu.

Usage tracking

Powierzchnie użycia i statusu OpenClaw.