> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# FAQ: Modelle und Authentifizierung
Fragen und Antworten zu Modell- und Auth-Profilen. Informationen zu Einrichtung, Sitzungen, Gateway, Kanälen und
Fehlerbehebung finden Sie in der Haupt-[FAQ](/de/help/faq).
## Modelle: Standardwerte, Auswahl, Aliase, Wechsel
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 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.
**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 geringem 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 Arbeit mit hohem Risiko das **beste Modell, das Sie sich leisten können**, und ein günstigeres
Modell für Routine-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 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](/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 wie `ollama pull gemma4`
3. Wenn Sie auch Cloud-Modelle 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
* Für manuelles Wechseln verwenden Sie `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 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 sicherheitssensitive 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 Aliase. Benutzerdefinierte Aliase 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 aus:
```
/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 löse ich ein Profil, 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.
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](/de/concepts/models) und [Modell-Failover](/de/concepts/model-failover).
Ja. Behandeln Sie Modellauswahl und Laufzeitauswahl getrennt:
* **Nativer Codex-Coding-Agent:** Setzen Sie `agents.defaults.model.primary` auf `openai/gpt-5.5`. Melden Sie sich mit `openclaw models auth login --provider openai` an, wenn Sie ChatGPT/Codex-Abonnementauthentifizierung verwenden möchten.
* **Direkte OpenAI-API-Aufgaben außerhalb der Agent-Schleife:** Konfigurieren Sie `OPENAI_API_KEY` fü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.5` mit einem geordneten `openai`-API-Key-Profil.
* **Sub-Agents:** Routen Sie Coding-Aufgaben an einen 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`.
* **Automatischer Grenzwert:** Verwenden Sie `/fast auto` oder `params.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 Sie `params.fastAutoOnSeconds` auf dem aktiven Modell, um ihn zu ändern.
Beispiel:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: {
fastMode: "auto",
fastAutoOnSeconds: 30,
},
},
},
},
},
}
```
Für OpenAI wird der Schnellmodus bei unterstützten nativen Responses-Anfragen auf `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](/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 steht, gibt 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 exakte 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 denselben Befehl
`/model provider/model --runtime codex` erneut.
Das bedeutet, dass der **Provider nicht konfiguriert ist** (keine MiniMax-Provider-Konfiguration und kein Auth-
Profil wurde gefunden), sodass das Modell nicht aufgelöst werden kann.
Checkliste zur Behebung:
1. Aktualisieren Sie auf eine aktuelle OpenClaw-Version (oder führen Sie aus dem Quellzweig `main` aus) und starten Sie dann das Gateway neu.
2. 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_KEY` für `minimax`, `MINIMAX_OAUTH_TOKEN` oder gespeichertes MiniMax-
OAuth für `minimax-portal`).
3. Verwenden Sie die exakte Modell-ID (Groß-/Kleinschreibung beachten) für Ihren Auth-Pfad:
`minimax/MiniMax-M3`, `minimax/MiniMax-M2.7` oder
`minimax/MiniMax-M2.7-highspeed` für API-Key-Einrichtung, oder
`minimax-portal/MiniMax-M3`, `minimax-portal/MiniMax-M2.7` oder
`minimax-portal/MiniMax-M2.7-highspeed` für OAuth-Einrichtung.
4. Führen Sie aus:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list
```
und wählen Sie aus der Liste aus (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**, nicht für "schwere Aufgaben", verwenden Sie daher `/model` oder einen separaten Agent.
**Option A: pro Sitzung wechseln**
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
agents: {
defaults: {
model: { primary: "minimax/MiniMax-M3" },
models: {
"minimax/MiniMax-M3": { alias: "minimax" },
"openai/gpt-5.5": { alias: "gpt" },
},
},
},
}
```
Dann:
```
/model gpt
```
**Option B: separate Agents**
* Standard für Agent A: MiniMax
* Standard für Agent B: OpenAI
* Nach Agent routen oder `/agent` zum Wechseln verwenden
Docs: [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-8`
* `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`
Wenn Sie einen eigenen Alias mit demselben Namen festlegen, hat Ihr Wert Vorrang.
Aliasse stammen aus `agents.defaults.models..alias`. Beispiel:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-6" },
models: {
"anthropic/claude-opus-4-6": { alias: "opus" },
"anthropic/claude-sonnet-4-6": { alias: "sonnet" },
},
},
},
}
```
Danach wird `/model sonnet` (oder `/`, sofern unterstützt) zu dieser Modell-ID aufgelöst.
OpenRouter (Pay-per-Token; viele Modelle):
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
model: { primary: "zai/glm-5" },
models: { "zai/glm-5": {} },
},
},
env: { ZAI_API_KEY: "..." },
}
```
Wenn Sie auf einen Provider/ein Modell verweisen, aber der erforderliche Provider-Schlüssel fehlt, erhalten Sie einen Laufzeit-Authentifizierungsfehler (z. B. `No API key found for provider "zai"`).
**Kein API-Schlüssel für Provider gefunden, nachdem ein neuer Agent hinzugefügt wurde**
Das bedeutet üblicherweise, dass der **neue Agent** einen leeren Auth-Speicher hat. Auth ist agentenspezifisch und
wird hier gespeichert:
```
~/.openclaw/agents//agent/auth-profiles.json
```
Behebungsoptionen:
* Führen Sie `openclaw agents add ` 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.
Verwenden Sie `agentDir` **nicht** agentenübergreifend wieder; das verursacht Auth-/Sitzungskollisionen.
## Modell-Failover und "Alle Modelle fehlgeschlagen"
Failover erfolgt in zwei Phasen:
1. **Auth-Profil-Rotation** innerhalb desselben Providers.
2. **Modell-Fallback** zum nächsten Modell in `agents.defaults.model.fallbacks`.
Cooldowns gelten für fehlgeschlagene 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 nur 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.
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.
Es bedeutet, dass das System versucht hat, die Auth-Profil-ID `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//agent/auth-profiles.json`
* Legacy: `~/.openclaw/agent/*` (migriert durch `openclaw doctor`)
* **Bestätigen Sie, dass Ihre Umgebungsvariable vom Gateway geladen wird**
* Wenn Sie `ANTHROPIC_API_KEY` in Ihrer Shell setzen, den Gateway aber über systemd/launchd ausführen, übernimmt er sie möglicherweise nicht. 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.
* **Prüfen Sie den Modell-/Auth-Status grob**
* Verwenden Sie `openclaw models status`, um konfigurierte Modelle zu sehen und ob Provider authentifiziert sind.
**Checkliste zur Behebung für "No credentials found for profile anthropic"**
Das bedeutet, dass der Lauf an ein Anthropic-Auth-Profil gebunden ist, der Gateway
es aber nicht in seinem Auth-Speicher 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.
* Entfernen Sie jede festgelegte Reihenfolge, die ein fehlendes Profil erzwingt:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth order clear --provider anthropic
```
* **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.
Wenn Ihre Modellkonfiguration Google Gemini als Fallback enthält (oder Sie zu einer Gemini-Kurzform gewechselt haben), versucht OpenClaw dies während des Modell-Fallbacks. Wenn Sie keine Google-Anmeldedaten konfiguriert haben, sehen Sie `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](/de/concepts/oauth) (OAuth-Flows, Token-Speicherung, Multi-Account-Muster)
Ein Auth-Profil ist ein benannter Anmeldedatensatz (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 [Modelle-CLI](/de/cli/models#auth-profiles).
OpenClaw verwendet Provider-präfixierte IDs wie:
* `anthropic:default` (üblich, wenn keine E-Mail-Identität vorhanden ist)
* `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.`). 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:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth order set --provider anthropic --agent main anthropic:default
```
Um zu verifizieren, was tatsächlich versucht wird, verwenden Sie:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 zu versuchen.
OpenClaw unterstützt beides:
* **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](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)
für den aktuellen Pausenhinweis.
* **API-Schlüssel** verwenden Pay-per-Token-Abrechnung.
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)