Modell-Provider

​

Kurzregeln

​

Provider in der Control UI konfigurieren

​

Plugin-eigenes Provider-Verhalten

​

API-Schlüsselrotation

​

Offizielle Provider-Plugins

​

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 bloße 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 bestimmter 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 dies 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 service_tier=priority auf api.openai.com zu
• Verwenden Sie params.serviceTier, wenn Sie anstelle des gemeinsamen /fast-Schalters eine explizite Stufe wünschen
• Verborgene OpenClaw-Attributionsheader (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, Prompt-Cache-Hinweise und OpenAI-Reasoning-Kompatibilitäts-Payload-Formung bei; Proxy-Routen tun dies nicht
• openai/gpt-5.3-codex-spark ist nur über ChatGPT-/Codex-OAuth verfügbar; direkte OpenAI-API-Schlüssel- und Azure-API-Schlüssel-Routen lehnen es ab

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

​

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-5
• CLI: openclaw onboard --auth-choice apiKey
• Direkte öffentliche Anthropic-Anfragen unterstützen den gemeinsamen /fast-Schalter und params.fastMode, einschließlich mit API-Schlüssel und OAuth authentifiziertem Datenverkehr, der an api.anthropic.com gesendet wird; OpenClaw ordnet dies Anthropic-service_tier zu (auto gegenüber standard_only)
• Die bevorzugte Claude-CLI-Konfiguration behält die Modellreferenz kanonisch bei und wählt das CLI- Backend separat aus: anthropic/claude-opus-5 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-5" } } },
}

​

OpenAI ChatGPT-/Codex-OAuth

• Provider: openai
• Authentifizierung: OAuth (ChatGPT)
• Referenz für eine neue native Codex-App-Server-Testumgebung: openai/gpt-5.6-sol
• Dokumentation der nativen Codex-App-Server-Testumgebung: Codex-Testumgebung
• Veraltete Modellreferenzen: codex/gpt-*, openai-codex/gpt-*
• Plugin-Grenze: openai/* lädt das OpenAI-Plugin; eine explizite Laufzeitrichtlinie oder die vom Provider verwaltete effektive Route entscheidet, 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 (WebSocket zuerst, SSE als Fallback).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier und params.fastMode sind explizit festgelegte Einstellungen für eingebettete Anfragen. Bei ihnen verbleibt die implizite Laufzeitauswahl bei OpenClaw; das native Codex verwaltet seinen App-Server-Transport und seine Dienststufe selbst.
• Verborgene OpenClaw-Attributionsheader (originator, version, User-Agent) werden nur bei nativem Codex-Datenverkehr zu chatgpt.com/backend-api angefügt, nicht bei generischen OpenAI-kompatiblen Proxys
• Der gemeinsame Schalter /fast bleibt als Laufzeitsteuerung verfügbar; er unterscheidet sich von explizit festgelegten 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 einfachen Alias gpt-5.6 der direkten API nicht clientseitig an.
• openai/gpt-5.5 verwendet den nativen Codex-Katalog contextWindow = 400000 und die Standardlaufzeit contextTokens = 272000; überschreiben Sie die Laufzeitobergrenze mit models.providers.openai.models[].contextTokens
• Melden Sie sich mit der Authentifizierung openai an und verwenden Sie openai/gpt-5.6-sol für eine neue, abonnementgestützte Einrichtung. Wählen Sie ausdrücklich openai/gpt-5.5, wenn dieser Codex-Arbeitsbereich GPT-5.6 nicht bereitstellt.
• Verwenden Sie Provider/Modell agentRuntime.id: "openclaw", damit eine ansonsten geeignete Route die integrierte Laufzeit verwendet. Wenn die Laufzeit nicht festgelegt oder auf auto gesetzt ist, kann Codex nur bei einer exakt offiziellen HTTPS-Route, die mit Responses/ChatGPT kompatibel ist und keine explizit festgelegte Anfrageüberschreibung enthält, implizit ausgewählt werden.
• Veraltete Codex-GPT-Referenzen sind veralteter Zustand und keine aktive Provider-Route. Verwenden Sie für neue Agentenkonfigurationen kanonische openai/*-Referenzen und führen Sie openclaw doctor --fix aus, um die Referenzen codex/* und openai-codex/* zu migrieren und dabei ihre nativen Codex-Semantiken durch modellspezifisches agentRuntime.id: "codex" beizubehalten. Bestehende explizite kanonische openai/gpt-5.5-Auswahlen werden nicht aktualisiert.

{
  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, GOOGLE_API_KEY als Fallback und OPENCLAW_LIVE_GEMINI_KEY (einzelne Überschreibung)
• Beispielmodelle: google/gemini-3.1-pro-preview, google/gemini-3.5-flash
• Kompatibilität: Eine veraltete 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 den dynamischen Denkmodus von Google. Bei Gemini 3/3.1 entfällt ein festes thinkingLevel; Gemini 2.5 sendet thinkingBudget: -1.
• Direkte Gemini-Ausführungen akzeptieren außerdem agents.defaults.models["google/<model>"].params.cachedContent (oder das veraltete 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

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

​

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 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

​

Weitere gebündelte Provider-Plugins

​

Wissenswerte Besonderheiten

​

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

​

Moonshot AI (Kimi)

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

• moonshot/kimi-k2.6
• moonshot/kimi-k3
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.7-code-highspeed
• moonshot/kimi-k2.5

{
  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

• Provider: kimi
• Authentifizierung: KIMI_API_KEY
• Kimi K3: kimi/k3 (256K) oder kimi/k3[1m] (1M-Tarif)
• Kimi Code: kimi/kimi-for-coding
• Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed

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

​

Volcano Engine (Doubao)

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

​

BytePlus (International)

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

​

Synthetic

• Provider: synthetic
• Authentifizierung: SYNTHETIC_API_KEY
• Beispielmodell: synthetic/hf:MiniMaxAI/MiniMax-M3
• CLI: openclaw onboard --auth-choice synthetic-api-key

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

​

MiniMax

• 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

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

​

LM Studio

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

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

​

Ollama

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

# Ollama installieren und anschließend ein Modell abrufen:
ollama pull llama3.3

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

​

vLLM

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

export VLLM_API_KEY="vllm-local"

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

​

SGLang

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

export SGLANG_API_KEY="sglang-local"

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

​

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

{
  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

​

Verwandte Themen

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