Modell-Provider

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

Kurzregeln

Provider in der Control UI konfigurieren

Öffnen Sie in der Control UI Settings → Model Providers, um in models.providers.<id>.apiKey gespeicherte Provider-API-Schlüssel hinzuzufügen, zu ersetzen oder zu entfernen. Die Seite zeigt an, ob ein API-Schlüssel aus der OpenClaw-Konfiguration oder einer Umgebungsvariable stammt, ohne die Anmeldedaten anzuzeigen. Über die Umgebung bereitgestellte Schlüssel werden weiterhin über die Prozessumgebung des Gateways verwaltet.

Verwenden Sie Test connection, um eine Live-Prüfung des Providers auszuführen und die Latenz oder einen kategorisierten Authentifizierungs-, Ratenbegrenzungs-, Abrechnungs-, Zeitüberschreitungs- oder Antwortfehler anzuzeigen. Eine Prüfung sendet eine echte Provider-Anfrage und kann eine geringe Anzahl von Tokens verbrauchen. Von OAuth- und Token-Profilen kann außerdem über die Provider-Karte abgemeldet werden.

Die Karte Default models verwaltet das primäre Modell, geordnete Fallbacks und das Hilfsmodell aus dem konfigurierten Modellkatalog. Wählen Sie die Modelle aus und speichern Sie sie anschließend gemeinsam in den vorhandenen Einstellungen agents.defaults.model und agents.defaults.utilityModel. Beim Hilfsmodell lässt Automatic die Einstellung ungesetzt, während Disabled eine leere Zeichenfolge speichert, um das Hilfsrouting zu deaktivieren.

Plugin-eigenes Provider-Verhalten

Der Großteil der Provider-spezifischen Logik befindet sich in Provider-Plugins (registerProvider(...)), während OpenClaw die generische Inferenzschleife bereitstellt. Plugins verwalten Onboarding, Modellkataloge, die Zuordnung von Authentifizierungs-Umgebungsvariablen, Transport-/Konfigurationsnormalisierung, Bereinigung von Tool-Schemas, Failover-Klassifizierung, OAuth-Aktualisierung, Nutzungsberichte, Denk-/Reasoning-Profile und mehr.

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.

API-Schlüsselrotation

Offizielle Provider-Plugins

Offizielle Provider-Plugins veröffentlichen ihre eigenen Modellkatalogzeilen. Für diese Provider sind keine models.providers-Modelleinträge erforderlich; aktivieren Sie das Provider-Plugin, richten Sie die Authentifizierung ein und wählen Sie ein Modell aus. 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 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" } } },}

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

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

Gemini-CLI-OAuth wird als Bestandteil des gebündelten Plugins google 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 Assistenten-Stream- Nachrichten und normalisiert stats.cached zu cacheRead; veraltete --output-format json-Überschreibungen 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 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)

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, die Header oder die Modellliste überschreiben möchten.

Gebündelte und im Katalog bekannte Routen beziehen ihre compat-Fähigkeiten vom zuständigen Provider-Plugin. Ein compat-Konfigurationsblock ist für einen benutzerdefinierten Provider bzw. ein benutzerdefiniertes Modell oder eine andere api-/baseUrl-Route vorgesehen, deren Endpunktvertrag Sie überprüft haben; siehe den Leitfaden zu Fähigkeitsdeklarationen benutzerdefinierter Provider. Doctor entfernt veraltete Werte, die lediglich den Katalog wiederholen, und lässt abweichende Werte für die Überprüfung durch den Betreiber sichtbar.

Die Modellfähigkeitsprüfungen des Gateways lesen außerdem explizite models.providers.<id>.models[]-Metadaten. Wenn ein benutzerdefiniertes oder Proxy-Modell Bilder akzeptiert, legen Sie für dieses Modell input: ["text", "image"] fest, damit WebChat und vom Node ausgehende Anhangspfade Bilder als native Modelleingaben statt als reine Text-Medienreferenzen übergeben.

agents.defaults.models["provider/model"] steuert Aliasse und modellspezifische Metadaten für Agenten. Es schränkt weder Überschreibungen ein noch registriert es selbstständig ein neues Laufzeitmodell. Fügen Sie für Modelle benutzerdefinierter Provider außerdem models.providers.<provider>.models[] mit mindestens dem passenden id hinzu; verwenden Sie agents.defaults.modelPolicy.allow separat, wenn Sie Überschreibungen einschränken möchten.

Moonshot AI (Kimi)

Installieren Sie vor dem Onboarding @openclaw/moonshot-provider. 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-k3
• CLI: openclaw onboard --auth-choice moonshot-api-key oder openclaw onboard --auth-choice moonshot-api-key-cn

Kimi-Modell-IDs:

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

Den vollständigen Einrichtungsleitfaden 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
• 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" } },  },}

Die veralteten kimi/kimi-code und kimi/k2p5 werden weiterhin als Kompatibilitäts-Modell-IDs akzeptiert und zur stabilen 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, der allgemeine volcengine/*-Katalog wird jedoch gleichzeitig registriert.

In den Modellauswahlfeldern für Onboarding und Konfiguration bevorzugt die Volcengine-Authentifizierungsoption sowohl volcengine/*- als auch volcengine-plan/*-Zeilen. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, statt ein leeres, auf den Provider beschränktes 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" } },  },}

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

In den Modellauswahlen für Onboarding und Konfiguration bevorzugt die BytePlus-Authentifizierungsoption sowohl die Zeilen byteplus/* als auch byteplus-plan/*. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, anstatt eine leere, auf den Provider beschränkte Auswahl anzuzeigen.

Synthetic

Synthetic stellt Anthropic-kompatible Modelle über den Provider synthetic bereit:

• 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 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 Konfigurationsbeispiele finden Sie unter /providers/minimax.

Vom Plugin verwaltete Aufteilung der Fähigkeiten:

• 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

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 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 /api/v1/models und /api/v1/models/load von LM Studio für Erkennung und automatisches Laden, wobei /v1/chat/completions standardmäßig für die Inferenz verwendet wird. Wenn das JIT-Laden, die TTL und das automatische Entfernen von LM Studio den Modelllebenszyklus verwalten sollen, legen Sie models.providers.lmstudio.params.preload: false fest. Informationen zur Einrichtung und Fehlerbehebung finden Sie unter /providers/lmstudio.

Ollama

Ollama wird als gebündeltes Provider-Plugin ausgeliefert und verwendet die native API von 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" } },  },}

Ollama wird lokal unter http://127.0.0.1:11434 erkannt, wenn Sie es mit OLLAMA_API_KEY aktivieren. Das gebündelte Provider-Plugin fügt Ollama direkt zu openclaw onboard und zur Modellauswahl hinzu. Informationen zu Onboarding, Cloud-/Lokalmodus und benutzerdefinierter Konfiguration finden Sie unter /providers/ollama.

vLLM

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

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

So aktivieren Sie die lokale automatische Erkennung (jeder Wert ist möglich, 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 gebündeltes Provider-Plugin für schnelle, selbst gehostete OpenAI-kompatible Server ausgeliefert:

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

So aktivieren Sie die lokale automatische Erkennung (jeder Wert ist möglich, 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 mit vollständigen Konfigurationsbeispielen.

Verwandte Themen

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