// dokumentacja openclaw

Zarzadzanie modelami w OpenClaw — lista, wybor i konfiguracja

Przeglad zarzadzania modelami

OpenClaw obsluguje ponad 25 dostawcow modeli AI z ujednoliconym interfejsem konfiguracji. Kazdy model identyfikowany jest w formacie dostawca/model, co umozliwia szybkie przelaczanie miedzy dostawcami bez zmiany logiki agentow.

Dwuetapowa konfiguracja

Konfiguracja modelu sklada sie z dwoch krokow:

  1. Uwierzytelnienie — uruchom openclaw onboard i zaloguj sie do wybranego dostawcy. Kreator przeprowadzi Cie przez ustawienie klucza API lub logowanie OAuth.
  2. Ustawienie domyslnego modelu — w pliku konfiguracyjnym lub przez CLI:
# Przez konfiguracje JSON
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" }
    }
  }
}

# Przez CLI
openclaw models set anthropic/claude-opus-4-6

Listowanie dostepnych modeli

Aby wyswietlic wszystkie dostepne modele dla skonfigurowanych dostawcow:

# Wszystkie modele
openclaw models list

# Filtrowanie po dostawcy
openclaw models list | grep anthropic
openclaw models list | grep openai
openclaw models list | grep ollama

Zmiana modelu w trakcie sesji

Mozesz przelaczac modele bezposrednio w czacie OpenClaw:

# Przelacz na inny model
openclaw models set google/gemini-3.1-pro-preview

# Sprawdz aktualny model
openclaw models get

Format identyfikatorow modeli

Kazdy model jest identyfikowany w formacie dostawca/model. Oto przyklady dla najpopularniejszych dostawcow:

  • anthropic/claude-opus-4-6 — Anthropic Claude Opus 4.6
  • openai/gpt-5.4 — OpenAI GPT-5.4
  • google/gemini-3.1-pro-preview — Google Gemini 3.1 Pro
  • ollama/gemma4 — Ollama Gemma 4 (lokalny)
  • groq/llama-3.3-70b-versatile — Groq Llama 3.3
  • deepseek/deepseek-reasoner — DeepSeek Reasoner
  • mistral/mistral-large-latest — Mistral Large
  • xai/grok-4 — xAI Grok-4
  • together/meta-llama/Llama-3.3-70B-Instruct-Turbo — Together Llama
  • huggingface/deepseek-ai/DeepSeek-R1 — Hugging Face DeepSeek
  • nvidia/nvidia/nemotron-3-super-120b-a12b — NVIDIA Nemotron
  • openrouter/anthropic/claude-opus-4-6 — OpenRouter Claude
  • litellm/claude-opus-4-6 — LiteLLM Claude
  • amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0 — Bedrock Claude

Zaawansowane warianty dostawcow

Niektore dostawcy maja niejawne lub specjalizowane warianty integracji:

  • anthropic-vertex — automatyczna obsluga Anthropic na Google Vertex, gdy dostepne sa poswiadczenia GCP.
  • copilot-proxy — lokalny most do VS Code: openclaw onboard --auth-choice copilot-proxy
  • google-gemini-cli — nieoficjalny flow OAuth Gemini wymagajacy lokalnej instalacji CLI. Domyslny model: google-gemini-cli/gemini-3-flash-preview
  • openai-codex — dostep przez subskrypcje ChatGPT/Codex zamiast klucza API

Konfiguracja modeli fallback

Aby zapewnic ciaglosc dzialania agentow, skonfiguruj lancuch modeli zapasowych:

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: [
          "openai/gpt-5.4",
          "google/gemini-3.1-pro-preview",
          "ollama/gemma4"
        ]
      }
    }
  }
}

Jesli dostawca glowny bedzie niedostepny (np. z powodu limitu zapytan lub awarii API), OpenClaw automatycznie przelacze sie na kolejny model z listy. Dzieki temu agenty dzialaja nieprzerwanie.

Nadpisywanie parametrow per model

Mozesz dostosowac parametry dla konkretnych modeli:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          alias: "Claude",
          params: { cacheRetention: "long" }
        },
        "openai/gpt-5.4": {
          alias: "GPT",
          params: { serviceTier: "priority" }
        }
      }
    }
  }
}

Pelny katalog dostawcow

OpenClaw integruje sie z nastepujacymi dostawcami (lista stale sie rozszerza):

  • Glowni: Anthropic, OpenAI, Google, xAI, Mistral, Meta (przez Together/HF)
  • Specjalizowani: Groq, DeepSeek, Perplexity, Together AI, Hugging Face
  • Enterprise: Amazon Bedrock, NVIDIA, LiteLLM, OpenRouter, Cloudflare
  • Lokalni: Ollama, vLLM, SGLang, inferrs
  • Regionalni: BytePlus, Volcengine, Qwen, Moonshot AI
  • Niszowi: Arcee, fal, Kilocode, Venice (prywatnosc)

Szczegolowe instrukcje konfiguracji kazdego dostawcy znajdziesz na dedykowanych stronach dokumentacji.