Modell-Provider

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

# Kurzregeln

# Plugin-eigenes Provider-Verhalten

Die meiste Provider-spezifische Logik befindet sich in Provider-Plugins (registerProvider(...)), während OpenClaw die generische Inferenzschleife beibehält. Plugins besitzen Onboarding, Modellkataloge, Auth-Umgebungsvariablen-Mapping, Transport-/Konfigurationsnormalisierung, Tool-Schema-Bereinigung, Failover-Klassifizierung, OAuth-Aktualisierung, Nutzungsberichte, Denk-/Reasoning-Profile und mehr.

Die vollständige Liste der Provider-SDK-Hooks und Beispiele für gebündelte Plugins finden Sie unter Provider-Plugins. Ein Provider, der einen vollständig benutzerdefinierten Request-Executor benötigt, ist eine separate, tiefere Erweiterungsfläche.

# API-Schlüsselrotation

# Integrierte Provider (pi-ai-Katalog)

OpenClaw wird mit dem pi-ai-Katalog ausgeliefert. Diese Provider benötigen keine models.providers-Konfiguration; setzen Sie einfach Authentifizierung und wählen Sie ein Modell.

# OpenAI

• Provider: openai
• Authentifizierung: OPENAI_API_KEY
• Optionale Rotation: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, plus OPENCLAW_LIVE_OPENAI_KEY (einzelner Override)
• Beispielmodelle: openai/gpt-5.5, openai/gpt-5.4-mini
• Prüfen Sie Konto-/Modellverfügbarkeit mit openclaw models list --provider openai, wenn eine bestimmte Installation oder ein API-Schlüssel sich anders verhält.
• CLI: openclaw onboard --auth-choice openai-api-key
• Der Default-Transport ist auto (WebSocket zuerst, SSE-Fallback)
• Pro Modell über agents.defaults.models["openai/<model>"].params.transport überschreiben ("sse", "websocket" oder "auto")
• OpenAI Responses WebSocket-Warm-up ist standardmäßig über params.openaiWsWarmup aktiviert (true/false)
• OpenAI-Prioritätsverarbeitung kann über agents.defaults.models["openai/<model>"].params.serviceTier aktiviert werden
• /fast und params.fastMode mappen direkte openai/*-Responses-Requests auf service_tier=priority auf api.openai.com
• Verwenden Sie params.serviceTier, wenn Sie statt des gemeinsamen /fast-Toggles eine explizite Stufe möchten
• Verborgene OpenClaw-Attributionsheader (originator, version, User-Agent) gelten nur für nativen OpenAI-Traffic zu api.openai.com, nicht für generische OpenAI-kompatible Proxys
• Native OpenAI-Routen behalten außerdem Responses store, Prompt-Cache-Hinweise und OpenAI-Reasoning-Kompatibilitäts-Payload-Formung bei; Proxy-Routen tun dies nicht
• openai/gpt-5.3-codex-spark wird in OpenClaw absichtlich unterdrückt, weil Live-OpenAI-API-Requests es ablehnen und der aktuelle Codex-Katalog es nicht bereitstellt

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

# Anthropic

• Provider: anthropic
• Authentifizierung: ANTHROPIC_API_KEY
• Optionale Rotation: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, plus OPENCLAW_LIVE_ANTHROPIC_KEY (einzelner Override)
• Beispielmodell: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Direkte öffentliche Anthropic-Requests unterstützen den gemeinsamen /fast-Toggle und params.fastMode, einschließlich API-Schlüssel- und OAuth-authentifiziertem Traffic an api.anthropic.com; OpenClaw mappt dies auf Anthropic service_tier (auto vs. standard_only)
• Die bevorzugte Claude-CLI-Konfiguration behält die Modellreferenz kanonisch und wählt das CLI-Backend separat: anthropic/claude-opus-4-7 mit agents.defaults.agentRuntime.id: "claude-cli". Ältere claude-cli/claude-opus-4-7-Referenzen funktionieren aus Kompatibilitätsgründen weiterhin.

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

# OpenAI Codex OAuth

• Provider: openai-codex
• Authentifizierung: OAuth (ChatGPT)
• PI-Modellreferenz: openai-codex/gpt-5.5
• Native Codex App-Server-Harness-Referenz: openai/gpt-5.5 mit agents.defaults.agentRuntime.id: "codex"
• Dokumentation zum nativen Codex App-Server-Harness: Codex-Harness
• Ältere Modellreferenzen: codex/gpt-*
• Plugin-Grenze: openai-codex/* lädt das OpenAI-Plugin; das native Codex App-Server-Plugin wird nur durch die Codex-Harness-Runtime oder ältere codex/*-Referenzen ausgewählt.
• CLI: openclaw onboard --auth-choice openai-codex oder openclaw models auth login --provider openai-codex
• Der Default-Transport ist auto (WebSocket zuerst, SSE-Fallback)
• Pro PI-Modell über agents.defaults.models["openai-codex/<model>"].params.transport überschreiben ("sse", "websocket" oder "auto")
• params.serviceTier wird auch bei nativen Codex-Responses-Requests weitergeleitet (chatgpt.com/backend-api)
• Verborgene OpenClaw-Attributionsheader (originator, version, User-Agent) werden nur bei nativem Codex-Traffic zu chatgpt.com/backend-api angehängt, nicht bei generischen OpenAI-kompatiblen Proxys
• Teilt dieselbe /fast-Toggle- und params.fastMode-Konfiguration wie direktes openai/*; OpenClaw mappt dies auf service_tier=priority
• openai-codex/gpt-5.5 verwendet den nativen contextWindow = 400000 des Codex-Katalogs und die Default-Runtime contextTokens = 272000; überschreiben Sie die Runtime-Obergrenze mit models.providers.openai-codex.models[].contextTokens
• Richtlinienhinweis: OpenAI Codex OAuth wird ausdrücklich für externe Tools/Workflows wie OpenClaw unterstützt.
• Für die gängige Route aus Abonnement plus nativer Codex-Runtime melden Sie sich mit openai-codex-Authentifizierung an, konfigurieren aber openai/gpt-5.5 plus agents.defaults.agentRuntime.id: "codex".
• Verwenden Sie openai-codex/gpt-5.5 nur, wenn Sie die Codex-OAuth-/Abonnementroute über PI möchten; verwenden Sie openai/gpt-5.5 ohne Codex-Runtime-Override, wenn Ihre API-Schlüssel-Einrichtung und Ihr lokaler Katalog die öffentliche API-Route bereitstellen.
• Ältere openai-codex/gpt-5.1*-, openai-codex/gpt-5.2*- und openai-codex/gpt-5.3*-Referenzen werden unterdrückt, weil ChatGPT-/Codex-OAuth-Konten sie ablehnen; verwenden Sie stattdessen openai-codex/gpt-5.5 oder die native Codex-Runtime-Route.

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

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

# Weitere gehostete Optionen im Abonnementstil

# OpenCode

• Authentifizierung: OPENCODE_API_KEY (oder OPENCODE_ZEN_API_KEY)
• Zen-Runtime-Provider: opencode
• Go-Runtime-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, GOOGLE_API_KEY-Fallback und OPENCLAW_LIVE_GEMINI_KEY (einzelne Überschreibung)
• Beispielmodelle: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Kompatibilität: Legacy-OpenClaw-Konfigurationen mit google/gemini-3.1-flash-preview werden zu google/gemini-3-flash-preview normalisiert
• Alias: google/gemini-3.1-pro wird akzeptiert und zu Googles Live-Gemini-API-ID google/gemini-3.1-pro-preview normalisiert
• CLI: openclaw onboard --auth-choice gemini-api-key
• Denken: /think adaptive verwendet dynamisches 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 Legacy-cached_content), um ein provider-natives cachedContents/...-Handle weiterzuleiten; Gemini-Cache-Treffer erscheinen als OpenClaw-cacheRead

# Google Vertex und Gemini CLI

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

Gemini-CLI-OAuth wird als Teil 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-JSON-Antworten werden aus response geparst; die Nutzung fällt auf stats zurück, wobei stats.cached zu OpenClaw-cacheRead normalisiert wird.

# Z.AI (GLM)

• Provider: zai
• Authentifizierung: ZAI_API_KEY
• Beispielmodell: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Aliasse: z.ai/* und z-ai/* werden zu zai/* normalisiert
  • zai-api-key erkennt den passenden Z.AI-Endpunkt automatisch; 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

# Kilo Gateway

• Provider: kilocode
• Authentifizierung: KILOCODE_API_KEY
• Beispielmodell: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Basis-URL: https://api.kilo.ai/api/gateway/
• Der statische Fallback-Katalog liefert kilocode/kilo/auto; die Live-Erkennung über https://api.kilo.ai/api/gateway/models kann den Laufzeitkatalog weiter erweitern.
• Das exakte Upstream-Routing hinter kilocode/kilo/auto liegt bei Kilo Gateway und ist nicht fest in OpenClaw codiert.

Einrichtungsdetails finden Sie unter /providers/kilocode.

# 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 gebündelten Provider-Plugins veröffentlichen bereits einen Standardkatalog. Verwenden Sie explizite models.providers.<id>-Einträge nur, wenn Sie die Standard-Basis-URL, Header oder Modellliste überschreiben möchten.

Gateway-Modellfähigkeitsprüfungen lesen außerdem explizite models.providers.<id>.models[]-Metadaten. Wenn ein benutzerdefiniertes oder Proxy-Modell Bilder akzeptiert, setzen Sie input: ["text", "image"] für dieses Modell, damit WebChat- und Node-Ursprungs-Anhangspfade Bilder als native Modelleingaben statt als reine Text-Medien-Refs übergeben.

# Moonshot AI (Kimi)

Moonshot wird als gebündeltes Provider-Plugin ausgeliefert. Verwenden Sie standardmäßig den integrierten Provider und fügen Sie nur dann einen expliziten models.providers.moonshot-Eintrag 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.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" }],
      },
    },
  },
}

# Kimi-Coding

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

• Provider: kimi
• Authentifizierung: KIMI_API_KEY
• Beispielmodell: kimi/kimi-code

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

Legacy kimi/k2p5 wird weiterhin als Kompatibilitätsmodell-ID akzeptiert.

# Volcano Engine (Doubao)

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

• Provider: volcengine (Coding: 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" } },
  },
}

Onboarding verwendet standardmäßig die Coding-Oberfläche, aber der allgemeine volcengine/*-Katalog wird gleichzeitig registriert.

In Modell-Auswahlfeldern beim Onboarding/Konfigurieren bevorzugt die Volcengine-Authentifizierungsoption sowohl volcengine/*- als auch volcengine-plan/*-Zeilen. Wenn diese Modelle noch nicht geladen sind, fällt OpenClaw auf den ungefilterten Katalog zurück, anstatt ein leeres Provider-spezifisches Auswahlfeld anzuzeigen.

# BytePlus (International)

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

• Provider: byteplus (Coding: 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" } },
  },
}

Onboarding verwendet standardmäßig die Coding-Oberfläche, aber der allgemeine byteplus/*-Katalog wird gleichzeitig registriert.

In Modell-Auswahlfeldern beim Onboarding/Konfigurieren bevorzugt die BytePlus-Authentifizierungsoption sowohl byteplus/*- als auch byteplus-plan/*-Zeilen. Wenn diese Modelle noch nicht geladen sind, fällt OpenClaw auf den ungefilterten Katalog zurück, anstatt ein leeres Provider-spezifisches Auswahlfeld anzuzeigen.

# Synthetic

Synthetic stellt Anthropic-kompatible Modelle hinter dem Provider synthetic 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

Setup-Details, Modelloptionen und Konfigurationsausschnitte finden Sie unter /providers/minimax.

Plugin-eigene Aufteilung der Fähigkeiten:

• Text-/Chat-Standards bleiben auf minimax/MiniMax-M2.7
• Bildgenerierung ist minimax/image-01 oder minimax-portal/image-01
• Bildverständnis ist Plugin-eigenes MiniMax-VL-01 auf beiden MiniMax-Authentifizierungspfaden
• Websuche bleibt auf der Provider-ID minimax

# LM Studio

LM Studio wird als gebündeltes Provider-Plugin ausgeliefert, das die native API verwendet:

• Provider: lmstudio
• Authentifizierung: LM_API_TOKEN
• Standard-Basis-URL für Inferenz: http://localhost:1234/v1

Legen Sie dann 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 LM Studio-Endpunkte /api/v1/models und /api/v1/models/load für Discovery + automatisches Laden, standardmäßig mit /v1/chat/completions für Inferenz. Wenn Sie möchten, dass LM Studio JIT-Laden, TTL und automatische Verdrängung für den Modelllebenszyklus übernimmt, setzen Sie models.providers.lmstudio.params.preload: false. Setup und Fehlerbehebung finden Sie unter /providers/lmstudio.

# Ollama

Ollama wird als gebündeltes Provider-Plugin ausgeliefert und verwendet Ollamas native API:

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

# Install Ollama, then pull a model:
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, und das gebündelte Provider-Plugin fügt Ollama direkt zu openclaw onboard und der Modellauswahl hinzu. Onboarding, Cloud-/lokaler Modus und benutzerdefinierte Konfiguration finden Sie unter /providers/ollama.

# vLLM

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

• Provider: vllm
• Authentifizierung: Optional (hängt von Ihrem Server ab)
• Standard-Basis-URL: http://127.0.0.1:8000/v1

Um lokale Auto-Discovery zu aktivieren (jeder Wert funktioniert, wenn Ihr Server keine Authentifizierung erzwingt):

export VLLM_API_KEY="vllm-local"

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

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

Weitere Details finden Sie unter /providers/vllm.

# SGLang

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

• Provider: sglang
• Authentifizierung: Optional (hängt von Ihrem Server ab)
• Standard-Basis-URL: http://127.0.0.1:30000/v1

Um lokale Auto-Discovery zu aktivieren (jeder Wert funktioniert, wenn Ihr Server keine Authentifizierung erzwingt):

export SGLANG_API_KEY="sglang-local"

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

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

Weitere Details 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-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

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

# Verwandt

• Konfigurationsreferenz - Modellkonfigurationsschlüssel
• Modell-Failover - Fallback-Ketten und Wiederholungsverhalten
• Modelle - Modellkonfiguration und Aliasse
• Provider - Setup-Leitfäden pro Provider