Dostawcy modeli

Dokumentacja referencyjna dla dostawców LLM/modeli (nie kanałów czatu, takich jak WhatsApp/Telegram). Reguły wyboru modelu opisano w Modelach.

Szybkie reguły

Zachowanie dostawcy należące do Pluginu

Większość logiki specyficznej dla dostawcy znajduje się w Pluginach dostawców (registerProvider(...)), podczas gdy OpenClaw utrzymuje ogólną pętlę wnioskowania. Pluginy są właścicielami wdrażania, katalogów modeli, mapowania zmiennych środowiskowych uwierzytelniania, normalizacji transportu/konfiguracji, czyszczenia schematu narzędzi, klasyfikacji przełączania awaryjnego, odświeżania OAuth, raportowania użycia, profili myślenia/rozumowania i innych elementów.

Pełna lista hooków SDK dostawcy oraz przykłady dołączonych Pluginów znajdują się w Pluginach dostawców. Dostawca, który wymaga całkowicie niestandardowego wykonawcy żądań, jest osobną, głębszą powierzchnią rozszerzeń.

Rotacja kluczy API

Oficjalne Pluginy dostawców

Oficjalne Pluginy dostawców publikują własne wiersze katalogu modeli. Ci dostawcy nie wymagają wpisów modeli models.providers; włącz Plugin dostawcy, ustaw uwierzytelnianie i wybierz model. Używaj models.providers tylko dla jawnych niestandardowych dostawców lub wąskich ustawień żądań, takich jak limity czasu.

OpenAI

• Dostawca: openai
• Uwierzytelnianie: OPENAI_API_KEY
• Opcjonalna rotacja: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, plus OPENCLAW_LIVE_OPENAI_KEY (pojedyncze nadpisanie)
• Przykładowe modele: openai/gpt-5.5, openai/gpt-5.4-mini
• Zweryfikuj dostępność konta/modelu za pomocą openclaw models list --provider openai, jeśli konkretna instalacja lub klucz API zachowuje się inaczej.
• CLI: openclaw onboard --auth-choice openai-api-key
• Domyślny transport to auto; OpenClaw przekazuje wybór transportu do współdzielonego środowiska uruchomieniowego modeli.
• Nadpisz dla konkretnego modelu przez agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" lub "auto")
• Priorytetowe przetwarzanie OpenAI można włączyć przez agents.defaults.models["openai/<model>"].params.serviceTier
• /fast i params.fastMode mapują bezpośrednie żądania Responses openai/* na service_tier=priority w api.openai.com
• Użyj params.serviceTier, gdy chcesz jawnie wskazać poziom zamiast współdzielonego przełącznika /fast
• Ukryte nagłówki atrybucji OpenClaw (originator, version, User-Agent) mają zastosowanie tylko do natywnego ruchu OpenAI do api.openai.com, nie do ogólnych proxy zgodnych z OpenAI
• Natywne trasy OpenAI zachowują także store Responses, wskazówki cache promptów i kształtowanie payloadów zgodności rozumowania OpenAI; trasy proxy tego nie robią
• openai/gpt-5.3-codex-spark jest dostępny przez uwierzytelnianie subskrypcji OAuth ChatGPT/Codex, gdy Twoje zalogowane konto go udostępnia; OpenClaw nadal wyłącza bezpośrednie trasy klucza API OpenAI i klucza API Azure dla tego modelu, ponieważ te transporty go odrzucają

{  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

Anthropic

• Dostawca: anthropic
• Uwierzytelnianie: ANTHROPIC_API_KEY
• Opcjonalna rotacja: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, plus OPENCLAW_LIVE_ANTHROPIC_KEY (pojedyncze nadpisanie)
• Przykładowy model: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Bezpośrednie publiczne żądania Anthropic obsługują współdzielony przełącznik /fast i params.fastMode, w tym ruch z kluczem API i uwierzytelniony przez OAuth wysyłany do api.anthropic.com; OpenClaw mapuje to na service_tier Anthropic (auto kontra standard_only)
• Preferowana konfiguracja Claude CLI zachowuje kanoniczne odwołanie do modelu i wybiera backend CLI osobno: anthropic/claude-opus-4-8 z zakresem modelu agentRuntime.id: "claude-cli". Starsze odwołania claude-cli/claude-opus-4-7 nadal działają dla zgodności.

{  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}

OpenAI ChatGPT/Codex OAuth

• Dostawca: openai
• Uwierzytelnianie: OAuth (ChatGPT)
• Starsze odwołanie do modelu OpenAI Codex: openai/gpt-5.5
• Odwołanie do natywnego harnessu serwera aplikacji Codex: openai/gpt-5.5
• Dokumentacja natywnego harnessu serwera aplikacji Codex: harness Codex
• Starsze odwołania do modeli: codex/gpt-*
• Granica Pluginu: openai/* ładuje Plugin OpenAI; natywny Plugin serwera aplikacji Codex jest wybierany przez środowisko uruchomieniowe harnessu Codex.
• CLI: openclaw onboard --auth-choice openai lub openclaw models auth login --provider openai
• Domyślny transport to auto (najpierw WebSocket, zapasowo SSE)
• Nadpisz dla konkretnego modelu OpenAI Codex przez agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" lub "auto")
• params.serviceTier jest także przekazywane w natywnych żądaniach Codex Responses (chatgpt.com/backend-api)
• Ukryte nagłówki atrybucji OpenClaw (originator, version, User-Agent) są dołączane tylko do natywnego ruchu Codex do chatgpt.com/backend-api, nie do ogólnych proxy zgodnych z OpenAI
• Współdzieli ten sam przełącznik /fast i konfigurację params.fastMode co bezpośrednie openai/*; OpenClaw mapuje to na service_tier=priority
• openai/gpt-5.5 używa natywnego katalogu Codex contextWindow = 400000 i domyślnego środowiska uruchomieniowego contextTokens = 272000; nadpisz limit środowiska uruchomieniowego za pomocą models.providers.openai.models[].contextTokens
• Uwaga dotycząca polityki: OpenAI Codex OAuth jest jawnie obsługiwany dla zewnętrznych narzędzi/przepływów pracy, takich jak OpenClaw.
• W typowej trasie subskrypcji plus natywnego środowiska uruchomieniowego Codex zaloguj się uwierzytelnianiem openai i skonfiguruj openai/gpt-5.5; tury agenta OpenAI domyślnie wybierają Codex.
• Użyj agentRuntime.id: "openclaw" dostawcy/modelu tylko wtedy, gdy chcesz użyć wbudowanej trasy OpenClaw; w przeciwnym razie pozostaw openai/gpt-5.5 na domyślnym harnessie Codex.
• starsze odwołania GPT Codex są starszym stanem, a nie aktywną trasą dostawcy. Użyj openai/gpt-5.5 w natywnym środowisku uruchomieniowym Codex dla nowej konfiguracji agenta i uruchom openclaw doctor --fix, aby zmigrować stare starsze odwołania do modeli Codex na kanoniczne odwołania openai/*.

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

Inne hostowane opcje w stylu subskrypcji

OpenCode

• Uwierzytelnianie: OPENCODE_API_KEY (lub OPENCODE_ZEN_API_KEY)
• Dostawca środowiska uruchomieniowego Zen: opencode
• Dostawca środowiska uruchomieniowego Go: opencode-go
• Przykładowe modele: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen lub openclaw onboard --auth-choice opencode-go

{  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },}

Google Gemini (klucz API)

• Dostawca: google
• Uwierzytelnianie: GEMINI_API_KEY
• Opcjonalna rotacja: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, zapasowe GOOGLE_API_KEY oraz OPENCLAW_LIVE_GEMINI_KEY (pojedyncze nadpisanie)
• Przykładowe modele: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Zgodność: starsza konfiguracja OpenClaw używająca google/gemini-3.1-flash-preview jest normalizowana do google/gemini-3-flash-preview
• Alias: google/gemini-3.1-pro jest akceptowany i normalizowany do aktywnego identyfikatora Gemini API Google, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Myślenie: /think adaptive używa dynamicznego myślenia Google. Gemini 3/3.1 pomijają stałe thinkingLevel; Gemini 2.5 wysyła thinkingBudget: -1.
• Bezpośrednie uruchomienia Gemini akceptują też agents.defaults.models["google/<model>"].params.cachedContent (lub starsze cached_content), aby przekazać natywny dla dostawcy uchwyt cachedContents/...; trafienia pamięci podręcznej Gemini są widoczne w OpenClaw jako cacheRead

Google Vertex i Gemini CLI

• Dostawcy: google-vertex, google-gemini-cli
• Uwierzytelnianie: Vertex używa gcloud ADC; Gemini CLI używa swojego przepływu OAuth

Gemini CLI OAuth jest dostarczany jako część dołączonego pluginu google.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

Gemini CLI domyślnie używa stream-json. OpenClaw odczytuje komunikaty strumienia asystenta i normalizuje stats.cached do cacheRead; starsze nadpisania --output-format json nadal odczytują tekst odpowiedzi z response.

Z.AI (GLM)

• Dostawca: zai
• Uwierzytelnianie: ZAI_API_KEY
• Przykładowy model: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Odwołania do modeli używają kanonicznego identyfikatora dostawcy zai/*.
  • zai-api-key automatycznie wykrywa pasujący punkt końcowy Z.AI; zai-coding-global, zai-coding-cn, zai-global i zai-cn wymuszają konkretną powierzchnię

Vercel AI Gateway

• Dostawca: vercel-ai-gateway
• Uwierzytelnianie: AI_GATEWAY_API_KEY
• Przykładowe modele: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Inne dołączone pluginy dostawców

Warto znać osobliwości

Dostawcy przez models.providers (niestandardowy/bazowy URL)

Użyj models.providers (lub models.json), aby dodać niestandardowych dostawców albo proxy zgodne z OpenAI/Anthropic.

Wiele z poniższych dołączonych pluginów dostawców publikuje już domyślny katalog. Używaj jawnych wpisów models.providers.<id> tylko wtedy, gdy chcesz zastąpić domyślny bazowy URL, nagłówki lub listę modeli.

Kontrole możliwości modeli Gateway odczytują także jawne metadane models.providers.<id>.models[]. Jeśli model niestandardowy lub proxy akceptuje obrazy, ustaw input: ["text", "image"] dla tego modelu, aby ścieżki załączników z WebChat i pochodzące z Node przekazywały obrazy jako natywne wejścia modelu zamiast referencji do multimediów wyłącznie tekstowych.

agents.defaults.models["provider/model"] steruje tylko widocznością modeli, aliasami i metadanymi poszczególnych modeli dla agentów. Samo w sobie nie rejestruje nowego modelu uruchomieniowego. Dla niestandardowych modeli dostawcy dodaj także models.providers.<provider>.models[] z co najmniej pasującym id.

Moonshot AI (Kimi)

Zainstaluj @openclaw/moonshot-provider przed wdrożeniem. Dodaj jawny wpis models.providers.moonshot tylko wtedy, gdy musisz zastąpić bazowy URL lub metadane modelu:

• Dostawca: moonshot
• Uwierzytelnianie: MOONSHOT_API_KEY
• Przykładowy model: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key albo openclaw onboard --auth-choice moonshot-api-key-cn

Identyfikatory modeli Kimi K2:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  agents: {    defaults: { model: { primary: "moonshot/kimi-k2.6" } },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],      },    },  },}

Kodowanie Kimi

Kimi Coding używa punktu końcowego Moonshot AI zgodnego z Anthropic:

• Dostawca: kimi
• Uwierzytelnianie: KIMI_API_KEY
• Przykładowy model: kimi/kimi-for-coding

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: { model: { primary: "kimi/kimi-for-coding" } },  },}

Starsze kimi/kimi-code i kimi/k2p5 pozostają akceptowane jako identyfikatory modeli zgodności i normalizują się do stabilnego identyfikatora modelu API Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) zapewnia dostęp do Doubao i innych modeli w Chinach.

• Dostawca: volcengine (kodowanie: volcengine-plan)
• Uwierzytelnianie: VOLCANO_ENGINE_API_KEY
• Przykładowy model: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

Onboarding domyślnie używa powierzchni kodowania, ale ogólny katalog volcengine/* jest rejestrowany w tym samym czasie.

W selektorach modeli onboardingu/konfiguracji wybór uwierzytelniania Volcengine preferuje zarówno wiersze volcengine/*, jak i volcengine-plan/*. Jeśli te modele nie zostały jeszcze załadowane, OpenClaw wraca do niefiltrowanego katalogu zamiast pokazywać pusty selektor ograniczony do providera.

BytePlus (międzynarodowe)

BytePlus ARK zapewnia użytkownikom międzynarodowym dostęp do tych samych modeli co Volcano Engine.

• Provider: byteplus (kodowanie: byteplus-plan)
• Uwierzytelnianie: BYTEPLUS_API_KEY
• Przykładowy model: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{  agents: {    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },  },}

Onboarding domyślnie używa powierzchni kodowania, ale ogólny katalog byteplus/* jest rejestrowany w tym samym czasie.

W selektorach modeli onboardingu/konfiguracji wybór uwierzytelniania BytePlus preferuje zarówno wiersze byteplus/*, jak i byteplus-plan/*. Jeśli te modele nie zostały jeszcze załadowane, OpenClaw wraca do niefiltrowanego katalogu zamiast pokazywać pusty selektor ograniczony do providera.

Synthetic

Synthetic udostępnia modele zgodne z Anthropic za providerem synthetic:

• Provider: synthetic
• Uwierzytelnianie: SYNTHETIC_API_KEY
• Przykładowy model: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],      },    },  },}

MiniMax

MiniMax jest konfigurowany przez models.providers, ponieważ używa niestandardowych punktów końcowych:

• MiniMax OAuth (globalny): --auth-choice minimax-global-oauth
• MiniMax OAuth (Chiny): --auth-choice minimax-cn-oauth
• Klucz API MiniMax (globalny): --auth-choice minimax-global-api
• Klucz API MiniMax (Chiny): --auth-choice minimax-cn-api
• Uwierzytelnianie: MINIMAX_API_KEY dla minimax; MINIMAX_OAUTH_TOKEN lub MINIMAX_API_KEY dla minimax-portal

Szczegóły konfiguracji, opcje modeli i fragmenty konfiguracji znajdziesz w /providers/minimax.

Podział możliwości należący do pluginu:

• Domyślne ustawienia tekstu/czatu pozostają przy minimax/MiniMax-M3
• Generowanie obrazów to minimax/image-01 lub minimax-portal/image-01
• Rozumienie obrazów to należący do pluginu MiniMax-VL-01 na obu ścieżkach uwierzytelniania MiniMax
• Wyszukiwanie w sieci pozostaje na identyfikatorze providera minimax

LM Studio

LM Studio jest dostarczany jako wbudowany Plugin providera, który używa natywnego API:

• Provider: lmstudio
• Uwierzytelnianie: LM_API_TOKEN
• Domyślny bazowy URL inferencji: http://localhost:1234/v1

Następnie ustaw model (zastąp jednym z identyfikatorów zwróconych przez http://localhost:1234/api/v1/models):

{  agents: {    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },  },}

OpenClaw używa natywnych endpointów LM Studio /api/v1/models i /api/v1/models/load do wykrywania i automatycznego ładowania, a domyślnie /v1/chat/completions do inferencji. Jeśli chcesz, aby ładowanie JIT, TTL i automatyczne usuwanie z pamięci LM Studio zarządzały cyklem życia modelu, ustaw models.providers.lmstudio.params.preload: false. Konfigurację i rozwiązywanie problemów znajdziesz w /providers/lmstudio.

Ollama

Ollama jest dostarczana jako wbudowany Plugin providera i używa natywnego API Ollama:

• Provider: ollama
• Uwierzytelnianie: niewymagane (lokalny serwer)
• Przykładowy model: ollama/llama3.3
• Instalacja: https://ollama.com/download

# Install Ollama, then pull a model:ollama pull llama3.3

{  agents: {    defaults: { model: { primary: "ollama/llama3.3" } },  },}

Ollama jest wykrywana lokalnie pod adresem http://127.0.0.1:11434, gdy włączysz ją za pomocą OLLAMA_API_KEY, a wbudowany Plugin providera dodaje Ollama bezpośrednio do openclaw onboard i selektora modeli. Onboarding, tryb chmurowy/lokalny i konfigurację niestandardową znajdziesz w /providers/ollama.

vLLM

vLLM jest dostarczany jako wbudowany Plugin providera dla lokalnych/samodzielnie hostowanych serwerów zgodnych z OpenAI:

• Provider: vllm
• Uwierzytelnianie: opcjonalne (zależy od serwera)
• Domyślny bazowy URL: http://127.0.0.1:8000/v1

Aby lokalnie włączyć automatyczne wykrywanie (dowolna wartość działa, jeśli serwer nie wymusza uwierzytelniania):

export VLLM_API_KEY="vllm-local"

Następnie ustaw model (zastąp jednym z identyfikatorów zwróconych przez /v1/models):

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

Szczegóły znajdziesz w /providers/vllm.

SGLang

SGLang jest dostarczany jako wbudowany Plugin providera dla szybkich, samodzielnie hostowanych serwerów zgodnych z OpenAI:

• Provider: sglang
• Uwierzytelnianie: opcjonalne (zależy od serwera)
• Domyślny bazowy URL: http://127.0.0.1:30000/v1

Aby lokalnie włączyć automatyczne wykrywanie (dowolna wartość działa, jeśli serwer nie wymusza uwierzytelniania):

export SGLANG_API_KEY="sglang-local"

Następnie ustaw model (zastąp jednym z identyfikatorów zwróconych przez /v1/models):

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

Szczegóły znajdziesz w /providers/sglang.

Lokalne proxy (LM Studio, vLLM, LiteLLM itd.)

Przykład (zgodny z OpenAI):

{  agents: {    defaults: {      model: { primary: "lmstudio/my-local-model" },      models: { "lmstudio/my-local-model": { alias: "Local" } },    },  },  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        timeoutSeconds: 300,        models: [          {            id: "my-local-model",            name: "Local Model",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },}

Przykłady CLI

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

Zobacz też: Konfiguracja, aby poznać pełne przykłady konfiguracji.

Powiązane

• Dokumentacja konfiguracji - klucze konfiguracji modelu
• Przełączanie awaryjne modeli - łańcuchy awaryjne i zachowanie ponowień
• Modele - konfiguracja modeli i aliasy
• Providerzy - przewodniki konfiguracji dla poszczególnych providerów