TUI

TUI (Terminal UI)

Quick start

1. Démarrez le Gateway.

openclaw gateway

2. Ouvrez le TUI.

openclaw tui

3. Tapez 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.

Ce que vous voyez

• En-tête : URL de connexion, agent actuel, session actuelle.
• Journal de chat : messages de l’utilisateur, réponses de l’assistant, avis système, cartes d’outils.
• Ligne d’état : état de connexion/exécution (connexion, exécution, streaming, inactif, erreur).
• Pied de page : état de connexion + agent + session + model + réflexion/verbeux/raisonnement + nombre de jetons + livraison.
• Saisie : éditeur de texte avec autocomplétion.

Modèle mental : agents + sessions

• Les agents sont des identifiants uniques (ex. main, research). Le Gateway expose la liste.
• Les sessions appartiennent à l’agent actuel.
• Les clés de session sont stockées sous forme de agent:<agentId>:<sessionKey>.
  • Si vous tapez /session main, le TUI l’étend à agent:<currentAgent>:main.
  • Si vous tapez /session agent:other:main, vous basculez explicitement vers cette session d’agent.
• Portée de la session :
  • per-sender (par défaut) : chaque agent possède plusieurs sessions.
  • global : le TUI utilise toujours la session global (le sélecteur peut être vide).
• L’agent actuel et la session sont toujours visibles dans le pied de page.

Envoi + livraison

• Les messages sont envoyés au Gateway ; la livraison aux fournisseurs est désactivée par défaut.
• Activer la livraison :
  • /deliver on
  • ou le panneau Paramètres
  • ou démarrer avec openclaw tui --deliver

Sélecteurs + superpositions

• Sélecteur de model : liste les models disponibles et définit la substitution de session.
• Sélecteur d’agent : choisir un autre agent.
• Sélecteur de session : affiche uniquement les sessions de l’agent actuel.
• Paramètres : activer/désactiver la livraison, l’extension de la sortie des outils et la visibilité de la réflexion.

Raccourcis clavier

• Entrée : envoyer le message
• Échap : annuler l’exécution active
• Ctrl+C : effacer la saisie (appuyez deux fois pour quitter)
• Ctrl+D : quitter
• Ctrl+L : sélecteur de model
• Ctrl+G : sélecteur d’agent
• Ctrl+P : sélecteur de session
• Ctrl+O : basculer l’expansion de la sortie tool
• Ctrl+T : basculer la visibilité de la réflexion (recharge l’historique)

Commandes slash

Cœur :

• /help
• /status
• /agent <id> (ou /agents)
• /session <key> (ou /sessions)
• /model <provider/model> (ou /models)

Contrôles de session :

• /think <off|minimal|low|medium|high>
• /verbose <on|full|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (alias : /elev)
• /activation <mention|always>
• /deliver <on|off>

Cycle de vie de la session :

• /new ou /reset (réinitialiser la session)
• /abort (abandonner l’exécution active)
• /settings
• /exit

Les autres commandes slash du Gateway (par exemple, /context) sont transmises au Gateway et affichées sous forme de sortie système. Voir Slash commands.

Commandes du shell local

• Préfixez une ligne avec ! pour exécuter une commande de shell local sur l’hôte du TUI.
• Le TUI demande une fois par session l’autorisation d’exécution locale ; le refus désactive ! pour la session.
• Les commandes s’exécutent dans un shell frais et non interactif dans le répertoire de travail du TUI (aucun cd/env persistant).
• Un ! seul est envoyé en tant que message normal ; les espaces de début ne déclenchent pas l’exécution locale.

Sortie tool

• Les appels tool s’affichent sous forme de cartes avec les arguments + résultats.
• Ctrl+O permet de basculer entre les vues réduites et développées.
• Pendant que les outils s’exécutent, les mises à jour partielles sont diffusées dans la même carte.

Historique + streaming

• À la connexion, le TUI charge le dernier historique (200 messages par défaut).
• Les réponses en streaming sont mises à jour en place jusqu’à leur finalisation.
• Le TUI écoute également les événements des outils de l’agent pour des cartes d’outil plus riches.

Détails de la connexion

• Le TUI s’enregistre auprès du Gateway en tant que mode: "tui".
• Les reconnexions affichent un message système ; les écarts d’événements apparaissent dans le journal.

Options

• --url <url> : URL WebSocket du Gateway (par défaut la configuration ou ws://127.0.0.1:<port>)
• --token <token> : jeton du Gateway (si requis)
• --password <password> : mot de passe du Gateway (si requis)
• --session <key> : clé de session (par défaut main, ou global lorsque la portée est globale)
• --deliver : Livrer les réponses de l’assistant au provider (désactivé par défaut)
• --thinking <level> : Remplacer le niveau de réflexion pour les envois
• --timeout-ms <ms> : Délai d’attente de l’agent en ms (par défaut agents.defaults.timeoutSeconds)

Remarque : lorsque vous définissez --url, le TUI ne revient pas aux identifiants de configuration ou d’environnement. Passez --token ou --password explicitement. L’absence d’identifiants explicites constitue une erreur.

Dépannage

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

• Exécutez /status dans le TUI pour confirmer que le Gateway est connecté et inactif/occupé.
• Vérifiez les journaux du Gateway : openclaw logs --follow.
• Confirmez que l’agent peut s’exécuter : openclaw status et openclaw models status.
• Si vous attendez des messages dans un channel de discussion, activez la livraison (/deliver on ou --deliver).
• --history-limit <n> : entrées d’historique à charger (par défaut 200)

Dépannage

• disconnected : assurez-vous que le Gateway fonctionne 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 pourriez être dans la portée globale ou ne pas avoir encore de sessions.