Modelle: Standardwerte, Auswahl, Aliase, Wechsel
Was ist das "Standardmodell"?
Was ist das "Standardmodell"?
provider/model referenziert (Beispiel: openai/gpt-5.5 oder anthropic/claude-sonnet-4-6). Wenn Sie den Provider weglassen, versucht OpenClaw zuerst einen Alias, dann eine eindeutige Übereinstimmung eines konfigurierten Providers für genau diese Modell-ID und fällt erst danach als veralteten Kompatibilitätspfad auf den konfigurierten Standard-Provider zurück. Wenn dieser Provider das konfigurierte Standardmodell nicht mehr bereitstellt, fällt OpenClaw auf das erste konfigurierte Provider/Modell zurück, anstatt einen veralteten, entfernten Provider-Standard anzuzeigen. Sie sollten provider/model trotzdem explizit festlegen.Welches Modell empfehlen Sie?
Welches Modell empfehlen Sie?
Wie wechsle ich Modelle, ohne meine Konfiguration zu löschen?
Wie wechsle ich Modelle, ohne meine Konfiguration zu löschen?
/modelim Chat (schnell, pro Sitzung)openclaw models set ...(aktualisiert nur die Modellkonfiguration)openclaw configure --section model(interaktiv)agents.defaults.modelin~/.openclaw/openclaw.jsonbearbeiten
config.apply mit einem Teilobjekt, es sei denn, Sie möchten die gesamte Konfiguration ersetzen.
Prüfen Sie bei RPC-Bearbeitungen zuerst mit config.schema.lookup und bevorzugen Sie config.patch. Die Lookup-Nutzlast liefert Ihnen den normalisierten Pfad, oberflächliche Schema-Dokumentation/Einschränkungen und Zusammenfassungen direkter untergeordneter Elemente.
für Teilaktualisierungen.
Wenn Sie die Konfiguration überschrieben haben, stellen Sie sie aus einem Backup wieder her oder führen Sie openclaw doctor erneut aus, um sie zu reparieren.Dokumentation: Modelle, Konfigurieren, Konfiguration, Doctor.Kann ich selbst gehostete Modelle verwenden (llama.cpp, vLLM, Ollama)?
Kann ich selbst gehostete Modelle verwenden (llama.cpp, vLLM, Ollama)?
- Installieren Sie Ollama von
https://ollama.com/download - Laden Sie ein lokales Modell wie
ollama pull gemma4 - Wenn Sie auch Cloud-Modelle möchten, führen Sie
ollama signinaus - Führen Sie
openclaw onboardaus und wählen SieOllama - Wählen Sie
LocaloderCloud + Local
Cloud + Localgibt Ihnen Cloud-Modelle plus Ihre lokalen Ollama-Modelle- Cloud-Modelle wie
kimi-k2.5:cloudbenötigen keinen lokalen Pull - Für manuelles Wechseln verwenden Sie
openclaw models listundopenclaw models set ollama/<model>
Welche Modelle verwenden OpenClaw, Flawd und Krill?
Welche Modelle verwenden OpenClaw, Flawd und Krill?
- Diese Deployments können sich unterscheiden und sich im Laufe der Zeit ändern; es gibt keine feste Provider-Empfehlung.
- Prüfen Sie die aktuelle Laufzeiteinstellung auf jedem Gateway mit
openclaw models status. - Verwenden Sie für sicherheitssensitive Agents mit Tools das stärkste verfügbare Modell der neuesten Generation.
Wie wechsle ich Modelle direkt zur Laufzeit (ohne Neustart)?
Wie wechsle ich Modelle direkt zur Laufzeit (ohne Neustart)?
/model als eigenständige Nachricht:agents.defaults.models hinzugefügt werden.Sie können verfügbare Modelle mit /model, /model list oder /model status auflisten./model (und /model list) zeigt eine kompakte, nummerierte Auswahl. Wählen Sie per Nummer aus:/model status zeigt, welcher Agent aktiv ist, welche Datei auth-profiles.json verwendet wird und welches Auth-Profil als Nächstes versucht wird.
Außerdem werden der konfigurierte Provider-Endpunkt (baseUrl) und der API-Modus (api) angezeigt, sofern verfügbar.Wie löse ich ein Profil, das ich mit @profile festgelegt habe?Führen Sie /model erneut ohne das Suffix @profile aus:/model aus (oder senden Sie /model <default provider/model>).
Verwenden Sie /model status, um zu bestätigen, welches Auth-Profil aktiv ist.Wenn zwei Provider dieselbe Modell-ID bereitstellen, welchen verwendet /model?
Wenn zwei Provider dieselbe Modell-ID bereitstellen, welchen verwendet /model?
/model provider/model wählt genau diese Provider-Route für die Sitzung aus.Zum Beispiel sind qianfan/deepseek-v4-flash und deepseek/deepseek-v4-flash unterschiedliche Modellreferenzen, auch wenn beide deepseek-v4-flash enthalten. OpenClaw sollte nicht stillschweigend von einem Provider zum anderen wechseln, nur weil die reine Modell-ID übereinstimmt.Eine vom Benutzer ausgewählte /model-Referenz ist auch für die Fallback-Richtlinie strikt. Wenn dieser ausgewählte Provider/dieses ausgewählte Modell nicht verfügbar ist, schlägt die Antwort sichtbar fehl, anstatt über agents.defaults.model.fallbacks zu antworten. Konfigurierte Fallback-Ketten gelten weiterhin für konfigurierte Standards, Primärmodelle von Cron-Jobs und automatisch ausgewählten Fallback-Zustand.Wenn ein Lauf, der aus einer Nicht-Sitzungs-Überschreibung gestartet wurde, Fallback verwenden darf, versucht OpenClaw zuerst den angeforderten Provider/das angeforderte Modell, dann konfigurierte Fallbacks und erst danach das konfigurierte Primärmodell. Das verhindert, dass doppelte reine Modell-IDs direkt zurück zum Standard-Provider springen.Siehe Modelle und Modell-Failover.Kann ich GPT 5.5 für tägliche Aufgaben und Codex 5.5 fürs Programmieren verwenden?
Kann ich GPT 5.5 für tägliche Aufgaben und Codex 5.5 fürs Programmieren verwenden?
- Nativer Codex-Coding-Agent: Setzen Sie
agents.defaults.model.primaryaufopenai/gpt-5.5. Melden Sie sich mitopenclaw models auth login --provider openaian, wenn Sie ChatGPT/Codex-Abonnementauthentifizierung verwenden möchten. - Direkte OpenAI-API-Aufgaben außerhalb der Agent-Schleife: Konfigurieren Sie
OPENAI_API_KEYfür Bilder, Embeddings, Sprache, Echtzeit und andere OpenAI-API-Oberflächen außerhalb von Agents. - OpenAI-Agent-API-Key-Authentifizierung: Verwenden Sie
/model openai/gpt-5.5mit einem geordnetenopenai-API-Key-Profil. - Sub-Agents: Routen Sie Coding-Aufgaben an einen Codex-fokussierten Agent mit eigenem Modell
openai/gpt-5.5.
Wie konfiguriere ich den Schnellmodus für GPT 5.5?
Wie konfiguriere ich den Schnellmodus für GPT 5.5?
- Pro Sitzung: Senden Sie
/fast on, während die Sitzungopenai/gpt-5.5verwendet. - Pro Modellstandard: Setzen Sie
agents.defaults.models["openai/gpt-5.5"].params.fastModeauftrue. - Automatischer Grenzwert: Verwenden Sie
/fast autooderparams.fastMode: "auto", um neue Modellaufrufe bis zum automatischen Grenzwert schnell zu starten und spätere Retry-, Fallback-, Tool-Ergebnis- oder Fortsetzungsaufrufe ohne Schnellmodus zu starten. Der Grenzwert ist standardmäßig 60 Sekunden; setzen Sieparams.fastAutoOnSecondsauf dem aktiven Modell, um ihn zu ändern.
service_tier = "priority" abgebildet. Sitzungsweite /fast-Überschreibungen haben Vorrang vor Konfigurationsstandards. Codex-App-Server-Turns können den Tier nur zu Beginn des Turns erhalten, daher gilt auto für den nächsten von OpenClaw gestarteten Modell-Turn und nicht innerhalb eines bereits laufenden App-Server-Turns.Siehe Thinking und Schnellmodus und OpenAI-Schnellmodus.Warum sehe ich "Model ... is not allowed" und dann keine Antwort?
Warum sehe ich "Model ... is not allowed" und dann keine Antwort?
agents.defaults.models gesetzt ist, wird es zur Allowlist für /model und alle
Sitzungsüberschreibungen. Die Auswahl eines Modells, das nicht in dieser Liste steht, gibt zurück:agents.defaults.models hinzu, fügen Sie einen Provider-Wildcard wie "provider/*": {} für dynamische Provider-Kataloge hinzu, entfernen Sie die Allowlist oder wählen Sie ein Modell aus /model list.
Wenn der Befehl auch --runtime codex enthielt, aktualisieren Sie zuerst die Allowlist und versuchen Sie dann denselben Befehl
/model provider/model --runtime codex erneut.Warum sehe ich "Unknown model: minimax/MiniMax-M3"?
Warum sehe ich "Unknown model: minimax/MiniMax-M3"?
-
Aktualisieren Sie auf eine aktuelle OpenClaw-Version (oder führen Sie aus dem Quellzweig
mainaus) und starten Sie dann das Gateway neu. -
Stellen Sie sicher, dass MiniMax konfiguriert ist (Assistent oder JSON) oder dass MiniMax-Authentifizierung
in env/Auth-Profilen vorhanden ist, damit der passende Provider injiziert werden kann
(
MINIMAX_API_KEYfürminimax,MINIMAX_OAUTH_TOKENoder gespeichertes MiniMax- OAuth fürminimax-portal). -
Verwenden Sie die exakte Modell-ID (Groß-/Kleinschreibung beachten) für Ihren Auth-Pfad:
minimax/MiniMax-M3,minimax/MiniMax-M2.7oderminimax/MiniMax-M2.7-highspeedfür API-Key-Einrichtung, oderminimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7oderminimax-portal/MiniMax-M2.7-highspeedfür OAuth-Einrichtung. -
Führen Sie aus:
und wählen Sie aus der Liste aus (oder
/model listim Chat).
Kann ich MiniMax als Standard und OpenAI für komplexe Aufgaben verwenden?
Kann ich MiniMax als Standard und OpenAI für komplexe Aufgaben verwenden?
/model oder einen separaten Agent.Option A: pro Sitzung wechseln- Standard für Agent A: MiniMax
- Standard für Agent B: OpenAI
- Nach Agent routen oder
/agentzum Wechseln verwenden
Sind opus / sonnet / gpt integrierte Kurzbefehle?
Sind opus / sonnet / gpt integrierte Kurzbefehle?
agents.defaults.models vorhanden ist):opus→anthropic/claude-opus-4-8sonnet→anthropic/claude-sonnet-4-6gpt→openai/gpt-5.4gpt-mini→openai/gpt-5.4-minigpt-nano→openai/gpt-5.4-nanogemini→google/gemini-3.1-pro-previewgemini-flash→google/gemini-3-flash-previewgemini-flash-lite→google/gemini-3.1-flash-lite
Wie definiere/überschreibe ich Modell-Kurzbefehle (Aliasse)?
Wie definiere/überschreibe ich Modell-Kurzbefehle (Aliasse)?
agents.defaults.models.<modelId>.alias. Beispiel:/model sonnet (oder /<alias>, sofern unterstützt) zu dieser Modell-ID aufgelöst.Wie füge ich Modelle von anderen Providern wie OpenRouter oder Z.AI hinzu?
Wie füge ich Modelle von anderen Providern wie OpenRouter oder Z.AI hinzu?
No API key found for provider "zai").Kein API-Schlüssel für Provider gefunden, nachdem ein neuer Agent hinzugefügt wurdeDas bedeutet üblicherweise, dass der neue Agent einen leeren Auth-Speicher hat. Auth ist agentenspezifisch und
wird hier gespeichert:- Führen Sie
openclaw agents add <id>aus und konfigurieren Sie Auth während des Assistenten. - Oder kopieren Sie nur portable statische
api_key- /token-Profile aus dem Auth-Speicher des Haupt-Agenten in den Auth-Speicher des neuen Agenten. - Melden Sie sich für OAuth-Profile vom neuen Agenten aus an, wenn dieser ein eigenes Konto benötigt; andernfalls kann OpenClaw ohne Klonen von Refresh-Tokens bis zum Standard-/Haupt-Agenten durchlesen.
agentDir nicht agentenübergreifend wieder; das verursacht Auth-/Sitzungskollisionen.Modell-Failover und “Alle Modelle fehlgeschlagen”
Wie funktioniert Failover?
Wie funktioniert Failover?
- Auth-Profil-Rotation innerhalb desselben Providers.
- Modell-Fallback zum nächsten Modell in
agents.defaults.model.fallbacks.
429-Antworten. OpenClaw
behandelt auch Meldungen wie Too many concurrent requests,
ThrottlingException, concurrency limit reached,
workers_ai ... quota limit exceeded, resource exhausted und periodische
Nutzungslimits (weekly/monthly limit reached) als Rate Limits, die
Failover rechtfertigen.Einige nach Abrechnung aussehende Antworten sind keine 402, und einige HTTP-402-
Antworten bleiben ebenfalls in diesem transienten Bucket. Wenn ein Provider
expliziten Abrechnungstext bei 401 oder 403 zurückgibt, kann OpenClaw dies weiterhin in
der Abrechnungsspur halten, aber provider-spezifische Text-Matcher bleiben auf den
Provider beschränkt, dem sie gehören (zum Beispiel OpenRouter Key limit exceeded). Wenn eine 402-
Meldung stattdessen wie ein wiederholbares Nutzungsfenster oder
ein Ausgabenlimit für Organisation/Workspace wirkt (daily limit reached, resets tomorrow,
organization spending limit exceeded), behandelt OpenClaw sie als
rate_limit, nicht als langfristige Abrechnungsdeaktivierung.Kontextüberlauf-Fehler sind anders: Signaturen wie
request_too_large, input exceeds the maximum number of tokens,
input token count exceeds the maximum number of input tokens,
input is too long for the model oder ollama error: context length exceeded bleiben auf dem Compaction-/Retry-Pfad, statt den Modell-
Fallback voranzutreiben.Generischer Serverfehlertext ist absichtlich enger gefasst als „alles mit
unknown/error darin“. OpenClaw behandelt provider-bezogene transiente Formen
wie Anthropic pur An unknown error occurred, OpenRouter pur
Provider returned error, Stop-Reason-Fehler wie Unhandled stop reason: error, JSON-api_error-Payloads mit transientem Servertext
(internal server error, unknown error, 520, upstream error, backend error) und Provider-ausgelastet-Fehler wie ModelNotReadyException als
Failover-würdige Timeout-/Überlastungssignale, wenn der Provider-Kontext
passt.
Generischer interner Fallback-Text wie LLM request failed with an unknown error. bleibt konservativ und löst für sich allein keinen Modell-Fallback aus.Was bedeutet "No credentials found for profile anthropic:default"?
Was bedeutet "No credentials found for profile anthropic:default"?
anthropic:default zu verwenden, aber im erwarteten Auth-Speicher keine Anmeldedaten dafür finden konnte.Checkliste zur Behebung:- Bestätigen Sie, wo Auth-Profile liegen (neue vs. Legacy-Pfade)
- Aktuell:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - Legacy:
~/.openclaw/agent/*(migriert durchopenclaw doctor)
- Aktuell:
- Bestätigen Sie, dass Ihre Umgebungsvariable vom Gateway geladen wird
- Wenn Sie
ANTHROPIC_API_KEYin Ihrer Shell setzen, den Gateway aber über systemd/launchd ausführen, übernimmt er sie möglicherweise nicht. Legen Sie sie in~/.openclaw/.envab oder aktivieren Sieenv.shellEnv.
- Wenn Sie
- Stellen Sie sicher, dass Sie den richtigen Agenten bearbeiten
- Multi-Agent-Setups bedeuten, dass es mehrere
auth-profiles.json-Dateien geben kann.
- Multi-Agent-Setups bedeuten, dass es mehrere
- Prüfen Sie den Modell-/Auth-Status grob
- Verwenden Sie
openclaw models status, um konfigurierte Modelle zu sehen und ob Provider authentifiziert sind.
- Verwenden Sie
-
Claude CLI verwenden
- Führen Sie
openclaw models auth login --provider anthropic --method cli --set-defaultauf dem Gateway-Host aus.
- Führen Sie
-
Wenn Sie stattdessen einen API-Schlüssel verwenden möchten
-
Legen Sie
ANTHROPIC_API_KEYin~/.openclaw/.envauf dem Gateway-Host ab. -
Entfernen Sie jede festgelegte Reihenfolge, die ein fehlendes Profil erzwingt:
-
Legen Sie
-
Bestätigen Sie, dass Sie Befehle auf dem Gateway-Host ausführen
- Im Remote-Modus liegen Auth-Profile auf dem Gateway-Rechner, nicht auf Ihrem Laptop.
Warum wurde auch Google Gemini versucht und ist fehlgeschlagen?
Warum wurde auch Google Gemini versucht und ist fehlgeschlagen?
No API key found for provider "google".Behebung: Stellen Sie entweder Google-Auth bereit oder entfernen/vermeiden Sie Google-Modelle in agents.defaults.model.fallbacks / Aliassen, damit der Fallback nicht dorthin routet.LLM-Anfrage abgelehnt: Thinking-Signatur erforderlich (Google Antigravity)Ursache: Der Sitzungsverlauf enthält Thinking-Blöcke ohne Signaturen (oft aus
einem abgebrochenen/teilweisen Stream). Google Antigravity erfordert Signaturen für Thinking-Blöcke.Behebung: OpenClaw entfernt jetzt unsignierte Thinking-Blöcke für Google Antigravity Claude. Wenn es weiterhin auftritt, starten Sie eine neue Sitzung oder setzen Sie /thinking off für diesen Agenten.Auth-Profile: was sie sind und wie Sie sie verwalten
Verwandt: /concepts/oauth (OAuth-Flows, Token-Speicherung, Multi-Account-Muster)Was ist ein Auth-Profil?
Was ist ein Auth-Profil?
openclaw models auth list aus (optional --provider <id> oder --json). Details finden Sie unter Modelle-CLI.Was sind typische Profil-IDs?
Was sind typische Profil-IDs?
anthropic:default(üblich, wenn keine E-Mail-Identität vorhanden ist)anthropic:<email>für OAuth-Identitäten- benutzerdefinierte IDs, die Sie wählen (z. B.
anthropic:work)
Kann ich steuern, welches Auth-Profil zuerst versucht wird?
Kann ich steuern, welches Auth-Profil zuerst versucht wird?
auth.order.<provider>). Dadurch werden keine Secrets gespeichert; es ordnet IDs Provider/Modus zu und legt die Rotationsreihenfolge fest.OpenClaw kann ein Profil vorübergehend überspringen, wenn es sich in einem kurzen Cooldown (Rate Limits/Timeouts/Auth-Fehler) oder in einem längeren deaktivierten Zustand (Abrechnung/ungenügendes Guthaben) befindet. Um dies zu prüfen, führen Sie openclaw models status --json aus und prüfen Sie auth.unusableProfiles. Tuning: auth.cooldowns.billingBackoffHours*.Rate-Limit-Cooldowns können modellspezifisch sein. Ein Profil, das für
ein Modell abkühlt, kann für ein Geschwistermodell beim selben Provider
weiterhin nutzbar sein, während Abrechnungs-/deaktivierte Fenster weiterhin das ganze Profil blockieren.Sie können auch eine agentenspezifische Reihenfolgeüberschreibung (gespeichert in auth-state.json dieses Agenten) über die CLI festlegen:excluded_by_auth_order für dieses Profil, statt es stillschweigend zu versuchen.OAuth vs. API-Schlüssel - was ist der Unterschied?
OAuth vs. API-Schlüssel - was ist der Unterschied?
- OAuth / CLI-Login nutzt häufig Abonnementzugriff, sofern der
Provider dies unterstützt. Für Anthropic verwendet OpenClaws Claude-CLI-Backend
Claude Code
claude -p; Anthropic behandelt dies derzeit als Agent- SDK-/programmatische Nutzung. Anthropic hat die separate Agent- SDK-Guthabenänderung vom 15. Juni 2026 pausiert, daher wird dies vorerst weiterhin aus den Abonnement-Nutzungslimits entnommen. Siehe Anthropics Agent SDK plan article für den aktuellen Pausenhinweis. - API-Schlüssel verwenden Pay-per-Token-Abrechnung.