Dostawcy modeli w OpenClaw — providerzy LLM i konfiguracja

Czym są dostawcy modeli?

Dostawcy modeli (model providers) w OpenClaw to integracje z usługami LLM — odrębne od kanałów komunikacyjnych. Referencje modeli używają formatu provider/model, na przykład openai/gpt-5.4 lub anthropic/claude-opus-4-6.

Podstawowe zasady

• Ustawienie agents.defaults.models tworzy allowlistę dozwolonych modeli
• Polecenia CLI: openclaw onboard, openclaw models list, openclaw models set <provider/model>
• contextWindow to natywne metadane modelu; contextTokens to efektywny limit runtime
• Wtyczki providerów mogą wstrzykiwać katalogi modeli przez registerProvider({ catalog })

Rotacja kluczy API

OpenClaw wspiera rotację kluczy dla wybranych providerów. Konfiguracja wielu kluczy odbywa się przez zmienne środowiskowe z priorytetem:

1. OPENCLAW_LIVE_<PROVIDER>_KEY — najwyższy priorytet
2. <PROVIDER>_API_KEYS — lista oddzielona przecinkami
3. <PROVIDER>_API_KEY — klucz główny
4. <PROVIDER>_API_KEY_* — numerowana lista

Żądania ponawiają się z kolejnym kluczem wyłącznie przy odpowiedziach rate-limit. Inne błędy powodują natychmiastowe niepowodzenie.

Wbudowani providerzy

OpenAI

Provider openai, autoryzacja przez OPENAI_API_KEY. Modele: openai/gpt-5.4, openai/gpt-5.4-pro. Domyślny transport: auto (WebSocket z fallbackiem na SSE). Obsługuje tryb /fast i priorytetowe przetwarzanie.

Anthropic

Provider anthropic, autoryzacja przez ANTHROPIC_API_KEY. Model: anthropic/claude-opus-4-6. Wspiera przełącznik /fast i mapowanie na service_tier.

Google Gemini

Provider google, autoryzacja przez GEMINI_API_KEY. Modele: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview. Obsługuje cache i automatyczne wykrywanie trafień cache'u.

Ollama (lokalne modele)

Provider ollama, bez wymaganej autoryzacji. Wykrywany na http://127.0.0.1:11434. Idealny do uruchamiania modeli open-source na własnym sprzęcie.

OpenRouter

Provider openrouter, autoryzacja przez OPENROUTER_API_KEY. Oferuje dostęp do wielu modeli przez jeden endpoint, w tym tryb openrouter/auto.

Inni wbudowani providerzy

OpenClaw obsługuje dziesiątki dodatkowych providerów, w tym: OpenCode, GitHub Copilot, Moonshot (Kimi), xAI, Mistral, Groq, Cerebras, Together, NVIDIA, Qwen Cloud, Volcano Engine, BytePlus, Z.AI, Vercel AI Gateway, Kilo Gateway i wielu innych.

Niestandardowi providerzy (lokalne proxy)

Konfiguracja przez models.providers pozwala podłączyć dowolny serwer kompatybilny z OpenAI API:

{
  "models": {
    "providers": {
      "lmstudio": {
        "baseUrl": "http://localhost:1234/v1",
        "apiKey": "LMSTUDIO_KEY",
        "api": "openai-completions",
        "models": [{
          "id": "my-local-model",
          "name": "Lokalny model",
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  }
}