OpenClawDocs
Auf dieser Seite

Auf dieser Seite

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

TUI

openclaw tui

Öffnen Sie die mit dem Gateway verbundene Terminal-Benutzeroberfläche oder führen Sie sie im lokalen eingebetteten Modus aus.

Zugehörige Anleitung: TUI

Optionen

Flag Standardwert Beschreibung
--local false Verwendet statt eines Gateways die lokale eingebettete Agent-Runtime.
--url <url> gateway.remote.url aus der Konfiguration Gateway-WebSocket-URL.
--token <token> (keiner) Gateway-Token, falls erforderlich.
--password <pass> (keines) Gateway-Passwort, falls erforderlich.
--tls-fingerprint <sha256> gateway.remote.tlsFingerprint Erwarteter TLS-Zertifikat-Fingerabdruck für ein angeheftetes wss://-Gateway.
--session <key> main (oder global, wenn der Geltungsbereich global ist) Sitzungsschlüssel. Innerhalb eines Agent-Arbeitsbereichs wird automatisch dieser Agent ausgewählt, sofern kein Präfix angegeben ist.
--deliver false Stellt Antworten des Assistenten über konfigurierte Kanäle zu.
--thinking <level> (Modellstandard) Überschreibt die Denkstufe.
--message <text> (keine) Sendet nach dem Verbindungsaufbau eine erste Nachricht.
--timeout-ms <ms> agents.defaults.timeoutSeconds Agent-Zeitüberschreitung. Ungültige Werte protokollieren eine Warnung und werden ignoriert.
--history-limit <n> 200 Anzahl der beim Verbinden zu ladenden Verlaufseinträge.

Aliasse: openclaw chat und openclaw terminal rufen diesen Befehl mit impliziertem --local auf.

Hinweise

  • --local kann nicht mit --url, --token, --password oder --tls-fingerprint kombiniert werden.
  • tui löst konfigurierte Gateway-Authentifizierungs-SecretRefs für die Token-/Passwortauthentifizierung nach Möglichkeit auf (Provider env/file/exec).
  • Ohne explizite URL oder expliziten Port folgt tui dem aktiven lokalen Gateway-Port, der vom laufenden Gateway aufgezeichnet wurde. Explizite Angaben für --url, OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_PORT und die Remote-Gateway-Konfiguration haben weiterhin Vorrang.
  • Beim Start aus einem konfigurierten Agent-Arbeitsbereichsverzeichnis wählt die TUI automatisch diesen Agent als Standardwert für den Sitzungsschlüssel aus (sofern --session nicht ausdrücklich auf agent:<id>:... gesetzt ist).
  • Der lokale Modus verwendet die eingebettete Agent-Runtime direkt. Die meisten lokalen Tools funktionieren, aber Funktionen, die ausschließlich über das Gateway verfügbar sind, stehen nicht zur Verfügung.
  • Der lokale Modus fügt /auth [provider] zur Befehlsoberfläche der TUI hinzu.
  • Plugin-Genehmigungssperren gelten weiterhin im lokalen Modus: Tools, die eine Genehmigung erfordern, fragen im Terminal nach einer Entscheidung; nichts wird stillschweigend automatisch genehmigt.
  • Sitzungs-Ziele werden in der Fußzeile angezeigt und können mit /goal verwaltet werden.

Beispiele

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Vergleiche meine Konfiguration mit der Dokumentation und sage mir, was ich korrigieren muss"# bei Ausführung innerhalb eines Agent-Arbeitsbereichs wird dieser Agent automatisch abgeleitetopenclaw tui --session bugfix

Schleife zur Konfigurationsreparatur

Verwenden Sie den lokalen Modus, damit der eingebettete Agent die aktuelle Konfiguration prüft, sie mit der Dokumentation vergleicht und bei ihrer Reparatur im selben Terminal hilft.

Wenn openclaw config validate bereits fehlschlägt, führen Sie zuerst openclaw configure oder openclaw doctor --fix aus; openclaw chat umgeht die Schutzprüfung für ungültige Konfigurationen nicht.

bash
openclaw chat

Anschließend innerhalb der TUI:

text
!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.

Verwandte Themen

Was this useful?