TUI (Terminal UI)

Schnellstart

1. Starte das Gateway.

openclaw gateway

2. Öffne die TUI.

openclaw tui

3. Tippe eine Nachricht und drücke Enter.

Remote-Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Verwende --password, wenn dein Gateway Passwort-Auth nutzt.

Was du siehst

• Kopfzeile: Verbindungs-URL, aktueller Agent, aktuelle Sitzung.
• Chatprotokoll: Benutzernachrichten, Assistentenantworten, Systemhinweise, Tool-Karten.
• Statuszeile: Verbindungs-/Run-Status (verbinden, laufend, streaming, idle, Fehler).
• Fußzeile: Verbindungsstatus + Agent + Sitzung + Modell + Think/Fast/Verbose/Reasoning + Token-Zähler + Deliver.
• Eingabe: Texteditor mit Autovervollständigung.

Denkmodell: Agents + Sitzungen

• Agents sind eindeutige Slugs (z. B. main, research). Das Gateway stellt die Liste bereit.
• Sitzungen gehören zum aktuellen Agent.
• Sitzungsschlüssel werden als agent:<agentId>:<sessionKey> gespeichert.
  • Wenn du /session main tippst, expandiert die TUI es zu agent:<currentAgent>:main.
  • Wenn du /session agent:other:main tippst, wechselst du explizit zu dieser Agent-Sitzung.
• Sitzungsbereich:
  • per-sender (Standard): Jeder Agent hat viele Sitzungen.
  • global: Die TUI nutzt immer die global-Sitzung (die Auswahl kann leer sein).
• Der aktuelle Agent + die Sitzung sind immer in der Fußzeile sichtbar.

Senden + Zustellung

• Nachrichten werden an das Gateway gesendet; Zustellung an Provider ist standardmäßig aus.
• Zustellung aktivieren:
  • /deliver on
  • oder das Einstellungspanel
  • oder mit openclaw tui --deliver starten

Auswahllisten + Overlays

• Modellauswahl: verfügbare Modelle auflisten und Sitzungs-Override setzen.
• Agentauswahl: einen anderen Agent wählen.
• Sitzungsauswahl: zeigt nur Sitzungen für den aktuellen Agent.
• Einstellungen: Deliver, Tool-Ausgabe-Erweiterung und Thinking-Sichtbarkeit umschalten.

Tastenkürzel

• Enter: Nachricht senden
• Esc: aktiven Run abbrechen
• Ctrl+C: Eingabe löschen (zweimal drücken zum Beenden)
• Ctrl+D: Beenden
• Ctrl+L: Modellauswahl
• Ctrl+G: Agentauswahl
• Ctrl+P: Sitzungsauswahl
• Ctrl+O: Tool-Ausgabe-Erweiterung umschalten
• Ctrl+T: Thinking-Sichtbarkeit umschalten (lädt History neu)

Slash-Befehle

Core:

• /help
• /status
• /agent <id> (oder /agents)
• /session <key> (oder /sessions)
• /model <provider/model> (oder /models)

Sitzungssteuerung:

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (Alias: /elev)
• /activation <mention|always>
• /deliver <on|off>

Sitzungslebenszyklus:

• /new oder /reset (Sitzung zurücksetzen)
• /abort (aktiven Run abbrechen)
• /settings
• /exit

Andere Gateway-Slash-Befehle (zum Beispiel /context) werden an das Gateway weitergeleitet und als Systemausgabe angezeigt. Siehe Slash-Befehle.

Lokale Shell-Befehle

• Stelle einer Zeile ! voran, um einen lokalen Shell-Befehl auf dem TUI-Host auszuführen.
• Die TUI fragt einmal pro Sitzung, ob lokale Ausführung erlaubt werden soll; Ablehnung deaktiviert ! für die Sitzung.
• Befehle laufen in einer neuen, nicht-interaktiven Shell im TUI-Arbeitsverzeichnis (kein persistentes cd/env).
• Lokale Shell-Befehle erhalten OPENCLAW_SHELL=tui-local in ihrer Umgebung.
• Ein einzelnes ! wird als normale Nachricht gesendet; führende Leerzeichen lösen keine lokale Ausführung aus.

Tool-Ausgabe

• Tool-Aufrufe werden als Karten mit Argumenten + Ergebnissen angezeigt.
• Ctrl+O schaltet zwischen eingeklappter/erweiterter Ansicht um.
• Während Tools laufen, streamen Teilupdates in dieselbe Karte.

Terminalfarben

• Die TUI belässt Assistenten-Body-Text in der Standard-Vordergrundfarbe deines Terminals, damit dunkle und helle Terminals lesbar bleiben.
• Wenn dein Terminal einen hellen Hintergrund hat und die automatische Erkennung falsch liegt, setze OPENCLAW_THEME=light vor dem Start von openclaw tui.
• Um stattdessen die ursprüngliche dunkle Palette zu erzwingen, setze OPENCLAW_THEME=dark.

History + Streaming

• Bei Verbindung lädt die TUI die neueste History (Standard 200 Nachrichten).
• Streaming-Antworten werden an Ort und Stelle aktualisiert, bis sie finalisiert sind.
• Die TUI hört auch auf Agent-Tool-Events für reichhaltigere Tool-Karten.

Verbindungsdetails

• Die TUI registriert sich beim Gateway als mode: "tui".
• Neuverbindungen zeigen eine Systemnachricht; Event-Lücken werden im Log angezeigt.

Optionen

• --url <url>: Gateway-WebSocket-URL (Standard ist Config oder ws://127.0.0.1:<port>)
• --token <token>: Gateway-Token (wenn erforderlich)
• --password <password>: Gateway-Passwort (wenn erforderlich)
• --session <key>: Sitzungsschlüssel (Standard: main, oder global wenn Bereich global ist)
• --deliver: Assistenten-Antworten an den Provider zustellen (Standard aus)
• --thinking <level>: Thinking-Level für Sends überschreiben
• --timeout-ms <ms>: Agent-Timeout in ms (Standard ist agents.defaults.timeoutSeconds)

Hinweis: Wenn du --url setzt, fällt die TUI nicht auf Konfigurations- oder Umgebungszugangsdaten zurück. Gib --token oder --password explizit an. Fehlende explizite Zugangsdaten sind ein Fehler.

Fehlerbehebung

Keine Ausgabe nach dem Senden einer Nachricht:

• Führe /status in der TUI aus, um zu bestätigen, dass das Gateway verbunden und idle/busy ist.
• Prüfe die Gateway-Logs: openclaw logs --follow.
• Bestätige, dass der Agent laufen kann: openclaw status und openclaw models status.
• Wenn du Nachrichten in einem Chat-Kanal erwartest, aktiviere die Zustellung (/deliver on oder --deliver).
• --history-limit <n>: Zu ladende History-Einträge (Standard 200)

Verbindungs-Fehlerbehebung

• disconnected: Stelle sicher, dass das Gateway läuft und deine --url/--token/--password korrekt sind.
• Keine Agents in der Auswahl: prüfe openclaw agents list und deine Routing-Config.
• Leere Sitzungsauswahl: Du bist möglicherweise im globalen Bereich oder hast noch keine Sitzungen.