TUI

`openclaw tui`

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

Connexes :

Guide TUI : TUI

Options

Paramètre	Par défaut	Description
`--local`	`false`	Exécuter sur le runtime d’agent intégré local au lieu d’un Gateway.
`--url <url>`	`gateway.remote.url` depuis la config	URL WebSocket Gateway.
`--token <token>`	(aucun)	Jeton Gateway si requis.
`--password <pass>`	(aucun)	Mot de passe Gateway si requis.
`--session <key>`	`main` (ou `global` lorsque la portée est globale)	Clé de session. Dans un espace de travail agent, il sélectionne automatiquement cet agent sauf s’il est préfixé.
`--deliver`	`false`	Envoyer les réponses de l’assistant via les canaux configurés.
`--thinking <level>`	(par défaut du model)	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’attente de l’agent. Les valeurs invalides enregistrent un avertissement et sont ignorées.
`--history-limit <n>`	`200`	Entrées de l’historique à charger lors de la connexion.

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

Notes :

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

Exemples

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

Boucle de réparation de la configuration

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

Si openclaw config validate échoue déjà, utilisez openclaw configure ou openclaw doctor --fix en premier. openclaw chat ne contourne pas la garde de configuration invalide.

openclaw chat

Puis à l’intérieur du TUI :

!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 validateTUI. Voir TUI et Config.