CLI commands
TUI
openclaw tui
Ouvrez l’interface terminal connectée au Gateway, ou exécutez-la en mode local intégré.
Associé :
- Guide TUI : TUI
Options
| Indicateur | Par défaut | Description |
|---|---|---|
--local |
false |
S’exécuter avec l’environnement d’exécution d’agent local intégré plutôt qu’avec un Gateway. |
--url <url> |
gateway.remote.url de la configuration |
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 si la portée globale) |
Clé de session. Dans un espace de travail d’agent, sélectionne automatiquement cet agent sauf si un préfixe est utilisé. |
--deliver |
false |
Distribuer les réponses de l’assistant via les canaux configurés. |
--thinking <level> |
(valeur 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 non valides journalisent 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 :
chatetterminalsont des alias deopenclaw tui --local.--localne peut pas être combiné avec--url,--tokenou--password.tuirésout quand c’est possible les SecretRefs d’authentification du Gateway configurés pour l’authentification par jeton/mot de passe (fournisseursenv/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
--sessionest explicitementagent:<id>:...). - Pour afficher le nom d’hôte du Gateway dans le pied de page pour les connexions non locales adossées à une URL, exécutez
openclaw config set tui.footer.showRemoteHost true. Le libellé d’hôte est désactivé par défaut et n’apparaît jamais pour les connexions de loopback ou locales intégrées. - Le mode local utilise directement l’environnement d’exécution 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 continuent de s’appliquer 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’est pas impliqué.
- Les objectifs de session apparaissent dans le pied de page et peuvent être gérés avec
/goal.
Exemples
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 bugfixBoucle de réparation de configuration
Utilisez le mode local lorsque la configuration 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 la protection contre les configurations non valides.
openclaw chatPuis dans le TUI :
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctorAppliquez des corrections ciblées avec openclaw config set ou openclaw configure, puis réexécutez openclaw config validate. Consultez TUI et Configuration.
