Modell-Provider

Referenz für LLM-/Modell-Provider (nicht Chat-Kanäle wie WhatsApp/Telegram). Regeln zur Modellauswahl finden Sie unter Modelle.

Kurzregeln

Provider-Verhalten im Besitz von Plugins

Der Großteil der providerspezifischen Logik befindet sich in Provider-Plugins (registerProvider(...)), während OpenClaw die generische Inferenzschleife verwaltet. Plugins sind für Onboarding, Modellkataloge, die Zuordnung von Authentifizierungs-Umgebungsvariablen, Transport-/Konfigurationsnormalisierung, Bereinigung von Werkzeugschemas, Failover-Klassifizierung, OAuth-Aktualisierung, Nutzungsberichte, Denk-/Schlussfolgerungsprofile und mehr zuständig.

Die vollständige Liste der Provider-SDK-Hooks und Beispiele gebündelter Plugins finden Sie unter Provider-Plugins. Ein Provider, der einen vollständig benutzerdefinierten Anfrage-Executor benötigt, verwendet eine separate, tiefergehende Erweiterungsschnittstelle.

Rotation von API-Schlüsseln

Offizielle Provider-Plugins

Offizielle Provider-Plugins veröffentlichen ihre eigenen Modellkatalogeinträge. Diese Provider benötigen keine Modelleinträge unter models.providers; aktivieren Sie das Provider-Plugin, richten Sie die Authentifizierung ein und wählen Sie ein Modell. Verwenden Sie models.providers nur für explizite benutzerdefinierte Provider oder eng begrenzte Anfrageeinstellungen wie Zeitüberschreitungen.

OpenAI

• Provider: openai
• Authentifizierung: OPENAI_API_KEY
• Optionale Rotation: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2 sowie OPENCLAW_LIVE_OPENAI_KEY (einzelne Überschreibung)
• Standard bei neuer Einrichtung: openai/gpt-5.6; bei der direkten API wird die reine ID zu Sol aufgelöst.
• Beispielmodelle: openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
• Überprüfen Sie die Konto-/Modellverfügbarkeit mit openclaw models list --provider openai, falls sich eine bestimmte Installation oder ein API-Schlüssel anders verhält.
• CLI: openclaw onboard --auth-choice openai-api-key
• Der Standardtransport ist auto; OpenClaw übergibt die Transportauswahl an die gemeinsame Modell-Runtime.
• Überschreiben Sie ihn pro Modell über agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" oder "auto")
• Die priorisierte Verarbeitung von OpenAI kann über agents.defaults.models["openai/<model>"].params.serviceTier aktiviert werden
• /fast und params.fastMode ordnen direkte openai/*-Responses-Anfragen an api.openai.com service_tier=priority zu
• Verwenden Sie params.serviceTier, wenn Sie anstelle des gemeinsamen /fast-Schalters eine explizite Stufe wünschen
• Verborgene OpenClaw-Zuordnungsheader (originator, version, User-Agent) gelten nur für nativen OpenAI-Datenverkehr zu api.openai.com, nicht für generische OpenAI-kompatible Proxys
• Native OpenAI-Routen behalten außerdem Responses-store, Hinweise zum Prompt-Cache und die OpenAI-kompatible Formung der Reasoning-Nutzlast bei; Proxy-Routen nicht
• openai/gpt-5.3-codex-spark ist nur über ChatGPT/Codex OAuth verfügbar; direkte Routen mit OpenAI-API-Schlüssel und Azure-API-Schlüssel lehnen es ab

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

Falls die API-Organisation GPT-5.6 nicht bereitstellt, legen Sie openai/gpt-5.5 explizit fest. Normales Onboarding und erneute Authentifizierung behalten ein vorhandenes explizites primäres Modell bei; models auth login --set-default und models set sind die vorgesehenen Wege zum Ersetzen.

Anthropic

• Provider: anthropic
• Authentifizierung: ANTHROPIC_API_KEY
• Optionale Rotation: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2 sowie OPENCLAW_LIVE_ANTHROPIC_KEY (einzelne Überschreibung)
• Beispielmodell: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Direkte öffentliche Anthropic-Anfragen unterstützen den gemeinsamen /fast-Schalter und params.fastMode, einschließlich per API-Schlüssel und OAuth authentifiziertem Datenverkehr an api.anthropic.com; OpenClaw ordnet dies dem Anthropic-service_tier zu (auto gegenüber standard_only)
• Die bevorzugte Claude-CLI-Konfiguration behält die kanonische Modellreferenz bei und wählt das CLI- Backend separat aus: anthropic/claude-opus-4-8 mit modellspezifischem agentRuntime.id: "claude-cli". Veraltete claude-cli/claude-opus-4-7-Referenzen funktionieren aus Kompatibilitätsgründen weiterhin.

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

OpenAI ChatGPT/Codex OAuth

• Provider: openai
• Authentifizierung: OAuth (ChatGPT)
• Neue native Referenz für das Codex-App-Server-Harness: openai/gpt-5.6-sol
• Dokumentation zum nativen Codex-App-Server-Harness: Codex-Harness
• Veraltete Modellreferenzen: codex/gpt-*
• Plugin-Grenze: openai/* lädt das OpenAI-Plugin; die explizite Runtime-Richtlinie oder die vom Provider verwaltete effektive Route bestimmt, ob das native Codex-App-Server-Plugin ausgewählt wird.
• CLI: openclaw onboard --auth-choice openai oder openclaw models auth login --provider openai
• Der eingebettete ChatGPT-Responses-Transport von OpenClaw verwendet standardmäßig auto (zuerst WebSocket, SSE als Fallback).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier und params.fastMode sind explizit konfigurierte Einstellungen für eingebettete Anfragen. Sie sorgen dafür, dass die implizite Runtime-Auswahl bei OpenClaw verbleibt; natives Codex verwaltet seinen App-Server-Transport und seine Dienststufe selbst.
• Verborgene OpenClaw-Zuordnungsheader (originator, version, User-Agent) werden nur bei nativem Codex-Datenverkehr zu chatgpt.com/backend-api angehängt, nicht bei generischen OpenAI-kompatiblen Proxys
• Der gemeinsame /fast-Schalter bleibt als Runtime-Steuerung verfügbar; er unterscheidet sich von explizit konfigurierten Modellparametern.
• Der native Codex-Katalog kann abhängig vom Kontozugriff die exakten Referenzen openai/gpt-5.6-sol, openai/gpt-5.6-terra und openai/gpt-5.6-luna bereitstellen. Er wendet den Alias gpt-5.6 der direkten API nicht clientseitig an.
• openai/gpt-5.5 verwendet das native contextWindow = 400000 des Codex-Katalogs und standardmäßig zur Laufzeit contextTokens = 272000; überschreiben Sie die Runtime-Grenze mit models.providers.openai.models[].contextTokens
• Melden Sie sich für eine neue abonnementgestützte Einrichtung mit der openai-Authentifizierung an und verwenden Sie openai/gpt-5.6-sol. Wählen Sie explizit openai/gpt-5.5, wenn dieser Codex-Arbeitsbereich GPT-5.6 nicht bereitstellt.
• Verwenden Sie für Provider/Modell agentRuntime.id: "openclaw", damit eine ansonsten geeignete Route auf der integrierten Runtime verbleibt. Wenn die Runtime nicht festgelegt ist oder auto lautet, darf nur eine exakt offizielle HTTPS-Route, die mit Responses/ChatGPT kompatibel ist und keine explizite Anfrageüberschreibung aufweist, Codex implizit auswählen.
• Veraltete Codex-GPT-Referenzen sind veralteter Zustand und keine aktive Provider-Route. Verwenden Sie für neue Agent-Konfigurationen kanonische openai/*-Referenzen und führen Sie openclaw doctor --fix aus, um alte veraltete Codex-Modellreferenzen zu migrieren, ohne eine vorhandene explizite Auswahl von openai/gpt-5.5 zu aktualisieren.

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

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

Weitere gehostete Optionen im Abonnementstil

OpenCode

• Authentifizierung: OPENCODE_API_KEY (oder OPENCODE_ZEN_API_KEY)
• Zen-Laufzeit-Provider: opencode
• Go-Laufzeit-Provider: opencode-go
• Beispielmodelle: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen oder openclaw onboard --auth-choice opencode-go

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

Google Gemini (API-Schlüssel)

• Provider: google
• Authentifizierung: GEMINI_API_KEY
• Optionale Rotation: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, Rückgriff auf GOOGLE_API_KEY und OPENCLAW_LIVE_GEMINI_KEY (einzelne Überschreibung)
• Beispielmodelle: google/gemini-3.1-pro-preview, google/gemini-3.5-flash
• Kompatibilität: Eine ältere OpenClaw-Konfiguration mit google/gemini-3.1-flash-preview wird zu google/gemini-3-flash-preview normalisiert
• Alias: google/gemini-3.1-pro wird akzeptiert und zur aktiven Gemini-API-ID von Google, google/gemini-3.1-pro-preview, normalisiert
• CLI: openclaw onboard --auth-choice gemini-api-key
• Denkmodus: /think adaptive verwendet das dynamische Denken von Google. Gemini 3/3.1 lassen ein festes thinkingLevel weg; Gemini 2.5 sendet thinkingBudget: -1.
• Direkte Gemini-Ausführungen akzeptieren außerdem agents.defaults.models["google/<model>"].params.cachedContent (oder das ältere cached_content), um ein Provider-natives cachedContents/...-Handle weiterzuleiten; Gemini-Cachetreffer werden als OpenClaw-cacheRead angezeigt

Google Vertex und Gemini CLI

• Provider: google-vertex, google-gemini-cli
• Authentifizierung: Vertex verwendet gcloud ADC; Gemini CLI verwendet den eigenen OAuth-Ablauf

Gemini-CLI-OAuth wird als Bestandteil des gebündelten google-Plugins ausgeliefert.

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 verwendet standardmäßig stream-json. OpenClaw liest die Stream-Nachrichten des Assistenten und normalisiert stats.cached zu cacheRead; ältere Überschreibungen mit --output-format json lesen den Antworttext weiterhin aus response.

Z.AI (GLM)

• Provider: zai
• Authentifizierung: ZAI_API_KEY
• Beispielmodell: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Modellreferenzen verwenden die kanonische Provider-ID zai/*.
  • zai-api-key erkennt automatisch den passenden Z.AI-Endpunkt; zai-coding-global, zai-coding-cn, zai-global und zai-cn erzwingen eine bestimmte Oberfläche

Vercel AI Gateway

• Provider: vercel-ai-gateway
• Authentifizierung: AI_GATEWAY_API_KEY
• Beispielmodelle: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Weitere gebündelte Provider-Plugins

Wissenswerte Besonderheiten

Provider über models.providers (benutzerdefinierte/Basis-URL)

Verwenden Sie models.providers (oder models.json), um benutzerdefinierte Provider oder OpenAI-/Anthropic-kompatible Proxys hinzuzufügen.

Viele der unten aufgeführten mitgelieferten Provider-Plugins veröffentlichen bereits einen Standardkatalog. Verwenden Sie explizite Einträge unter models.providers.<id> nur, wenn Sie die standardmäßige Basis-URL, die Header oder die Modellliste überschreiben möchten.

Die Modellfähigkeitsprüfungen des Gateway lesen auch explizite Metadaten unter models.providers.<id>.models[]. Wenn ein benutzerdefiniertes oder Proxy-Modell Bilder akzeptiert, legen Sie für dieses Modell input: ["text", "image"] fest, damit WebChat und von Nodes stammende Anhangspfade Bilder als native Modelleingaben statt als reine Text-Medienreferenzen übergeben.

agents.defaults.models["provider/model"] steuert nur die Sichtbarkeit, Aliasse und modellspezifischen Metadaten für Agenten. Dadurch wird allein kein neues Laufzeitmodell registriert. Fügen Sie für Modelle benutzerdefinierter Provider außerdem models.providers.<provider>.models[] mit mindestens der passenden id hinzu.

Moonshot AI (Kimi)

Installieren Sie vor dem Onboarding @openclaw/moonshot-provider. Fügen Sie nur dann einen expliziten Eintrag models.providers.moonshot hinzu, wenn Sie die Basis-URL oder Modellmetadaten überschreiben müssen:

• Provider: moonshot
• Authentifizierung: MOONSHOT_API_KEY
• Beispielmodell: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key oder openclaw onboard --auth-choice moonshot-api-key-cn

Kimi-K2-Modell-IDs:

• 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" }],      },    },  },}

Die vollständige Einrichtungsanleitung finden Sie unter Moonshot AI (Kimi + Kimi Coding).

Kimi Coding

Kimi Coding verwendet den Anthropic-kompatiblen Endpunkt von Moonshot AI:

• Provider: kimi
• Authentifizierung: KIMI_API_KEY
• Beispielmodell: kimi/kimi-for-coding

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

Die älteren Modell-IDs kimi/kimi-code und kimi/k2p5 werden aus Kompatibilitätsgründen weiterhin akzeptiert und auf die stabile API-Modell-ID von Kimi normalisiert.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) bietet in China Zugriff auf Doubao und weitere Modelle.

• Provider: volcengine (Programmierung: volcengine-plan)
• Authentifizierung: VOLCANO_ENGINE_API_KEY
• Beispielmodell: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

Beim Onboarding wird standardmäßig die Programmieroberfläche verwendet, gleichzeitig wird jedoch auch der allgemeine Katalog volcengine/* registriert.

In den Modellauswahlmenüs für Onboarding und Konfiguration bevorzugt die Volcengine-Authentifizierungsoption sowohl Zeilen mit volcengine/* als auch mit volcengine-plan/*. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, statt ein leeres, auf den Provider beschränktes Auswahlmenü anzuzeigen.

BytePlus (International)

BytePlus ARK bietet internationalen Benutzern Zugriff auf dieselben Modelle wie Volcano Engine.

• Provider: byteplus (Programmierung: byteplus-plan)
• Authentifizierung: BYTEPLUS_API_KEY
• Beispielmodell: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

Beim Onboarding wird standardmäßig die Programmieroberfläche verwendet, gleichzeitig wird jedoch auch der allgemeine Katalog byteplus/* registriert.

In den Modellauswahlmenüs für Onboarding und Konfiguration bevorzugt die BytePlus-Authentifizierungsoption sowohl Zeilen mit byteplus/* als auch mit byteplus-plan/*. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, statt ein leeres, auf den Provider beschränktes Auswahlmenü anzuzeigen.

Synthetic

Synthetic stellt hinter dem Provider synthetic Anthropic-kompatible Modelle bereit:

• Provider: synthetic
• Authentifizierung: SYNTHETIC_API_KEY
• Beispielmodell: 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 wird über models.providers konfiguriert, da es benutzerdefinierte Endpunkte verwendet:

• MiniMax OAuth (Global): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax-API-Schlüssel (Global): --auth-choice minimax-global-api
• MiniMax-API-Schlüssel (CN): --auth-choice minimax-cn-api
• Authentifizierung: MINIMAX_API_KEY für minimax; MINIMAX_OAUTH_TOKEN oder MINIMAX_API_KEY für minimax-portal

Einrichtungsdetails, Modelloptionen und Konfigurationsausschnitte finden Sie unter /providers/minimax.

Aufteilung der Plugin-eigenen Fähigkeiten:

• Die Standardwerte für Text/Chat verbleiben bei minimax/MiniMax-M3
• Die Bilderzeugung erfolgt über minimax/image-01 oder minimax-portal/image-01
• Das Bildverständnis erfolgt auf beiden MiniMax-Authentifizierungspfaden über das Plugin-eigene MiniMax-VL-01
• Die Websuche verbleibt bei der Provider-ID minimax

LM Studio

LM Studio wird als mitgeliefertes Provider-Plugin ausgeliefert, das die native API verwendet:

• Provider: lmstudio
• Authentifizierung: LM_API_TOKEN
• Standardmäßige Basis-URL für Inferenz: http://localhost:1234/v1

Legen Sie anschließend ein Modell fest (ersetzen Sie es durch eine der von http://localhost:1234/api/v1/models zurückgegebenen IDs):

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

OpenClaw verwendet die nativen Endpunkte /api/v1/models und /api/v1/models/load von LM Studio für die Erkennung und das automatische Laden sowie standardmäßig /v1/chat/completions für die Inferenz. Wenn LM Studio das JIT-Laden, die TTL und das automatische Entfernen selbst über den Modelllebenszyklus verwalten soll, legen Sie models.providers.lmstudio.params.preload: false fest. Informationen zur Einrichtung und Fehlerbehebung finden Sie unter /providers/lmstudio.

Ollama

Ollama wird als mitgeliefertes Provider-Plugin ausgeliefert und verwendet die native Ollama-API:

• Provider: ollama
• Authentifizierung: Nicht erforderlich (lokaler Server)
• Beispielmodell: ollama/llama3.3
• Installation: https://ollama.com/download

# Installieren Sie Ollama und laden Sie anschließend ein Modell herunter:ollama pull llama3.3

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

Ollama wird lokal unter http://127.0.0.1:11434 erkannt, wenn Sie es mit OLLAMA_API_KEY aktivieren. Das mitgelieferte Provider-Plugin fügt Ollama direkt zu openclaw onboard und dem Modellauswahlmenü hinzu. Informationen zu Onboarding, Cloud-/lokalem Modus und benutzerdefinierter Konfiguration finden Sie unter /providers/ollama.

vLLM

vLLM wird als mitgeliefertes Provider-Plugin für lokale/selbst gehostete OpenAI-kompatible Server ausgeliefert:

• Provider: vllm
• Authentifizierung: Optional (abhängig von Ihrem Server)
• Standardmäßige Basis-URL: http://127.0.0.1:8000/v1

So aktivieren Sie die automatische lokale Erkennung (jeder Wert funktioniert, wenn Ihr Server keine Authentifizierung erzwingt):

export VLLM_API_KEY="vllm-local"

Legen Sie anschließend ein Modell fest (ersetzen Sie es durch eine der von /v1/models zurückgegebenen IDs):

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

Weitere Informationen finden Sie unter /providers/vllm.

SGLang

SGLang wird als mitgeliefertes Provider-Plugin für schnelle, selbst gehostete OpenAI-kompatible Server ausgeliefert:

• Provider: sglang
• Authentifizierung: Optional (abhängig von Ihrem Server)
• Standardmäßige Basis-URL: http://127.0.0.1:30000/v1

So aktivieren Sie die automatische lokale Erkennung (jeder Wert funktioniert, wenn Ihr Server keine Authentifizierung erzwingt):

export SGLANG_API_KEY="sglang-local"

Legen Sie anschließend ein Modell fest (ersetzen Sie es durch eine der von /v1/models zurückgegebenen IDs):

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

Weitere Informationen finden Sie unter /providers/sglang.

Lokale Proxys (LM Studio, vLLM, LiteLLM usw.)

Beispiel (OpenAI-kompatibel):

{  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,          },        ],      },    },  },}

CLI-Beispiele

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

Siehe auch: Konfiguration für vollständige Konfigurationsbeispiele.

Verwandte Themen

• Konfigurationsreferenz - Schlüssel für die Modellkonfiguration
• Modell-Failover - Fallback-Ketten und Wiederholungsverhalten
• Modelle - Modellkonfiguration und Aliasse
• Provider - Einrichtungsanleitungen für einzelne Provider