CLI-Backends von OpenClaw

Wenn ein API-Anbieter ausfällt, gedrosselt wird oder sich fehlerhaft verhält, kann OpenClaw eine lokale KI-CLI als reinen Text-Fallback ausführen. Die Dokumentation legt die Form bewusst fest: Tools werden nicht direkt eingespeist, ein Backend kann Gateway-Tools aber über eine Loopback-MCP-Bridge erhalten; Streaming erfolgt als JSONL, wo die CLI es unterstützt; Sitzungen werden unterstützt, damit Folgefragen zusammenhängend bleiben; und Bilder werden durchgereicht, wenn die CLI Pfade akzeptiert. Es ist ein Sicherheitsnetz, kein primärer Weg, und nicht ACP. Hier sind der Schnellstart, die Fallback-Verdrahtung, die Mechanik eines Turns, die Besonderheiten der Claude CLI, Sitzungen, die MCP-Bridge, die Kompaktierung und die Grenzen.

Schnellstart und Fallback

• Das mitgelieferte Anthropic-Plugin registriert ein Claude-CLI-Backend, das ohne weitere Konfiguration funktioniert, solange Claude Code installiert und angemeldet ist; ein Agent-Lauf mit einer einzigen Nachricht und einer Claude-CLI-Modellreferenz beweist es. Der Gateway-Dienst muss die CLI in seinem Suchpfad haben, und für eine nicht standardmäßige ausführbare Datei braucht es ein Backend-Plugin.
• Um es nur dann zu verwenden, wenn die primären Modelle versagen, fügen Sie der Fallback-Liste ein Claude-CLI-Modell hinzu; konfigurierte Fallbacks bleiben zulässig, wenn das primäre Modell an Authentifizierung, Rate-Limits oder Timeouts scheitert, selbst wenn sie nicht in der Allow-Richtlinie für Modelle stehen, die nur für die direkte Auswahl zählt.
• Um ein kanonisches Anthropic-Modell über die CLI zu leiten, setzen Sie bei diesem Modell die Agent-Runtime-ID; Zugangsdaten bleiben in Auth-Profilen oder in der Konfiguration des Plugins, und Befehl, Argumente, Umgebung, Parsing, Sitzungen, Bilder und Watchdog-Mechanik sind Plugin-Code.
• Ein Turn wählt das Backend anhand des Anbieterpräfixes, baut den System-Prompt aus demselben OpenClaw-Prompt und Workspace-Kontext, führt die CLI, wo unterstützt, mit einer Sitzungs-ID aus, parst JSON oder Text und speichert Sitzungs-IDs pro Backend, damit Folgefragen die Sitzung wiederverwenden.

Nutzen Sie es als Sicherheitsnetz für Textantworten, die „immer funktionieren“, nicht als primären Weg.

Besonderheiten der Claude CLI

Das mitgelieferte Backend spricht mit der installierten ausführbaren Datei von Claude Code über deren strukturiertes stdio-Protokoll, hält einen warmen Subprozess über kompatible Turns hinweg am Leben, startet einen neuen, wenn sich Modell, System-Prompt oder Tool-Richtlinie ändern, und setzt nach einem Neustart anhand gespeicherter Sitzungs-IDs fort; Claude Code verwaltet seine Anmeldung und sein Abonnement selbst, und OpenClaw liest, speichert, erneuert oder übermittelt native Tokens nie. Kontext aus Prompt-Build-Hooks erreicht Claude als nativer Hook-Anhang, gespeicherte Sitzungsnotizen werden innerhalb eines begrenzten, gewichteten Budgets erneut eingespielt, der native Skill-Resolver wird über ein temporäres Plugin-Verzeichnis genutzt, wenn ein Skill einen materialisierten Pfad hat, und die Git-Anweisungen von Claude Code sind deaktiviert, damit Änderungen im Workspace seinen zwischengespeicherten Verlauf nicht ungültig machen. Claude Code startet in seinem Standard-Berechtigungsmodus, während die Berechtigungsantworten und der Pre-Tool-Hook von OpenClaw die nativen Tools unter der Kontrolle des Hosts halten und native Tool-Namen und Dateiargumente vor Exec-Richtlinie und Freigabe auf ihre OpenClaw-Entsprechungen abbilden. Wenn die Exec-Ask-Einstellung eine Nachfrage auslöst, werden native Tool-Anfragen an den Kanal der Sitzung weitergeleitet, mit den Optionen einmal erlauben, immer erlauben (für dieselbe warme Sitzung) und ablehnen; ein Timeout, eine nicht erreichbare Route oder ein abgeschlossener Turn führen jeweils zur Ablehnung, und immer erlauben gilt nie für Bash. Thinking-Stufen werden auf das Effort-Flag von Claude Code abgebildet und bei Modellen mit festem Budget auf einen Wert für die maximalen Thinking-Tokens, und sowohl die native Anmeldung als auch ein eingefügtes Abonnement-Token funktionieren.

Natives Bash, Sitzungen, die Bridge

• Mit der Ask-Einstellung on-miss werden native Bash-Befehle mit dem OpenClaw-eigenen Shell-Evaluator gegen die Exec-Zulassungsliste des Agenten geprüft: Ein Aufruf läuft nur dann ohne Nachfrage, wenn jedes Segment zu einem Binary auf der Zulassungsliste aufgelöst wird und vollständig gebunden werden kann; Pipelines, Substitutionen, Subshells und Umleitungen werden vor jeder Nachfrage abgelehnt. Das ist eine Richtlinie auf Argumentebene für den Befehl, den Claude Code ausführen wird, keine Ausführung in einer Sandbox, denn Arbeitsverzeichnis, Pfad, Umgebung und Sandboxing verwaltet Claude Code.
• Gespeicherte CLI-Sitzungen sind eine vom Anbieter verwaltete Kontinuität, die vor dem Fortsetzen gegen ein lesbares Transkript geprüft wird; neue Sitzungen können den OpenClaw-Verlauf aus der Sitzungsdatenbank wiederherstellen, wenn die Kontogrenze zu den ausgewählten Zugangsdaten passt, und ein privater Konto-Fingerabdruck mit lückenloser Transkriptabdeckung entscheidet über die Zulässigkeit. Ein Kontowechsel macht gemischten Verlauf also unzulässig, und eine geänderte Auth-Identität beendet die Wiederverwendung der Sitzung. Ein fehlgeschlagener Claude-CLI-Versuch kann auf ein Nicht-CLI-Modell ausweichen, das mit einem Vorspann aus dem lokalen Transkript von Claude Code versorgt wird: seiner letzten Kompaktierungszusammenfassung plus den jüngsten Turns.
• Ein Backend, das sich für das Bundle-MCP-Overlay entscheidet, erhält einen Loopback-HTTP-MCP-Server, der dem CLI-Prozess Gateway-Tools unter einem Token pro Lauf bereitstellt, gebunden an die vom Gateway ausgewählte Sitzung, das Konto und den Kanal; Allow- und Deny-Richtlinien schränken auch native MCP-Server ein, eingeschränkte Läufe wie Cron-Jobs deaktivieren die nativen Tools und Anpassungen von Claude vollständig und stellen nur die erlaubten OpenClaw-Tools bereit, und sitzungsgebundene Bridge-Runtimes werden nach zehn Minuten Leerlauf beendet.

OpenClaw und Claude Code ist dieselbe Kombination von der anderen Seite aus betrachtet, und Modell-Failover in OpenClaw beschreibt den Mechanismus, der entscheidet, wann der Fallback läuft.

Timeouts, Kompaktierung, Grenzen

Zwei unabhängige Grenzen: das Budget für einen Agent-Turn, standardmäßig achtundvierzig Stunden und 0 für unbegrenzt, und der Watchdog für ausbleibende CLI-Ausgabe, den das Backend verwaltet und der auch dann aktiv ist, wenn das Turn-Budget unbegrenzt ist. Hintergrundarbeit, die innerhalb einer CLI gestartet wird, stirbt mit dem Subprozess, wenn der Turn endet; dauerhafte lange Arbeit gehört also in einen abgekoppelten Sub-Agenten. Das Claude-CLI-Backend erklärt, dass es die native Kompaktierung selbst übernimmt; OpenClaw überlässt sie daher Claude Code und reicht das Kontextbudget über das Auto-Compact-Fenster von Claude Code weiter, während ein expliziter Compact-Befehl die gebundene Sitzung fortsetzt und den nativen Befehl sendet. Auch das Gemini-CLI-Backend übernimmt seine Kompaktierung selbst, ohne manuellen Befehl. Anthropic verantwortet das Claude-Backend und Google das Gemini-Backend, dessen Voraussetzungen die CLI im Suchpfad und ein Schlüsselprofil für Google AI Studio sind; ein mitgeliefertes Codex-CLI-Backend gibt es nicht, da Codex über das App-Server-Harness läuft. Die Grenzen: keine Tool-Aufrufe, die ohne die Bridge ins CLI-Protokoll eingespeist werden, Streaming, das je nach Backend variiert, und strukturierte Ausgaben, die vom eigenen JSON der CLI abhängen. Der Beitrag zu den Exec-Freigaben in OpenClaw behandelt die Zulassungsliste, gegen die natives Bash geprüft wird, und der Beitrag zu OpenClaw und Gemini den Anbieter hinter dem zweiten mitgelieferten Backend.

Auf Diali

Auf Diali gibt es keine Host-CLI, auf die man ausweichen könnte: Der Weg zum Modell führt über den API-Schlüssel im Vault oder die verwalteten Credits, und das Failover erfolgt zwischen Anbietern statt auf ein lokales Binary. Gehostetes OpenClaw auf Diali ist der Assistent, und Modelle und Anbieter in OpenClaw behandelt die Anbieter, die dieser Weg nutzen kann.

• Ein Fallback, kein primärer Weg.
• Warmer Subprozess, native Anmeldung, Tools nur über die Bridge.
• Natives Bash wird von OpenClaw per Zulassungsliste geprüft, nie in eine Sandbox gesteckt.