OpenClaw TUI starten: Terminal-Interface in 2 Schritten

Kennst du das? Du bist gerade voll im Flow in deinem Terminal, schreibst Code oder debuggst ein System, und dann musst du den Browser öffnen, um eine KI-Frage zu stellen. Das reißt dich komplett aus dem Kontext. Eine TUI (Terminal User Interface) ist hier die beste Lösung, weil sie genau dort lebt, wo du arbeitest.

Hier erfährst du, wie du die OpenClaw TUI nutzt, um effizient mit deinen Agents zu interagieren, ohne deine gewohnte Umgebung zu verlassen.

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>

Nutze --password, falls dein Gateway Passwort-Authentifizierung nutzt.

Was du siehst

• Header: Connection-URL, aktueller Agent, aktuelle Session.
• Chat-Log: User-Nachrichten, Assistant-Antworten, System-Benachrichtigungen, Tool-Cards.
• Status-Zeile: Verbindungs-/Laufstatus (connecting, running, streaming, idle, error).
• Footer: Verbindungsstatus + Agent + Session + Model + think/fast/verbose/reasoning + Token-Anzahl + deliver.
• Input: Texteditor mit Autocomplete.

Mentales Modell: Agents + Sessions

• Agents sind eindeutige Slugs (z. B. main, research). Das Gateway liefert die Liste dieser Agents.
• Sessions gehören immer zum aktuellen Agent.
• Session-Keys werden als agent:<agentId>:<sessionKey> gespeichert.
  • Wenn du /session main tippst, erweitert die TUI das automatisch zu agent:<currentAgent>:main.
  • Wenn du /session agent:other:main tippst, wechselst du explizit zu dieser Agent-Session.
• Session-Scope:
  • per-sender (Standard): Jeder Agent hat viele verschiedene Sessions.
  • global: Die TUI nutzt immer die global Session (der Picker könnte hier leer sein).
• Den aktuellen Agent und die Session hast du im Footer immer im Blick.

Senden + Delivery

• Nachrichten werden an das Gateway gesendet; die Weiterleitung (delivery) an Provider ist standardmäßig deaktiviert.
• So schaltest du die Delivery ein:
  • /deliver on
  • oder über das Settings-Panel
  • oder starte direkt mit openclaw tui --deliver

Picker + Overlays

• Model-Picker: Zeigt verfügbare Models an und setzt den Session-Override.
• Agent-Picker: Wähle einen anderen Agent aus.
• Session-Picker: Zeigt nur die Sessions für den aktuellen Agent an.
• Settings: Hier kannst du deliver, die Tool-Output-Erweiterung und die Sichtbarkeit von “Thinking” umschalten.

Tastenkombinationen

• Enter: Nachricht senden
• Esc: Aktiven Run abbrechen
• Ctrl+C: Input löschen (zweimal drücken zum Beenden)
• Ctrl+D: Beenden
• Ctrl+L: Model-Picker öffnen
• Ctrl+G: Agent-Picker öffnen
• Ctrl+P: Session-Picker öffnen
• Ctrl+O: Tool-Output-Erweiterung umschalten
• Ctrl+T: Thinking-Sichtbarkeit umschalten (lädt die History neu)

Slash-Befehle

Kernbefehle:

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

Session-Steuerung:

• /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>

Session-Lebenszyklus:

• /new oder /reset (Session zurücksetzen)
• /abort (Aktiven Run abbrechen)
• /settings
• /exit

Andere Gateway-Slash-Befehle (wie /context) werden direkt an das Gateway weitergeleitet und als System-Output angezeigt. Details findest du unter Slash commands.

Lokale Shell-Befehle

• Setze ein ! vor eine Zeile, um einen lokalen Shell-Befehl auf dem TUI-Host auszuführen.
• Die TUI fragt einmal pro Session nach, ob lokale Befehle erlaubt sind; lehnst du ab, bleibt ! für die Session deaktiviert.
• Befehle laufen in einer frischen, nicht-interaktiven Shell im TUI-Arbeitsverzeichnis (kein persistentes cd oder Environment).
• Lokale Shell-Befehle erhalten OPENCLAW_SHELL=tui-local in ihrer Umgebung.
• Ein einzelnes ! wird als normale Nachricht gesendet; führende Leerzeichen triggern keine lokale Ausführung.

Tool-Output

• Tool-Calls werden als Cards mit Argumenten und Ergebnissen dargestellt.
• Mit Ctrl+O wechselst du zwischen minimierter und maximierter Ansicht.
• Während Tools laufen, werden Updates live in dieselbe Card gestreamt.

Terminal-Farben

• Die TUI nutzt die Standard-Vordergrundfarbe deines Terminals für Assistant-Texte. So bleibt alles in dunklen und hellen Terminals gut lesbar.
• Falls du ein helles Terminal nutzt und die automatische Erkennung nicht passt, setze OPENCLAW_THEME=light vor dem Start von openclaw tui.
• Um die ursprüngliche dunkle Palette zu erzwingen, setze OPENCLAW_THEME=dark.

History + Streaming

• Beim Verbinden lädt die TUI die letzte History (Standard sind 200 Nachrichten).
• Streaming-Antworten werden direkt an Ort und Stelle aktualisiert, bis sie final sind.
• Die TUI verarbeitet auch Agent-Tool-Events für detaillierte Tool-Cards.

Verbindungsdetails

• Die TUI registriert sich beim Gateway mit mode: "tui".
• Reconnects werden als Systemnachricht angezeigt; Lücken in den Events werden im Log markiert.

Optionen

• --url <url>: Gateway WebSocket URL (Standard: Config oder ws://127.0.0.1:<port>)
• --token <token>: Gateway Token (falls nötig)
• --password <password>: Gateway Passwort (falls nötig)
• --session <key>: Session-Key (Standard: main, oder global bei globalem Scope)
• --deliver: Assistant-Antworten an den Provider liefern (Standard: aus)
• --thinking <level>: Thinking-Level für Sendevorgänge überschreiben
• --timeout-ms <ms>: Agent-Timeout in ms (Standard: agents.defaults.timeoutSeconds)

Hinweis: Wenn du --url setzt, nutzt die TUI keine Fallbacks für Config oder Credentials. Du musst --token oder --password explizit angeben.

Fehlerbehebung

Keine Ausgabe nach dem Senden einer Nachricht:

• Nutze /status in der TUI, um zu prüfen, ob das Gateway verbunden und bereit ist.
• Check die Gateway-Logs mit openclaw logs --follow.
• Prüfe, ob der Agent einsatzbereit ist: openclaw status und openclaw models status.
• Wenn du Antworten in einem Chat-Channel erwartest, aktiviere Delivery (/deliver on oder --deliver).
• --history-limit <n>: Anzahl der zu ladenden History-Einträge (Standard: 200)

Verbindungsprobleme beheben

• disconnected: Prüfe, ob das Gateway läuft und ob --url/--token/--password stimmen.
• Keine Agents im Picker: Check openclaw agents list und deine Routing-Konfiguration.
• Leerer Session-Picker: Eventuell bist du im globalen Scope oder hast noch keine Sessions erstellt.

Verwandte Themen

• Control UI — Web-basiertes Interface
• CLI Reference — Komplette CLI-Referenz

Du hast noch Fragen zum Setup? Frag unseren AI Setup Assistant.

Nächste Schritte

• Control UI
• CLI Reference