TUI (Terminal UI)

Schnellstart

  1. Starte das Gateway.
openclaw gateway
  1. Öffne die TUI.
openclaw tui
  1. Schreib eine Nachricht und drück Enter.

Remote Gateway:

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

Nutze --password, wenn dein Gateway Passwort-Authentifizierung verwendet.

Was du siehst

  • Header: Verbindungs-URL, aktueller Agent, aktuelle Session.
  • Chat-Log: Benutzernachrichten, Antworten des Assistenten, Systemmeldungen, Tool-Karten.
  • Statuszeile: Verbindungs-/Ausführungsstatus (connecting, running, streaming, idle, error).
  • Footer: Verbindungsstatus + Agent + Session + Modell + think/verbose/reasoning + Token-Zähler + deliver.
  • Eingabe: Texteditor mit Autocomplete.

Mentales Modell: Agents + Sessions

  • Agents sind eindeutige Slugs (z. B. main, research). Das Gateway stellt die Liste bereit.
  • Sessions gehören zum aktuellen Agent.
  • Session-Keys werden als agent:<agentId>:<sessionKey> gespeichert.
    • Wenn du /session main eingibst, erweitert die TUI es zu agent:<currentAgent>:main.
    • Wenn du /session agent:other:main eingibst, wechselst du explizit zu dieser Agent-Session.
  • Session-Scope:
    • per-sender (Standard): Jeder Agent hat viele Sessions.
    • global: Die TUI nutzt immer die global-Session (der Picker kann leer sein).
  • Der aktuelle Agent + Session sind immer im Footer sichtbar.

Senden + Delivery

  • Nachrichten werden an das Gateway gesendet; Delivery an Provider ist standardmäßig aus.
  • Delivery aktivieren:
    • /deliver on
    • oder über das Settings-Panel
    • oder beim Start mit openclaw tui --deliver

Picker + Overlays

  • Model-Picker: Zeigt verfügbare Modelle und setzt das Session-Override.
  • Agent-Picker: Wähle einen anderen Agent.
  • Session-Picker: Zeigt nur Sessions für den aktuellen Agent.
  • Settings: Schalte Delivery, Tool-Output-Expansion und Thinking-Sichtbarkeit um.

Tastenkombinationen

  • Enter: Nachricht senden
  • Esc: Aktive Ausführung abbrechen
  • Ctrl+C: Eingabe löschen (zweimal drücken zum Beenden)
  • Ctrl+D: Beenden
  • Ctrl+L: Model-Picker
  • Ctrl+G: Agent-Picker
  • Ctrl+P: Session-Picker
  • Ctrl+O: Tool-Output-Expansion umschalten
  • Ctrl+T: Thinking-Sichtbarkeit umschalten (lädt History neu)

Slash-Befehle

Kern:

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

Session-Steuerung:

  • /think <off|minimal|low|medium|high>
  • /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 (Aktive Ausführung abbrechen)
  • /settings
  • /exit

Andere Gateway-Slash-Befehle (z. B. /context) werden an das Gateway weitergeleitet und als System-Output angezeigt. Siehe Slash-Befehle.

Lokale Shell-Befehle

  • Stell einer Zeile ein ! voran, um einen lokalen Shell-Befehl auf dem TUI-Host auszuführen.
  • Die TUI fragt einmal pro Session, ob lokale Ausführung erlaubt ist; bei Ablehnung bleibt ! für die Session deaktiviert.
  • Befehle laufen in einer frischen, nicht-interaktiven Shell im TUI-Arbeitsverzeichnis (kein persistentes cd/env).
  • Ein einzelnes ! wird als normale Nachricht gesendet; führende Leerzeichen lösen keine lokale Ausführung aus.

Tool-Output

  • Tool-Aufrufe werden als Karten mit Args + Ergebnissen angezeigt.
  • Ctrl+O schaltet zwischen eingeklappter/ausgeklappter Ansicht um.
  • Während Tools laufen, werden partielle Updates in dieselbe Karte gestreamt.

History + Streaming

  • Beim Verbinden lädt die TUI die neueste History (Standard: 200 Nachrichten).
  • Streaming-Antworten werden live 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".
  • Reconnects zeigen eine Systemmeldung; Event-Lücken werden im Log angezeigt.

Optionen

  • --url <url>: Gateway-WebSocket-URL (Standard: Config oder ws://127.0.0.1:<port>)
  • --token <token>: Gateway-Token (falls erforderlich)
  • --password <password>: Gateway-Passwort (falls erforderlich)
  • --session <key>: Session-Key (Standard: main, oder global bei globalem Scope)
  • --deliver: Antworten des Assistenten an den Provider ausliefern (Standard: aus)
  • --thinking <level>: Thinking-Level für Sends überschreiben
  • --timeout-ms <ms>: Agent-Timeout in ms (Standard: agents.defaults.timeoutSeconds)
  • --history-limit <n>: Anzahl zu ladender History-Einträge (Standard: 200)

Troubleshooting

Keine Ausgabe nach dem Senden einer Nachricht:

  • Führe /status in der TUI aus, um zu prüfen, ob das Gateway verbunden und idle/busy ist.
  • Schau dir die Gateway-Logs an: openclaw logs --follow.
  • Bestätige, dass der Agent laufen kann: openclaw status und openclaw models status.
  • Wenn du Nachrichten in einem Chat-Channel erwartest, aktiviere Delivery (/deliver on oder --deliver).

Weitere Probleme:

  • disconnected: Stelle sicher, dass das Gateway läuft und deine --url/--token/--password korrekt sind.
  • Keine Agents im Picker: Prüfe openclaw agents list und deine Routing-Config.
  • Leerer Session-Picker: Du bist möglicherweise im globalen Scope oder hast noch keine Sessions.