--- read_when: - Modelle auswählen oder wechseln, Aliasse konfigurieren - Fehlersuche beim Modell-Failover / "Alle Modelle sind fehlgeschlagen" - Authentifizierungsprofile verstehen und verwalten sidebarTitle: Models FAQ summary: 'FAQ: Modellvorgaben, Auswahl, Aliasse, Wechsel, Failover und Authentifizierungsprofile' title: 'FAQ: Modelle und Authentifizierung' x-i18n: generated_at: "2026-05-12T04:10:36Z" model: gpt-5.5 provider: openai source_hash: a42a8c24798908c7782a9f0c6f0af3fac0c1ad4e5f80d64778f6fd7e1e174f3b source_path: help/faq-models.md workflow: 16 --- Fragen und Antworten zu Modellen und Auth-Profilen. Informationen zu Einrichtung, Sitzungen, Gateway, Channels und Fehlerbehebung finden Sie in der Haupt-[FAQ](/de/help/faq). ## Modelle: Standardwerte, Auswahl, Aliasse, Wechseln Das Standardmodell von OpenClaw ist das, was Sie hier festlegen: ``` agents.defaults.model.primary ``` Modelle werden als `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. **Empfohlener Standard:** Verwenden Sie das stärkste Modell der neuesten Generation, das in Ihrem Provider-Stack verfügbar ist. **Für Agents mit Tools oder nicht vertrauenswürdigen Eingaben:** Priorisieren Sie Modellstärke vor Kosten. **Für routinemäßigen Chat mit niedrigem Risiko:** Verwenden Sie günstigere Fallback-Modelle und routen Sie nach Agent-Rolle. MiniMax hat eigene Dokumentation: [MiniMax](/de/providers/minimax) und [Lokale Modelle](/de/gateway/local-models). Faustregel: Verwenden Sie für kritische Aufgaben das **beste Modell, das Sie sich leisten können**, und ein günstigeres Modell für routinemäßigen Chat oder Zusammenfassungen. Sie können Modelle pro Agent routen und Sub-Agents verwenden, um lange Aufgaben zu parallelisieren (jeder Sub-Agent verbraucht Tokens). Siehe [Modelle](/de/concepts/models) und [Sub-Agents](/de/tools/subagents). Deutliche Warnung: Schwächere oder übermäßig quantisierte Modelle sind anfälliger für Prompt Injection und unsicheres Verhalten. Siehe [Sicherheit](/de/gateway/security). Mehr Kontext: [Modelle](/de/concepts/models). Verwenden Sie **Modellbefehle** oder bearbeiten Sie nur die **model**-Felder. Vermeiden Sie vollständige Konfigurationsersetzungen. Sichere Optionen: - `/model` im Chat (schnell, pro Sitzung) - `openclaw models set ...` (aktualisiert nur die Modellkonfiguration) - `openclaw configure --section model` (interaktiv) - `agents.defaults.model` in `~/.openclaw/openclaw.json` bearbeiten Vermeiden Sie `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](/de/concepts/models), [Konfigurieren](/de/cli/configure), [Konfiguration](/de/cli/config), [Doctor](/de/gateway/doctor). Ja. Ollama ist der einfachste Weg für lokale Modelle. Schnellste Einrichtung: 1. Installieren Sie Ollama von `https://ollama.com/download` 2. Laden Sie ein lokales Modell, zum Beispiel `ollama pull gemma4` 3. Wenn Sie auch Cloud-Modelle verwenden möchten, führen Sie `ollama signin` aus 4. Führen Sie `openclaw onboard` aus und wählen Sie `Ollama` 5. Wählen Sie `Local` oder `Cloud + Local` Hinweise: - `Cloud + Local` gibt Ihnen Cloud-Modelle plus Ihre lokalen Ollama-Modelle - Cloud-Modelle wie `kimi-k2.5:cloud` benötigen keinen lokalen Pull - Verwenden Sie für manuelles Wechseln `openclaw models list` und `openclaw models set ollama/` Sicherheitshinweis: Kleinere oder stark quantisierte Modelle sind anfälliger für Prompt Injection. Wir empfehlen nachdrücklich **große Modelle** für jeden Bot, der Tools verwenden kann. Wenn Sie dennoch kleine Modelle verwenden möchten, aktivieren Sie Sandboxing und strikte Tool-Allowlists. Dokumentation: [Ollama](/de/providers/ollama), [Lokale Modelle](/de/gateway/local-models), [Modell-Provider](/de/concepts/model-providers), [Sicherheit](/de/gateway/security), [Sandboxing](/de/gateway/sandboxing). - 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. Verwenden Sie den Befehl `/model` als eigenständige Nachricht: ``` /model sonnet /model opus /model gpt /model gpt-mini /model gemini /model gemini-flash /model gemini-flash-lite ``` Dies sind die integrierten Aliasse. Benutzerdefinierte Aliasse können über `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 3 ``` Sie können auch ein bestimmtes Auth-Profil für den Provider erzwingen (pro Sitzung): ``` /model opus@anthropic:default /model opus@anthropic:work ``` Tipp: `/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 anthropic/claude-opus-4-6 ``` Wenn Sie zum Standard zurückkehren möchten, wählen Sie ihn aus `/model` aus (oder senden Sie `/model `). Verwenden Sie `/model status`, um zu bestätigen, welches Auth-Profil aktiv ist. `/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](/de/concepts/models) und [Modell-Failover](/de/concepts/model-failover). Ja. Behandeln Sie Modellauswahl und Laufzeitauswahl getrennt: - **Nativer Codex-Programmier-Agent:** Setzen Sie `agents.defaults.model.primary` auf `openai/gpt-5.5`. Melden Sie sich mit `openclaw models auth login --provider openai-codex` an, wenn Sie ChatGPT/Codex-Abonnement-Auth verwenden möchten. - **Direkte OpenAI-API-Aufgaben außerhalb des Agent-Loops:** Konfigurieren Sie `OPENAI_API_KEY` fü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.5` mit einem geordneten `openai-codex`-API-Schlüsselprofil. - **Sub-Agents:** Routen Sie Programmieraufgaben an einen auf Codex fokussierten Agent mit eigenem Modell `openai/gpt-5.5`. Siehe [Modelle](/de/concepts/models) und [Slash-Befehle](/de/tools/slash-commands). Verwenden Sie entweder einen Sitzungsumschalter oder einen Konfigurationsstandard: - **Pro Sitzung:** Senden Sie `/fast on`, während die Sitzung `openai/gpt-5.5` verwendet. - **Pro Modellstandard:** Setzen Sie `agents.defaults.models["openai/gpt-5.5"].params.fastMode` auf `true`. Beispiel: ```json5 { agents: { defaults: { models: { "openai/gpt-5.5": { params: { fastMode: true, }, }, }, }, }, } ``` Für OpenAI wird der Schnellmodus bei unterstützten nativen Responses-Anfragen auf `service_tier = "priority"` abgebildet. Sitzungs-`/fast`-Überschreibungen haben Vorrang vor Konfigurationsstandards. Siehe [Thinking und Schnellmodus](/de/tools/thinking) und [OpenAI-Schnellmodus](/de/providers/openai#fast-mode). Wenn `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: ``` Model "provider/model" is not allowed. Use /models to list providers, or /models to list models. Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge ``` Dieser Fehler wird **anstelle** einer normalen Antwort zurückgegeben. Lösung: Fügen Sie das genaue Modell zu `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`. Das bedeutet, dass der **Provider nicht konfiguriert ist** (es wurde keine MiniMax-Provider-Konfiguration und kein Auth- Profil gefunden), daher kann das Modell nicht aufgelöst werden. Checkliste zur Behebung: 1. Aktualisieren Sie auf eine aktuelle OpenClaw-Version (oder führen Sie aus dem Quellcode von `main` aus) und starten Sie dann das Gateway neu. 2. 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_KEY` für `minimax`, `MINIMAX_OAUTH_TOKEN` oder gespeicherte MiniMax- OAuth-Daten für `minimax-portal`). 3. Verwenden Sie die genaue Modell-ID (Groß-/Kleinschreibung beachten) für Ihren Auth-Pfad: `minimax/MiniMax-M2.7` oder `minimax/MiniMax-M2.7-highspeed` für die Einrichtung per API-Schlüssel oder `minimax-portal/MiniMax-M2.7` / `minimax-portal/MiniMax-M2.7-highspeed` für die OAuth-Einrichtung. 4. Führen Sie Folgendes aus: ```bash openclaw models list ``` und wählen Sie aus der Liste (oder `/model list` im Chat). Siehe [MiniMax](/de/providers/minimax) und [Modelle](/de/concepts/models). Ja. Verwenden Sie **MiniMax als Standard** und wechseln Sie Modelle **pro Sitzung**, wenn nötig. Fallbacks sind für **Fehler** gedacht, nicht für „schwierige Aufgaben“, verwenden Sie also `/model` oder einen separaten Agent. **Option A: pro Sitzung wechseln** ```json5 { env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" }, models: { "minimax/MiniMax-M2.7": { alias: "minimax" }, "openai/gpt-5.5": { alias: "gpt" }, }, }, }, } ``` Dann: ``` /model gpt ``` **Option B: separate Agents** - Agent A Standard: MiniMax - Agent B Standard: OpenAI - Routen Sie nach Agent oder verwenden Sie `/agent` zum Wechseln Dokumentation: [Modelle](/de/concepts/models), [Multi-Agent-Routing](/de/concepts/multi-agent), [MiniMax](/de/providers/minimax), [OpenAI](/de/providers/openai). Ja. OpenClaw liefert einige Standard-Kurzformen mit (sie werden nur angewendet, wenn das Modell in `agents.defaults.models` vorhanden ist): - `opus` → `anthropic/claude-opus-4-7` - `sonnet` → `anthropic/claude-sonnet-4-6` - `gpt` → `openai/gpt-5.4` - `gpt-mini` → `openai/gpt-5.4-mini` - `gpt-nano` → `openai/gpt-5.4-nano` - `gemini` → `google/gemini-3.1-pro-preview` - `gemini-flash` → `google/gemini-3-flash-preview` - `gemini-flash-lite` → `google/gemini-3.1-flash-lite-preview` Wenn Sie Ihren eigenen Alias mit demselben Namen festlegen, hat Ihr Wert Vorrang. Aliasse stammen aus `agents.defaults.models..alias`. Beispiel: ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { alias: "opus" }, "anthropic/claude-sonnet-4-6": { alias: "sonnet" }, "anthropic/claude-haiku-4-5": { alias: "haiku" }, }, }, }, } ``` Dann wird `/model sonnet` (oder `/`, sofern unterstützt) zu dieser Modell-ID aufgelöst. OpenRouter (Abrechnung pro Token; viele Modelle): ```json5 { agents: { defaults: { model: { primary: "openrouter/anthropic/claude-sonnet-4-6" }, models: { "openrouter/anthropic/claude-sonnet-4-6": {} }, }, }, env: { OPENROUTER_API_KEY: "sk-or-..." }, } ``` Z.AI (GLM-Modelle): ```json5 { agents: { defaults: { model: { primary: "zai/glm-5" }, models: { "zai/glm-5": {} }, }, }, env: { ZAI_API_KEY: "..." }, } ``` Wenn Sie einen Provider/ein Modell referenzieren, aber der erforderliche Provider-Schlüssel fehlt, erhalten Sie einen Authentifizierungsfehler zur Laufzeit (z. B. `No API key found for provider "zai"`). **Kein API-Schlüssel für den Provider gefunden, nachdem ein neuer Agent hinzugefügt wurde** Das bedeutet üblicherweise, dass der **neue Agent** einen leeren Authentifizierungsspeicher hat. Authentifizierung ist agentenspezifisch und wird hier gespeichert: ``` ~/.openclaw/agents//agent/auth-profiles.json ``` Behebungsoptionen: - Führen Sie `openclaw agents add ` 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. Verwenden Sie `agentDir` **nicht** für mehrere Agenten erneut; das verursacht Authentifizierungs-/Sitzungskollisionen. ## Modell-Failover und „Alle Modelle fehlgeschlagen“ Failover erfolgt in zwei Stufen: 1. **Rotation von Authentifizierungsprofilen** innerhalb desselben Providers. 2. **Modell-Fallback** zum nächsten Modell in `agents.defaults.model.fallbacks`. Cooldowns gelten für fehlschlagende Profile (exponentielles Backoff), sodass OpenClaw weiter antworten kann, auch wenn ein Provider rate-limitiert ist oder vorübergehend fehlschlägt. Der Rate-Limit-Bucket umfasst mehr als einfache `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. Es bedeutet, dass das System versucht hat, die Authentifizierungsprofil-ID `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//agent/auth-profiles.json` - Legacy: `~/.openclaw/agent/*` (migriert durch `openclaw doctor`) - **Prüfen Sie, ob Ihre Umgebungsvariable vom Gateway geladen wird** - Wenn Sie `ANTHROPIC_API_KEY` in Ihrer Shell setzen, das Gateway aber über systemd/launchd ausführen, wird sie möglicherweise nicht geerbt. Legen Sie sie in `~/.openclaw/.env` ab oder aktivieren Sie `env.shellEnv`. - **Stellen Sie sicher, dass Sie den richtigen Agenten bearbeiten** - Multi-Agent-Setups bedeuten, dass es mehrere `auth-profiles.json`-Dateien geben kann. - **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. **Checkliste zur Behebung von „No credentials found for profile anthropic“** Das bedeutet, dass der Lauf an ein Anthropic-Authentifizierungsprofil gebunden ist, das Gateway es aber in seinem Authentifizierungsspeicher nicht finden kann. - **Claude CLI verwenden** - Führen Sie `openclaw models auth login --provider anthropic --method cli --set-default` auf dem Gateway-Host aus. - **Wenn Sie stattdessen einen API-Schlüssel verwenden möchten** - Legen Sie `ANTHROPIC_API_KEY` in `~/.openclaw/.env` auf dem **Gateway-Host** ab. - Löschen Sie jede festgelegte Reihenfolge, die ein fehlendes Profil erzwingt: ```bash openclaw models auth order clear --provider anthropic ``` - **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. Wenn Ihre Modellkonfiguration Google Gemini als Fallback enthält (oder Sie zu einem Gemini-Kürzel gewechselt haben), versucht OpenClaw es während des Modell-Fallbacks. Wenn Sie keine Google-Zugangsdaten konfiguriert haben, sehen Sie `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](/de/concepts/oauth) (OAuth-Flows, Tokenspeicherung, Muster für mehrere Konten) Ein Authentifizierungsprofil ist ein benannter Zugangsdaten-Datensatz (OAuth oder API-Schlüssel), der an einen Provider gebunden ist. Profile liegen in: ``` ~/.openclaw/agents//agent/auth-profiles.json ``` Um gespeicherte Profile zu prüfen, ohne Secrets auszugeben, führen Sie `openclaw models auth list` aus (optional `--provider ` oder `--json`). Details finden Sie unter [Models CLI](/de/cli/models#auth-profiles). OpenClaw verwendet Provider-präfixierte IDs wie: - `anthropic:default` (üblich, wenn keine E-Mail-Identität existiert) - `anthropic:` für OAuth-Identitäten - benutzerdefinierte IDs, die Sie wählen (z. B. `anthropic:work`) Ja. Die Konfiguration unterstützt optionale Metadaten für Profile und eine Reihenfolge pro Provider (`auth.order.`). 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: ```bash # Defaults to the configured default agent (omit --agent) openclaw models auth order get --provider anthropic # Lock rotation to a single profile (only try this one) openclaw models auth order set --provider anthropic anthropic:default # Or set an explicit order (fallback within provider) openclaw models auth order set --provider anthropic anthropic:work anthropic:default # Clear override (fall back to config auth.order / round-robin) openclaw models auth order clear --provider anthropic ``` Um einen bestimmten Agenten anzusprechen: ```bash openclaw models auth order set --provider anthropic --agent main anthropic:default ``` Um zu überprüfen, was tatsächlich ausprobiert wird, verwenden Sie: ```bash openclaw models status --probe ``` Wenn ein gespeichertes Profil in der expliziten Reihenfolge ausgelassen wird, meldet probe `excluded_by_auth_order` für dieses Profil, statt es stillschweigend auszuprobieren. OpenClaw unterstützt beides: - **OAuth** nutzt oft Abonnementzugriff (wo anwendbar). - **API-Schlüssel** verwenden Abrechnung pro Token. Der Assistent unterstützt ausdrücklich Anthropic Claude CLI, OpenAI Codex OAuth und API-Schlüssel. ## Verwandt - [FAQ](/de/help/faq) — die Haupt-FAQ - [FAQ — Schnellstart und Einrichtung beim ersten Start](/de/help/faq-first-run) - [Modellauswahl](/de/concepts/model-providers) - [Modell-Failover](/de/concepts/model-failover)