Konfiguracja modeli w OpenClaw — wybór, aliasy i polecenia

Kolejność wyboru modeli

OpenClaw priorytetyzuje modele sekwencyjnie: najpierw model główny, potem modele zapasowe (fallback) w kolejności, a rotacja uwierzytelniania w ramach providera następuje przed przejściem do kolejnej opcji.

Kluczowe ustawienia konfiguracji

• agents.defaults.models — pełni rolę allowlisty/katalogu dostępnych modeli i aliasów
• agents.defaults.imageModel — aktywowany, gdy model główny nie obsługuje obrazów
• agents.defaults.pdfModel — wykorzystywany przez narzędzie PDF
• agents.defaults.imageGenerationModel — generowanie obrazów
• agents.defaults.musicGenerationModel — generowanie muzyki
• agents.defaults.videoGenerationModel — generowanie wideo

Polityka wyboru modeli

Silne modele najnowszej generacji powinny służyć jako główny wybór. Modele zapasowe obsługują zadania o niższym priorytecie lub wrażliwe na koszty. Agenty korzystające z narzędzi powinny unikać słabszych modeli.

Onboarding

Polecenie openclaw onboard konfiguruje modele i uwierzytelnianie bez ręcznej edycji konfiguracji, wspierając providerów OpenAI Code i Anthropic.

Przełączanie modeli w czacie

Polecenie /model umożliwia zmianę modelu na poziomie sesji:

/model list     # Wyświetl dostępne modele
/model <#>      # Wybierz model po numerze
/model status   # Szczegóły konfiguracji i kandydaci auth

Gdy identyfikator modelu zawiera ukośnik, wymagany jest prefiks providera.

Polecenia CLI

openclaw models list       # Wyświetl skonfigurowane modele
openclaw models status     # Pokaż model główny, fallbacki i auth
openclaw models set <provider/model>   # Zmień model główny
openclaw models fallbacks  # Zarządzaj łańcuchem fallback
openclaw models aliases    # Twórz skróty modeli
openclaw models scan       # Przeszukaj darmowy katalog OpenRouter

Kontrola dostępu

Gdy agents.defaults.models jest skonfigurowane jako allowlista, wybór modelu spoza listy zwraca błąd informujący, że model nie jest dozwolony.

Rejestr modeli

Niestandardowi providerzy przechowywani są w pliku models.json w katalogu agenta. Plik ten jest scalany z aktywną konfiguracją, przy czym klucze API i endpointy traktowane są z priorytetem źródła.