Zum Hauptinhalt springen

​
openclaw tui

Öffnen Sie die mit dem Gateway verbundene Terminal-UI, oder führen Sie sie im lokalen eingebetteten Modus aus. Verwandt:
  • TUI-Leitfaden: TUI

​
Optionen

FlagStandardBeschreibung
--localfalseGegen die lokale eingebettete Agent-Laufzeitumgebung statt gegen ein Gateway ausführen.
--url <url>gateway.remote.url aus der KonfigurationGateway-WebSocket-URL.
--token <token>(keine)Gateway-Token, falls erforderlich.
--password <pass>(keine)Gateway-Passwort, falls erforderlich.
--session <key>main (oder global, wenn der Geltungsbereich global ist)Sitzungsschlüssel. Innerhalb eines Agent-Arbeitsbereichs wird dieser Agent automatisch ausgewählt, sofern kein Präfix angegeben ist.
--deliverfalseAssistant-Antworten über konfigurierte Kanäle zustellen.
--thinking <level>(Modellstandard)Überschreibung des Denklevels.
--message <text>(keine)Nach dem Verbinden eine Anfangsnachricht senden.
--timeout-ms <ms>agents.defaults.timeoutSecondsAgent-Timeout. Ungültige Werte protokollieren eine Warnung und werden ignoriert.
--history-limit <n>200Verlaufseinträge, die beim Anhängen geladen werden.
Aliase: openclaw chat und openclaw terminal rufen denselben Befehl mit impliziertem --local auf. Hinweise:
  • chat und terminal sind Aliase für openclaw tui --local.
  • --local kann nicht mit --url, --token oder --password kombiniert werden.
  • tui löst konfigurierte Gateway-Auth-SecretRefs für Token-/Passwort-Auth nach Möglichkeit auf (env/file/exec-Provider).
  • Beim Start aus einem konfigurierten Agent-Arbeitsbereichsverzeichnis wählt TUI diesen Agent automatisch als Standard für den Sitzungsschlüssel aus (es sei denn, --session ist explizit agent:<id>:...).
  • Um den Gateway-Hostnamen in der Fußzeile für nicht lokale URL-gestützte Verbindungen anzuzeigen, führen Sie openclaw config set tui.footer.showRemoteHost true aus. Die Host-Beschriftung ist standardmäßig deaktiviert und erscheint nie für loopback- oder eingebettete lokale Verbindungen.
  • Der lokale Modus verwendet die eingebettete Agent-Laufzeitumgebung direkt. Die meisten lokalen Tools funktionieren, aber reine Gateway-Funktionen sind nicht verfügbar.
  • Der lokale Modus fügt /auth [provider] innerhalb der TUI-Befehlsoberfläche hinzu.
  • Plugin-Freigabesperren gelten auch im lokalen Modus. Tools, die eine Freigabe erfordern, fragen im Terminal nach einer Entscheidung; nichts wird stillschweigend automatisch freigegeben, nur weil das Gateway nicht beteiligt ist.
  • Sitzungs-Ziele erscheinen in der Fußzeile und können mit /goal verwaltet werden.

​
Beispiele

openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix

​
Konfigurations-Reparaturschleife

Verwenden Sie den lokalen Modus, wenn die aktuelle Konfiguration bereits validiert wird und Sie möchten, dass der eingebettete Agent sie prüft, mit der Dokumentation vergleicht und aus demselben Terminal heraus bei der Reparatur hilft: Wenn openclaw config validate bereits fehlschlägt, verwenden Sie zuerst openclaw configure oder openclaw doctor --fix. openclaw chat umgeht die Schutzprüfung für ungültige Konfigurationen nicht. 
openclaw chat
Dann innerhalb der TUI: 
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
Wenden Sie gezielte Korrekturen mit openclaw config set oder openclaw configure an, und führen Sie anschließend openclaw config validate erneut aus. Siehe TUI und Konfiguration.

​
Verwandt