CLI commands
TUI
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
| Flag | Standard | Beschreibung |
|---|---|---|
--local |
false |
Gegen die lokale eingebettete Agent-Laufzeitumgebung statt gegen ein Gateway ausführen. |
--url <url> |
gateway.remote.url aus der Konfiguration |
Gateway-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. |
--deliver |
false |
Assistant-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.timeoutSeconds |
Agent-Timeout. Ungültige Werte protokollieren eine Warnung und werden ignoriert. |
--history-limit <n> |
200 |
Verlaufseinträge, die beim Anhängen geladen werden. |
Aliase: openclaw chat und openclaw terminal rufen denselben Befehl mit impliziertem --local auf.
Hinweise:
chatundterminalsind Aliase füropenclaw tui --local.--localkann nicht mit--url,--tokenoder--passwordkombiniert werden.tuilö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,
--sessionist explizitagent:<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 trueaus. 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
/goalverwaltet werden.
Beispiele
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfixKonfigurations-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 chatDann innerhalb der TUI:
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctorWenden 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.
