CLI commands

TUI

`openclaw tui`

Ouvrez l’interface utilisateur de terminal connectée au Gateway, ou exécutez-la en mode local intégré.

Associé :

Guide TUI : TUI

Options

Drapeau	Par défaut	Description
`--local`	`false`	Exécuter avec le runtime d’agent local intégré au lieu d’un Gateway.
`--url <url>`	`gateway.remote.url` depuis la config	URL WebSocket du Gateway.
`--token <token>`	(aucun)	Jeton du Gateway, si requis.
`--password <pass>`	(aucun)	Mot de passe du Gateway, si requis.
`--session <key>`	`main` (ou `global` quand la portée est globale)	Clé de session. Dans un espace de travail d’agent, sélectionne automatiquement cet agent sauf si préfixée.
`--deliver`	`false`	Distribuer les réponses de l’assistant via les canaux configurés.
`--thinking <level>`	(par défaut du modèle)	Remplacement du niveau de réflexion.
`--message <text>`	(aucun)	Envoyer un message initial après la connexion.
`--timeout-ms <ms>`	`agents.defaults.timeoutSeconds`	Délai d’expiration de l’agent. Les valeurs invalides consignent un avertissement et sont ignorées.
`--history-limit <n>`	`200`	Entrées d’historique à charger lors de l’attachement.

Alias : openclaw chat et openclaw terminal invoquent la même commande avec --local implicite.

Remarques :

chat et terminal sont des alias de openclaw tui --local.
--local ne peut pas être combiné avec --url, --token ou --password.
tui résout les SecretRefs d’authentification du gateway configurés pour l’authentification par jeton/mot de passe lorsque c’est possible (fournisseurs env/file/exec).
Lorsqu’il est lancé depuis un répertoire d’espace de travail d’agent configuré, TUI sélectionne automatiquement cet agent comme valeur par défaut de la clé de session (sauf si --session est explicitement agent:<id>:...).
Le mode local utilise directement le runtime d’agent intégré. La plupart des outils locaux fonctionnent, mais les fonctionnalités propres au Gateway ne sont pas disponibles.
Le mode local ajoute /auth [provider] dans la surface de commande TUI.
Les barrières d’approbation des Plugins s’appliquent toujours en mode local. Les outils qui exigent une approbation demandent une décision dans le terminal ; rien n’est approuvé automatiquement en silence parce que le Gateway n’intervient pas.

Exemples

bash

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 bugfix

Boucle de réparation de la config

Utilisez le mode local lorsque la config actuelle est déjà valide et que vous voulez que l’agent intégré l’inspecte, la compare à la documentation et aide à la réparer depuis le même terminal :

Si openclaw config validate échoue déjà, utilisez d’abord openclaw configure ou openclaw doctor --fix. openclaw chat ne contourne pas le garde-fou de config invalide.

bash

openclaw chat

Puis dans TUI :

text

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

Appliquez des correctifs ciblés avec openclaw config set ou openclaw configure, puis relancez openclaw config validate. Consultez TUI et Config.

Associé

Was this useful?