TUI

Démarrage rapide

Mode Gateway

1. Démarrez le Gateway.

openclaw gateway

2. Ouvrez la TUI.

openclaw tui

3. Saisissez un message et appuyez sur Entrée.

Gateway distant :

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Utilisez --password si votre Gateway utilise une authentification par mot de passe.

Mode local

Exécutez la TUI sans Gateway :

openclaw chat# ouopenclaw tui --local

• openclaw chat et openclaw terminal sont des alias de openclaw tui --local.
• --local ne peut pas être combiné avec --url, --token ou --password.
• Le mode local utilise directement l'environnement d'exécution intégré de l'agent. La plupart des outils locaux fonctionnent, mais les fonctionnalités réservées au Gateway sont indisponibles.
• La commande openclaw seule (sans sous-commande) choisit automatiquement une cible : une installation non configurée lance l'intégration de l'inférence ; une configuration non valide ouvre les instructions classiques de Doctor ; un Gateway configuré et accessible ouvre cette interface TUI en mode Gateway ; sinon, un modèle local configuré l'ouvre en mode local.

Éléments affichés

• En-tête : URL de connexion, agent actuel, session actuelle.
• Journal de discussion : messages de l'utilisateur, réponses de l'assistant, notifications système, cartes d'outils.
• Ligne d'état : état de la connexion ou de l'exécution (connexion, exécution, diffusion en continu, inactivité, erreur).
• Pied de page : agent + session + modèle + état de l'objectif + réflexion/rapide/détaillé/traçage/raisonnement + nombre de jetons + livraison. Lorsque tui.footer.showRemoteHost est activé, les connexions à un Gateway distant affichent également l'hôte de connexion.
• Saisie : éditeur de texte avec saisie semi-automatique.

Modèle conceptuel : agents + sessions

• Les agents sont des identifiants uniques (par exemple main, research). Le Gateway en expose la liste.

• Les sessions appartiennent à l'agent actuel.

• Les clés de session sont stockées sous la forme agent:<agentId>:<sessionKey>.

  • Si vous saisissez /session main, la TUI la développe en agent:<currentAgent>:main.
  • Si vous saisissez /session agent:other:main, vous basculez explicitement vers cette session d'agent.

• Portée des sessions :

  • per-sender (par défaut) : chaque agent possède plusieurs sessions.
  • global : la TUI utilise toujours la session global (le sélecteur peut être vide).

• L'agent et la session actuels sont toujours visibles dans le pied de page.

• Pour afficher l'hôte du Gateway pour les connexions non locales reposant sur une URL, activez cette option avec :

  openclaw config set tui.footer.showRemoteHost true

  La valeur par défaut est false. Les connexions local loopback et locales intégrées n'affichent jamais de libellé d'hôte.

• Si la session comporte un objectif, le pied de page affiche son état compact : Objectif en cours, Objectif en pause (/goal resume), Objectif bloqué (/goal resume) ou Objectif atteint.

• Lorsqu'elle est lancée sans --session, la TUI en mode Gateway reprend la dernière session sélectionnée pour le même Gateway, le même agent et la même portée de session, si cette session existe encore. L'utilisation de --session, /session, /new ou /reset reste explicite.

Envoi + livraison

• Les messages sont toujours envoyés au Gateway (ou à l'environnement d'exécution intégré en mode local) ; la livraison de la réponse de l'assistant à un fournisseur de discussion constitue une étape distincte, désactivée par défaut.
• La TUI est une surface source interne, comme WebChat, et non un canal sortant générique. Les environnements qui exigent tools.message pour les réponses visibles peuvent satisfaire le tour actif de la TUI avec un message.send sans cible ; la livraison explicite par le fournisseur continue d'utiliser les canaux normalement configurés et ne revient jamais à lastChannel.
• La livraison est définie au lancement pour toute la session TUI : démarrez avec openclaw tui --deliver pour l'activer. Il n'existe aucune commande oblique /deliver ni aucun bouton dans les paramètres permettant de la modifier en cours de session ; redémarrez la TUI pour la changer.

Sélecteurs + superpositions

• Sélecteur de modèle : répertorie les modèles disponibles et définit le remplacement pour la session.
• Sélecteur d'agent : permet de choisir un autre agent.
• Sélecteur de session : affiche jusqu'à 50 sessions de l'agent actuel mises à jour au cours des 7 derniers jours. Utilisez /session <key> pour accéder à une ancienne session connue.
• Paramètres (/settings) : permettent d'activer ou de désactiver le développement de la sortie des outils et la visibilité de la réflexion. Ce panneau ne contrôle pas la livraison.

Raccourcis clavier

• Entrée : envoyer le message
• Échap : interrompre l'exécution active
• Ctrl+C : effacer la saisie (appuyez deux fois pour quitter)
• Ctrl+D : quitter
• Ctrl+L : sélecteur de modèle
• Ctrl+G : sélecteur d'agent
• Ctrl+P : sélecteur de session
• Ctrl+O : développer ou réduire la sortie des outils
• Ctrl+T : afficher ou masquer la réflexion (recharge l'historique)

Commandes obliques

Commandes principales :

• /help
• /status (transmise au Gateway ; affiche un résumé de la session et du modèle)
• /gateway-status (alias /gwstatus ; affiche directement l'état de la connexion au Gateway)
• /agent <id> (ou /agents)
• /session <key> (ou /sessions)
• /model <provider/model> (ou /models)

Contrôles de session :

• /think <off|minimal|low|medium|high> (les niveaux supérieurs peuvent ajouter des niveaux comme xhigh/max selon le modèle)
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default supprime le remplacement de la session)
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias : /elev)
• /activation <mention|always>

Cycle de vie de la session :

• /new (crée une nouvelle session isolée sous une nouvelle clé ; n'affecte pas les autres clients TUI utilisant l'ancienne session)
• /reset (réinitialise sur place la clé de la session actuelle)
• /abort (interrompt l'exécution active)
• /settings
• /exit (ou /quit)

Mode local uniquement :

• /auth [provider] ouvre le processus d'authentification ou de connexion du fournisseur dans la TUI.

Crestodian :

• /crestodian [request] permet de quitter la TUI normale de l'agent pour revenir à la discussion de configuration et de réparation de Crestodian, en transmettant éventuellement une requête.

Les autres commandes obliques du Gateway (par exemple /context) sont transmises au Gateway et affichées comme sortie système. Consultez Commandes obliques.

Commandes shell locales

• Préfixez une ligne par ! pour exécuter une commande shell locale sur l'hôte de la TUI.
• La TUI demande une fois par session l'autorisation d'exécuter des commandes locales ; en cas de refus, ! reste désactivé pour la session.
• Les commandes s'exécutent dans un nouveau shell non interactif, depuis le répertoire de travail de la TUI (sans persistance de cd ni des variables d'environnement).
• Les commandes shell locales reçoivent OPENCLAW_SHELL=tui-local dans leur environnement.
• Un ! seul est envoyé comme un message normal ; les espaces initiaux ne déclenchent pas l'exécution locale.

Assistant de configuration et de réparation Crestodian

Crestodian est l'assistant de configuration et de réparation de niveau zéro, exposé sous la forme openclaw crestodian après la réussite d'une vérification d'inférence en direct par le modèle par défaut configuré. Si l'inférence est indisponible, un appel interactif revient à l'intégration de l'inférence et l'automatisation échoue en fournissant des instructions de réparation. Il s'exécute dans la même interface TUI locale que openclaw tui --local, avec un agent d'IA limité aux opérations typées de Crestodian et soumises à approbation :

openclaw crestodian                       # démarrer en mode interactifopenclaw crestodian -m "status"           # exécuter une requête et quitteropenclaw crestodian -m "set default model openai/gpt-5.2" --yes   # appliquer une écriture de configuration

• Les écritures persistantes dans la configuration nécessitent une approbation : confirmez-les de manière interactive ou transmettez --yes.
• --json affiche la vue d'ensemble du démarrage au format JSON au lieu de lancer la discussion.
• Depuis Crestodian, une requête open-tui (par exemple, pour demander à parler à un agent normal) ferme Crestodian et ouvre la TUI normale de l'agent ; utilisez-y /crestodian pour revenir.

Utilisez le mode local lorsque la configuration actuelle est déjà valide et que vous souhaitez que l'agent intégré l'inspecte sur la même machine, la compare à la documentation et vous aide à corriger les divergences sans dépendre d'un Gateway en cours d'exécution.

Si openclaw config validate échoue déjà, commencez par openclaw configure ou openclaw doctor --fix ; openclaw chat nécessite toujours une configuration chargeable pour démarrer.

Boucle type :

1. Démarrez le mode local :

openclaw chat

2. Demandez à l'agent ce que vous souhaitez vérifier, par exemple :

Compare ma configuration d'authentification du Gateway à la documentation et propose la correction la plus limitée.

3. Utilisez les commandes shell locales pour obtenir des preuves exactes et effectuer la validation :

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

4. Appliquez des modifications ciblées avec openclaw config set ou openclaw configure, puis réexécutez !openclaw config validate.
5. Si Doctor recommande une migration ou une réparation automatique, examinez-la et exécutez !openclaw doctor --fix.

Conseils :

• Préférez openclaw config set ou openclaw configure à la modification manuelle de openclaw.json.
• openclaw docs "<query>" effectue une recherche dans l'index de la documentation en direct depuis la même machine.
• openclaw config validate --json est utile pour obtenir des erreurs structurées de schéma, de SecretRef et de possibilité de résolution.

Sortie des outils

• Les appels d'outils s'affichent sous forme de cartes avec leurs arguments et leurs résultats.
• Ctrl+O bascule entre les vues réduite et développée.
• Pendant l'exécution des outils, les mises à jour partielles sont diffusées dans la même carte.

Couleurs du terminal

• La TUI conserve le texte principal de l'assistant dans la couleur de premier plan par défaut de votre terminal afin qu'il reste lisible sur les terminaux clairs comme sombres.
• Si votre terminal utilise un arrière-plan clair et que la détection automatique est incorrecte, définissez OPENCLAW_THEME=light avant de lancer openclaw tui.
• Pour imposer à la place la palette sombre d'origine, définissez OPENCLAW_THEME=dark.

Historique + diffusion en continu

• Lors de la connexion, la TUI charge l'historique le plus récent (200 messages par défaut).
• Les réponses diffusées en continu sont mises à jour sur place jusqu'à leur finalisation.
• La TUI écoute également les événements des outils de l'agent afin d'afficher des cartes d'outils plus détaillées.

Détails de la connexion

• La TUI se connecte avec l'identifiant client openclaw-tui dans le mode client général ui (le même mode que Control UI et WebChat utilisent pour la politique du Gateway).
• Les reconnexions affichent un message système ; les interruptions d'événements sont signalées dans le journal.

Options

• --local : exécuter avec l'environnement d'exécution local intégré de l'agent
• --url <url> : URL WebSocket du Gateway (valeur par défaut : gateway.remote.url dans la configuration, ou ws://127.0.0.1:<port> sur local loopback)
• --token <token> : jeton du Gateway (si nécessaire)
• --password <password> : mot de passe du Gateway (si nécessaire)
• --tls-fingerprint <sha256> : empreinte attendue du certificat TLS pour un Gateway wss:// épinglé
• --session <key> : clé de session (valeur par défaut : main, ou global lorsque la portée est globale)
• --deliver : livrer les réponses de l'assistant au fournisseur (désactivé par défaut)
• --thinking <level> : remplacer le niveau de réflexion pour les envois
• --message <text> : envoyer un message initial après la connexion
• --timeout-ms <ms> : délai d'expiration de l'agent en ms (valeur par défaut : agents.defaults.timeoutSeconds)
• --history-limit <n> : nombre d'entrées d'historique à charger (valeur par défaut : 200)

Dépannage

Aucune sortie après l'envoi d'un message :

• Exécutez /status dans la TUI pour confirmer que le Gateway est connecté et inactif ou occupé.
• Consultez les journaux du Gateway : openclaw logs --follow.
• Vérifiez que l'agent peut s'exécuter : openclaw status et openclaw models status.
• Si vous attendez des messages dans un canal de discussion, vérifiez que la TUI a été démarrée avec --deliver (cette option ne peut pas être activée ultérieurement sans redémarrage).

Dépannage de la connexion

• disconnected : vérifiez que le Gateway est en cours d'exécution et que vos --url/--token/--password sont corrects.
• Aucun agent dans le sélecteur : vérifiez openclaw agents list et votre configuration de routage.
• Sélecteur de session vide : vous êtes peut-être dans la portée globale ou ne disposez encore d'aucune session.

Voir aussi

• Control UI — interface de contrôle web
• Configuration — inspecter, valider et modifier openclaw.json
• Doctor — vérifications guidées de réparation et de migration
• Référence de la CLI — référence complète des commandes de la CLI