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
--localkann nicht mit--url,--token,--passwordoder--tls-fingerprintkombiniert werden.tuilöst konfigurierte Gateway-Authentifizierungs-SecretRefs für die Token-/Passwortauthentifizierung nach Möglichkeit auf (Providerenv/file/exec).- Ohne explizite URL oder expliziten Port folgt
tuidem aktiven lokalen Gateway-Port, der vom laufenden Gateway aufgezeichnet wurde. Explizite Angaben für--url,OPENCLAW_GATEWAY_URL,OPENCLAW_GATEWAY_PORTund 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
--sessionnicht ausdrücklich aufagent:<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
/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 "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 bugfixSchleife 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.
openclaw chatAnschließend 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.
