​

Models CLI

​

Jak działa wybór modelu

1. Główny model (agents.defaults.model.primary lub agents.defaults.model).
2. Fallbacki w agents.defaults.model.fallbacks (w podanej kolejności).
3. Failover uwierzytelniania dostawcy odbywa się w obrębie dostawcy przed przejściem do kolejnego modelu.

• agents.defaults.models to allowlista/katalog modeli, których OpenClaw może używać (wraz z aliasami).
• agents.defaults.imageModel jest używany tylko wtedy, gdy główny model nie może przyjmować obrazów.
• agents.defaults.pdfModel jest używany przez narzędzie pdf. Jeśli go pominięto, narzędzie przechodzi do agents.defaults.imageModel, a następnie do rozpoznanego modelu sesji/domyślnego.
• agents.defaults.imageGenerationModel jest używany przez współdzieloną funkcję generowania obrazów. Jeśli go pominięto, image_generate nadal może wywnioskować domyślny dostawca oparty na uwierzytelnianiu. Najpierw próbuje bieżącego domyślnego dostawcy, a następnie pozostałych zarejestrowanych dostawców generowania obrazów w kolejności identyfikatorów dostawców. Jeśli ustawisz konkretny provider/model, skonfiguruj też uwierzytelnianie/klucz API tego dostawcy.
• agents.defaults.videoGenerationModel jest używany przez współdzieloną funkcję generowania wideo. W przeciwieństwie do generowania obrazów, obecnie nie wywnioskuje domyślnego dostawcy. Ustaw jawny provider/model, taki jak qwen/wan2.6-t2v, i skonfiguruj również uwierzytelnianie/klucz API tego dostawcy.
• Domyślne ustawienia per agent mogą zastępować agents.defaults.model przez agents.list[].model wraz z powiązaniami (zobacz /concepts/multi-agent).

​

Szybka polityka modeli

• Ustaw model główny na najmocniejszy dostępny dla Ciebie model najnowszej generacji.
• Używaj fallbacków dla zadań wrażliwych na koszt/opóźnienia i mniej istotnych rozmów.
• W przypadku agentów z włączonymi narzędziami lub niezaufanych danych wejściowych unikaj starszych/słabszych poziomów modeli.

​

Onboarding (zalecane)

openclaw onboard

​

Klucze konfiguracji (przegląd)

• agents.defaults.model.primary i agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary i agents.defaults.imageModel.fallbacks
• agents.defaults.pdfModel.primary i agents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary i agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary i agents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models (allowlista + aliasy + parametry dostawców)
• models.providers (niestandardowi dostawcy zapisywani do models.json)

​

„Model is not allowed” (i dlaczego odpowiedzi się zatrzymują)

Model "provider/model" is not allowed. Use /model to list available models.

• Dodać model do agents.defaults.models, albo
• Wyczyścić allowlistę (usunąć agents.defaults.models), albo
• Wybrać model z /model list.

{
  agent: {
    model: { primary: "anthropic/claude-sonnet-4-6" },
    models: {
      "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
      "anthropic/claude-opus-4-6": { alias: "Opus" },
    },
  },
}

​

Przełączanie modeli na czacie (/model)

/model
/model list
/model 3
/model openai/gpt-5.4
/model status

• /model (i /model list) to zwarty, numerowany selektor (rodzina modeli + dostępni dostawcy).
• Na Discord /model i /models otwierają interaktywny selektor z listami rozwijanymi dostawców i modeli oraz krokiem Submit.
• /model <#> wybiera z tego selektora.
• /model natychmiast zapisuje nowy wybór sesji.
• Jeśli agent jest bezczynny, następne uruchomienie od razu użyje nowego modelu.
• Jeśli uruchomienie już trwa, OpenClaw oznacza przełączenie na żywo jako oczekujące i restartuje do nowego modelu dopiero w czystym punkcie ponowienia.
• Jeśli aktywność narzędzi lub generowanie odpowiedzi już się rozpoczęły, oczekujące przełączenie może pozostać w kolejce do późniejszej okazji ponowienia lub następnej tury użytkownika.
• /model status to widok szczegółowy (kandydaci uwierzytelniania i, gdy skonfigurowano, baseUrl endpointu dostawcy oraz tryb api).
• Referencje modeli są parsowane przez podział według pierwszego /. Użyj provider/model podczas wpisywania /model <ref>.
• Jeśli sam identyfikator modelu zawiera / (styl OpenRouter), musisz uwzględnić prefiks dostawcy (przykład: /model openrouter/moonshotai/kimi-k2).
• Jeśli pominiesz dostawcę, OpenClaw rozpoznaje dane wejściowe w tej kolejności:
  1. dopasowanie aliasu
  2. unikalne dopasowanie skonfigurowanego dostawcy dla tego dokładnego identyfikatora modelu bez prefiksu
  3. przestarzały fallback do skonfigurowanego domyślnego dostawcy Jeśli ten dostawca nie udostępnia już skonfigurowanego modelu domyślnego, OpenClaw zamiast tego przechodzi do pierwszego skonfigurowanego dostawcy/modelu, aby uniknąć prezentowania nieaktualnego domyślnego modelu z usuniętego dostawcy.

​

Polecenia CLI

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

​

models list

• --all: pełny katalog
• --local: tylko lokalni dostawcy
• --provider <name>: filtruj według dostawcy
• --plain: jeden model na linię
• --json: dane wyjściowe do odczytu maszynowego

​

models status

claude auth login
openclaw models status

​

Skanowanie (darmowe modele OpenRouter)

• --no-probe: pomiń aktywne sondy (tylko metadane)
• --min-params <b>: minimalna liczba parametrów (miliardy)
• --max-age-days <days>: pomiń starsze modele
• --provider <name>: filtr prefiksu dostawcy
• --max-candidates <n>: rozmiar listy fallbacków
• --set-default: ustaw agents.defaults.model.primary na pierwszy wybór
• --set-image: ustaw agents.defaults.imageModel.primary na pierwszy wybór obrazu

1. Obsługa obrazów
2. Opóźnienie narzędzi
3. Rozmiar kontekstu
4. Liczba parametrów

• Lista OpenRouter /models (filtr :free)
• Wymaga klucza API OpenRouter z profili uwierzytelniania lub OPENROUTER_API_KEY (zobacz /environment)
• Opcjonalne filtry: --max-age-days, --min-params, --provider, --max-candidates
• Sterowanie sondami: --timeout, --concurrency

​

Rejestr modeli (models.json)

• Niepuste baseUrl już obecne w models.json agenta ma pierwszeństwo.
• Niepuste apiKey w models.json agenta ma pierwszeństwo tylko wtedy, gdy ten dostawca nie jest zarządzany przez SecretRef w bieżącym kontekście konfiguracji/profilu uwierzytelniania.
• Wartości apiKey dostawców zarządzanych przez SecretRef są odświeżane na podstawie markerów źródła (ENV_VAR_NAME dla referencji env, secretref-managed dla referencji file/exec) zamiast utrwalać rozwiązane sekrety.
• Wartości nagłówków dostawców zarządzanych przez SecretRef są odświeżane na podstawie markerów źródła (secretref-env:ENV_VAR_NAME dla referencji env, secretref-managed dla referencji file/exec).
• Puste lub brakujące apiKey/baseUrl agenta przechodzą do konfiguracji models.providers.
• Inne pola dostawcy są odświeżane z konfiguracji i znormalizowanych danych katalogu.

​

Powiązane

• Model Providers — routing dostawców i uwierzytelnianie
• Model Failover — łańcuchy fallbacków
• Image Generation — konfiguracja modelu obrazu
• Configuration Reference — klucze konfiguracji modeli