Modelle-CLI

​

So funktioniert die Modellauswahl

​

Auswahlquelle und Fallback-Verhalten

• Konfigurierte Standards (agents.defaults.model.primary und agent-spezifische Primärmodelle) sind der normale Ausgangspunkt und verwenden agents.defaults.model.fallbacks.
• Automatische Fallback-Auswahlen sind temporärer Wiederherstellungszustand. Sie werden mit modelOverrideSource: "auto" gespeichert, damit spätere Durchläufe die Fallback-Kette weiter verwenden können, ohne jedes Mal ein bekannt defektes Primärmodell zu prüfen; OpenClaw prüft das ursprüngliche Primärmodell regelmäßig erneut, löscht die automatische Auswahl, wenn es sich erholt, und kündigt Fallback-/Wiederherstellungsübergänge einmal pro Zustandsänderung an.
• Benutzersitzungsauswahlen sind exakt. /model, die Modellauswahl, session_status(model=...) und sessions.patch speichern modelOverrideSource: "user"; wenn dieser ausgewählte Provider/dieses ausgewählte Modell nicht erreichbar ist, schlägt OpenClaw sichtbar fehl, statt auf ein anderes konfiguriertes Modell zurückzufallen.
• Das Ändern von agents.defaults.model.primary schreibt bestehende Sitzungsauswahlen nicht um. Wenn der Status This session is pinned to X; config primary Y will apply to new/unpinned sessions. meldet, löschen Sie die aktuelle Sitzungsauswahl mit /model default, damit sie wieder das konfigurierte Primärmodell erbt.
• Cron --model / Payload model ist ein Primärmodell pro Job. Es verwendet weiterhin konfigurierte Fallbacks, sofern der Job keine expliziten Payload-fallbacks bereitstellt (verwenden Sie fallbacks: [] für einen strikten Cron-Lauf).
• CLI-Standardmodell- und Allowlist-Auswahlen respektieren models.mode: "replace", indem sie explizite models.providers.*.models auflisten, statt den vollständigen eingebauten Katalog zu laden.
• Die Control-UI-Modellauswahl fragt beim Gateway die konfigurierte Modellansicht ab: agents.defaults.models, falls vorhanden, einschließlich providerweiter provider/*-Einträge, andernfalls explizite models.providers.*.models plus Provider mit verwendbarer Authentifizierung. Der vollständige eingebaute Katalog ist expliziten Browsing-Ansichten vorbehalten, etwa models.list mit view: "all" oder openclaw models list --all.

​

Kurze Modellrichtlinie

• Legen Sie Ihr Primärmodell auf das stärkste Modell der neuesten Generation fest, das Ihnen zur Verfügung steht.
• Verwenden Sie Fallbacks für kosten-/latenzempfindliche Aufgaben und Chats mit geringeren Anforderungen.
• Vermeiden Sie bei Tool-fähigen Agenten oder nicht vertrauenswürdigen Eingaben ältere/schwächere Modellstufen.

​

Onboarding (empfohlen)

openclaw onboard

​

Konfigurationsschlüssel (Überblick)

• agents.defaults.model.primary und agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary und agents.defaults.imageModel.fallbacks
• agents.defaults.pdfModel.primary und agents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary und agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary und agents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models (Allowlist + Aliase + Provider-Parameter + dynamische Provider-Einträge provider/*)
• models.providers (benutzerdefinierte Provider, die in models.json geschrieben werden)

​

Sichere Allowlist-Bearbeitungen

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

„Modell ist nicht erlaubt“ (und warum Antworten stoppen)

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-6" },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
}

​

Modelle im Chat wechseln (/model)

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

​

CLI-Befehle

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

​

models list

​

models status

claude auth login
openclaw models status

​

Scanning (kostenlose OpenRouter-Modelle)

1. Bildunterstützung
2. Tool-Latenz
3. Kontextgröße
4. Parameteranzahl

• OpenRouter-/models-Liste (Filter :free)
• Live-Prüfungen erfordern einen OpenRouter-API-Schlüssel aus Auth-Profilen oder OPENROUTER_API_KEY (siehe Umgebungsvariablen)
• Optionale Filter: --max-age-days, --min-params, --provider, --max-candidates
• Anforderungs-/Prüfsteuerung: --timeout, --concurrency

​

Modellregistrierung (models.json)

​

Verwandte Themen

• Agent-Runtimes — OpenClaw, Codex und andere Agent-Loop-Runtimes
• Konfigurationsreferenz — Modellkonfigurationsschlüssel
• Bildgenerierung — Bildmodellkonfiguration
• Modell-Failover — Fallback-Ketten
• Modell-Provider — Provider-Routing und Auth
• Musikgenerierung — Musikmodellkonfiguration
• Videogenerierung — Videomodellkonfiguration