Fragen und Antworten zu Modellen und Auth-Profilen. Informationen zu Einrichtung, Sitzungen, Gateway, Channels und Fehlerbehebung finden Sie in der Haupt-FAQ.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Modelle: Standardwerte, Auswahl, Aliasse, Wechseln
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 mit einem konfigurierten Provider für genau diese Modell-ID und fällt erst danach als veralteter Kompatibilitätspfad auf den konfigurierten Standard-Provider zurück. Wenn dieser Provider das konfigurierte Standardmodell nicht mehr bereitstellt, fällt OpenClaw auf den ersten konfigurierten Provider bzw. das erste konfigurierte Modell zurück, anstatt einen veralteten Standard eines entfernten Providers 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 partiellen Objekt, außer 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-Payload liefert Ihnen den normalisierten Pfad, oberflächliche Schema-Dokumentation/Einschränkungen und Zusammenfassungen der direkten untergeordneten Elemente.
für partielle Aktualisierungen.
Wenn Sie die Konfiguration überschrieben haben, stellen Sie sie aus einem Backup wieder her oder führen Sie erneut openclaw doctor 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, zum Beispiel
ollama pull gemma4 - Wenn Sie auch Cloud-Modelle verwenden 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 - Verwenden Sie für manuelles Wechseln
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 sicherheitssensible Agents mit Tools das stärkste verfügbare Modell der neuesten Generation.
Wie wechsle ich Modelle im laufenden Betrieb (ohne Neustart)?
Wie wechsle ich Modelle im laufenden Betrieb (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:/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 hebe ich die Fixierung eines Profils auf, 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.Beispielsweise 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 der ausgewählte Provider bzw. das ausgewählte Modell nicht verfügbar ist, schlägt die Antwort sichtbar fehl, statt aus agents.defaults.model.fallbacks beantwortet zu werden. Konfigurierte Fallback-Ketten gelten weiterhin für konfigurierte Standardwerte, Primärmodelle von Cron-Jobs und automatisch ausgewählten Fallback-Zustand.Wenn ein Lauf, der von einer Überschreibung außerhalb der Sitzung gestartet wurde, Fallbacks verwenden darf, versucht OpenClaw zuerst den angeforderten Provider bzw. das angeforderte Modell, dann konfigurierte Fallbacks und erst danach das konfigurierte Primärmodell. Das verhindert, dass doppelte reine Modell-IDs direkt zum Standard-Provider zurückspringen.Siehe Modelle und Modell-Failover.Kann ich GPT 5.5 für tägliche Aufgaben und Codex 5.5 zum Programmieren verwenden?
Kann ich GPT 5.5 für tägliche Aufgaben und Codex 5.5 zum Programmieren verwenden?
- Nativer Codex-Programmier-Agent: Setzen Sie
agents.defaults.model.primaryaufopenai/gpt-5.5. Melden Sie sich mitopenclaw models auth login --provider openai-codexan, wenn Sie ChatGPT/Codex-Abonnement-Auth verwenden möchten. - Direkte OpenAI-API-Aufgaben außerhalb des Agent-Loops: Konfigurieren Sie
OPENAI_API_KEYfür Bilder, Embeddings, Sprache, Realtime und andere OpenAI-API-Oberflächen außerhalb des Agents. - OpenAI-Agent-API-Schlüssel-Auth: Verwenden Sie
/model openai/gpt-5.5mit einem geordnetenopenai-codex-API-Schlüsselprofil. - Sub-Agents: Routen Sie Programmieraufgaben an einen auf 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.
service_tier = "priority" abgebildet. Sitzungs-/fast-Überschreibungen haben Vorrang vor Konfigurationsstandards.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 enthalten ist, gibt Folgendes 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 erneut
denselben Befehl /model provider/model --runtime codex.Warum sehe ich „Unknown model: minimax/MiniMax-M2.7“?
Warum sehe ich „Unknown model: minimax/MiniMax-M2.7“?
-
Aktualisieren Sie auf eine aktuelle OpenClaw-Version (oder führen Sie aus dem Quellcode von
mainaus) und starten Sie dann das Gateway neu. -
Stellen Sie sicher, dass MiniMax konfiguriert ist (Wizard oder JSON) oder dass MiniMax-Auth
in Env/Auth-Profilen vorhanden ist, damit der passende Provider injiziert werden kann
(
MINIMAX_API_KEYfürminimax,MINIMAX_OAUTH_TOKENoder gespeicherte MiniMax- OAuth-Daten fürminimax-portal). -
Verwenden Sie die genaue Modell-ID (Groß-/Kleinschreibung beachten) für Ihren Auth-Pfad:
minimax/MiniMax-M2.7oderminimax/MiniMax-M2.7-highspeedfür die Einrichtung per API-Schlüssel oderminimax-portal/MiniMax-M2.7/minimax-portal/MiniMax-M2.7-highspeedfür die OAuth-Einrichtung. -
Führen Sie Folgendes aus:
und wählen Sie aus der Liste (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- Agent A Standard: MiniMax
- Agent B Standard: OpenAI
- Routen Sie nach Agent oder verwenden Sie
/agentzum Wechseln
Sind opus / sonnet / gpt integrierte Kurzbefehle?
Sind opus / sonnet / gpt integrierte Kurzbefehle?
agents.defaults.models vorhanden ist):opus→anthropic/claude-opus-4-7sonnet→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-preview
Wie definiere/überschreibe ich Modellkürzel (Aliasse)?
Wie definiere/überschreibe ich Modellkürzel (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 den Provider gefunden, nachdem ein neuer Agent hinzugefügt wurdeDas bedeutet üblicherweise, dass der neue Agent einen leeren Authentifizierungsspeicher hat. Authentifizierung ist agentenspezifisch und
wird hier gespeichert:- Führen Sie
openclaw agents add <id>aus und konfigurieren Sie die Authentifizierung während des Assistenten. - Oder kopieren Sie nur portierbare statische
api_key- /token-Profile aus dem Authentifizierungsspeicher des Haupt-Agenten in den Authentifizierungsspeicher des neuen Agenten. - Melden Sie sich bei OAuth-Profilen vom neuen Agenten aus an, wenn er ein eigenes Konto benötigt; andernfalls kann OpenClaw auf den Standard-/Haupt-Agenten durchlesen, ohne Refresh-Token zu klonen.
agentDir nicht für mehrere Agenten erneut; das verursacht Authentifizierungs-/Sitzungskollisionen.Modell-Failover und „Alle Modelle fehlgeschlagen“
Wie funktioniert Failover?
Wie funktioniert Failover?
- Rotation von Authentifizierungsprofilen 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.Manche abrechnungsähnlichen Antworten sind nicht 402, und einige HTTP-402-
Antworten verbleiben 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 providerspezifische 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 Nutzungslimit oder
Organisations-/Workspace-Ausgabenlimit aussieht (daily limit reached, resets tomorrow,
organization spending limit exceeded), behandelt OpenClaw sie als
rate_limit, nicht als lange 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-spezifische 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-Busy-Fehler wie ModelNotReadyException als
timeout-/überlastungswürdige Failover-Signale, 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 Authentifizierungsspeicher keine Zugangsdaten dafür finden konnte.Checkliste zur Behebung:- Prüfen Sie, wo Authentifizierungsprofile liegen (neue vs. Legacy-Pfade)
- Aktuell:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - Legacy:
~/.openclaw/agent/*(migriert durchopenclaw doctor)
- Aktuell:
- Prüfen Sie, ob Ihre Umgebungsvariable vom Gateway geladen wird
- Wenn Sie
ANTHROPIC_API_KEYin Ihrer Shell setzen, das Gateway aber über systemd/launchd ausführen, wird sie möglicherweise nicht geerbt. 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
- Führen Sie eine Plausibilitätsprüfung von Modell-/Authentifizierungsstatus durch
- Verwenden Sie
openclaw models status, um konfigurierte Modelle und den Authentifizierungsstatus der Provider zu sehen.
- 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. -
Löschen 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 Authentifizierungsprofile auf der Gateway-Maschine, nicht auf Ihrem Laptop.
Warum wurde auch Google Gemini ausprobiert und ist fehlgeschlagen?
Warum wurde auch Google Gemini ausprobiert und ist fehlgeschlagen?
No API key found for provider "google".Behebung: Stellen Sie entweder Google-Authentifizierung bereit, oder entfernen/vermeiden Sie Google-Modelle in agents.defaults.model.fallbacks / Aliasen, damit der Fallback nicht dorthin routet.LLM-Anfrage abgelehnt: Thinking-Signatur erforderlich (Google Antigravity)Ursache: Der Sitzungsverlauf enthält Thinking-Blöcke ohne Signaturen (häufig aus
einem abgebrochenen/partiellen 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.Authentifizierungsprofile: was sie sind und wie Sie sie verwalten
Verwandt: /concepts/oauth (OAuth-Flows, Tokenspeicherung, Muster für mehrere Konten)Was ist ein Authentifizierungsprofil?
Was ist ein Authentifizierungsprofil?
openclaw models auth list aus (optional --provider <id> oder --json). Details finden Sie unter Models CLI.Was sind typische Profil-IDs?
Was sind typische Profil-IDs?
anthropic:default(üblich, wenn keine E-Mail-Identität existiert)anthropic:<email>für OAuth-Identitäten- benutzerdefinierte IDs, die Sie wählen (z. B.
anthropic:work)
Kann ich steuern, welches Authentifizierungsprofil zuerst ausprobiert wird?
Kann ich steuern, welches Authentifizierungsprofil zuerst ausprobiert wird?
auth.order.<provider>). Dies speichert keine Secrets; 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/Authentifizierungsfehler) oder in einem längeren deaktivierten Zustand (Abrechnung/unzureichende Guthaben) befindet. Um dies zu prüfen, führen Sie openclaw models status --json aus und prüfen Sie auth.unusableProfiles. Abstimmung: 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-/Deaktivierungsfenster weiterhin das gesamte 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 auszuprobieren.OAuth vs. API-Schlüssel – worin besteht der Unterschied?
OAuth vs. API-Schlüssel – worin besteht der Unterschied?
- OAuth nutzt oft Abonnementzugriff (wo anwendbar).
- API-Schlüssel verwenden Abrechnung pro Token.