TUI (Interfaz de terminal)

Inicio rápido

Inicia el Gateway.

openclaw gateway

Abre la TUI.

openclaw tui

Escribe un mensaje y presiona Enter.

Gateway remoto:

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

Usa --password si tu Gateway usa autenticación por contraseña.

Qué verás

Encabezado: URL de conexión, agente actual, sesión actual.
Log de chat: mensajes del usuario, respuestas del asistente, avisos del sistema, tarjetas de herramientas.
Línea de estado: estado de conexión/ejecución (conectando, ejecutando, transmitiendo, inactivo, error).
Pie de página: estado de conexión + agente + sesión + modelo + think/fast/verbose/reasoning + conteo de tokens + deliver.
Entrada: editor de texto con autocompletado.

Modelo mental: agentes + sesiones

Los agentes son slugs únicos (p. ej. main, research). El Gateway expone la lista.
Las sesiones pertenecen al agente actual.
Las claves de sesión se almacenan como agent:<agentId>:<sessionKey>.
- Si escribes /session main, la TUI lo expande a agent:<currentAgent>:main.
- Si escribes /session agent:other:main, cambias a esa sesión de agente explícitamente.
Alcance de sesión:
- per-sender (por defecto): cada agente tiene muchas sesiones.
- global: la TUI siempre usa la sesión global (el selector puede estar vacío).
El agente actual + sesión siempre son visibles en el pie de página.

Envío y entrega

Los mensajes se envían al Gateway; la entrega a proveedores está desactivada por defecto.
Activar la entrega:
- /deliver on
- o el panel de Ajustes
- o iniciar con openclaw tui --deliver

Selectores y overlays

Selector de modelo: lista modelos disponibles y configura la sobreescritura de sesión.
Selector de agente: elige un agente diferente.
Selector de sesión: muestra solo sesiones del agente actual.
Ajustes: toggle de deliver, expansión de salida de herramientas y visibilidad del thinking.

Atajos de teclado

Enter: enviar mensaje
Esc: abortar ejecución activa
Ctrl+C: limpiar entrada (presiona dos veces para salir)
Ctrl+D: salir
Ctrl+L: selector de modelo
Ctrl+G: selector de agente
Ctrl+P: selector de sesión
Ctrl+O: toggle de expansión de salida de herramientas
Ctrl+T: toggle de visibilidad del thinking (recarga el historial)

Comandos slash

Core:

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

Controles de sesión:

/think <off|minimal|low|medium|high>
/fast <status|on|off>
/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>

Ciclo de vida de sesión:

/new o /reset (reiniciar la sesión)
/abort (abortar la ejecución activa)
/settings
/exit

Otros comandos slash del Gateway (por ejemplo, /context) se reenvían al Gateway y se muestran como salida del sistema. Consulta Comandos slash.

Comandos de shell locales

Antepón ! a una línea para ejecutar un comando de shell local en el host de la TUI.
La TUI solicita una vez por sesión permiso para ejecución local; rechazar mantiene ! deshabilitado para la sesión.
Los comandos se ejecutan en un shell nuevo, no interactivo, en el directorio de trabajo de la TUI (sin cd/env persistente).
Los comandos de shell locales reciben OPENCLAW_SHELL=tui-local en su entorno.
Un ! solo se envía como mensaje normal; los espacios al inicio no activan la ejecución local.

Salida de herramientas

Las llamadas de herramientas se muestran como tarjetas con argumentos + resultados.
Ctrl+O alterna entre vistas colapsadas/expandidas.
Mientras las herramientas se ejecutan, las actualizaciones parciales se transmiten a la misma tarjeta.

Colores del terminal

La TUI mantiene el texto del cuerpo del asistente en el color de primer plano por defecto de tu terminal para que terminales oscuras y claras sean legibles.
Si tu terminal usa fondo claro y la detección automática es incorrecta, configura OPENCLAW_THEME=light antes de lanzar openclaw tui.
Para forzar la paleta oscura original, configura OPENCLAW_THEME=dark.

Historial y streaming

Al conectar, la TUI carga el historial más reciente (200 mensajes por defecto).
Las respuestas en streaming se actualizan en su lugar hasta finalizar.
La TUI también escucha eventos de herramientas del agente para tarjetas de herramientas más ricas.

Detalles de conexión

La TUI se registra con el Gateway como mode: "tui".
Las reconexiones muestran un mensaje del sistema; las brechas de eventos se muestran en el log.

Opciones

--url <url>: URL del WebSocket del Gateway (por defecto según configuración o ws://127.0.0.1:<port>)
--token <token>: token del Gateway (si se requiere)
--password <password>: contraseña del Gateway (si se requiere)
--session <key>: clave de sesión (por defecto: main, o global cuando el alcance es global)
--deliver: entregar respuestas del asistente al proveedor (desactivado por defecto)
--thinking <level>: sobreescribir nivel de thinking para envíos
--timeout-ms <ms>: timeout del agente en ms (por defecto según agents.defaults.timeoutSeconds)

Nota: cuando configuras --url, la TUI no recurre a credenciales de configuración o entorno. Pasa --token o --password explícitamente. Las credenciales explícitas faltantes son un error.

Resolución de problemas

Sin salida después de enviar un mensaje:

Ejecuta /status en la TUI para confirmar que el Gateway está conectado e inactivo/ocupado.
Revisa los logs del Gateway: openclaw logs --follow.
Confirma que el agente puede ejecutarse: openclaw status y openclaw models status.
Si esperas mensajes en un canal de chat, habilita la entrega (/deliver on o --deliver).
--history-limit <n>: entradas de historial a cargar (por defecto 200)

Resolución de problemas de conexión

disconnected: asegúrate de que el Gateway esté ejecutándose y que tu --url/--token/--password sean correctos.
Sin agentes en el selector: revisa openclaw agents list y tu configuración de enrutamiento.
Selector de sesión vacío: puede que estés en alcance global o no tengas sesiones aún.