Guía TUI de OpenClaw: Inicia tu terminal en 3 pasos

¿Alguna vez has sentido que cambiar entre tu editor de código y el navegador para consultar una IA te saca totalmente de foco? Esa pequeña fricción, repetida cien veces al día, agota tu energía mental. La TUI (Terminal UI) de OpenClaw está diseñada para que no tengas que salir de tu terminal y mantengas tu flujo de trabajo intacto.

Es una interfaz directa y potente que se conecta a tu Gateway para ofrecerte una experiencia de chat fluida sin abandonar la línea de comandos.

Inicio rápido

1. Inicia el Gateway.

openclaw gateway

2. Abre la TUI.

openclaw tui

3. Escribe un mensaje y pulsa Enter.

Remote Gateway:

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

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

Lo que ves

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

Modelo mental: agents + sessions

• Los agents son slugs únicos (por ejemplo, main, research). El Gateway expone la lista.
• Las sesiones pertenecen al agent actual.
• Las claves de sesión se guardan 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 agent explícitamente.
• Alcance de la sesión:
  • per-sender (por defecto): cada agent tiene muchas sesiones.
  • global: la TUI siempre usa la sesión global (el selector puede estar vacío).
• El agent y la sesión actuales siempre están visibles en el pie de página.

Envío + entrega

• Los mensajes se envían al Gateway; la entrega (delivery) a los proveedores está desactivada por defecto.
• Activa la entrega:
  • /deliver on
  • O mediante el panel de Settings.
  • O inicia con openclaw tui --deliver.

Selectores + superposiciones

• Selector de modelo: lista los modelos disponibles y establece el override de la sesión.
• Selector de agent: elige un agent diferente.
• Selector de sesión: muestra solo las sesiones del agent actual.
• Settings: alterna deliver, la expansión de salida de herramientas y la visibilidad de “thinking”.

Atajos de teclado

• Enter: enviar mensaje
• Esc: abortar ejecución activa
• Ctrl+C: limpiar entrada (pulsa dos veces para salir)
• Ctrl+D: salir
• Ctrl+L: selector de modelo
• Ctrl+G: selector de agent
• Ctrl+P: selector de sesión
• Ctrl+O: alternar expansión de salida de herramientas
• Ctrl+T: alternar visibilidad de “thinking” (recarga el historial)

Comandos de barra diagonal

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 la sesión:

• /new o /reset (reinicia la sesión)
• /abort (aborta la ejecución activa)
• /settings
• /exit

Otros comandos de barra diagonal del Gateway (por ejemplo, /context) se reenvían al Gateway y se muestran como salida del sistema. Consulta Slash commands.

Comandos de shell locales

• Prefija una línea con ! para ejecutar un comando de shell local en el host de la TUI.
• La TUI pregunta una vez por sesión para permitir la ejecución local; si lo rechazas, ! se mantiene desactivado durante la sesión.
• Los comandos se ejecutan en una shell nueva y no interactiva 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 ! solitario se envía como un mensaje normal; los espacios iniciales no activan la ejecución local.

Salida de herramientas

• Las llamadas a herramientas se muestran como tarjetas con args + resultados.
• Ctrl+O alterna entre vistas colapsadas y expandidas.
• Mientras las herramientas se ejecutan, las actualizaciones parciales se transmiten por streaming en la misma tarjeta.

Colores de la terminal

• La TUI mantiene el texto del cuerpo del asistente en el color frontal por defecto de tu terminal para que tanto las terminales oscuras como las claras sean legibles.
• Si tu terminal usa un fondo claro y la autodetección falla, establece OPENCLAW_THEME=light antes de lanzar openclaw tui.
• Para forzar la paleta oscura original, establece OPENCLAW_THEME=dark.

Historial + streaming

• Al conectar, la TUI carga el historial más reciente (200 mensajes por defecto).
• Las respuestas en streaming se mantienen actualizadas hasta que finalizan.
• La TUI también escucha eventos de herramientas del agent para generar tarjetas de herramientas más completas.

Detalles de conexión

• La TUI se registra en el Gateway como mode: "tui".
• Las reconexiones muestran un mensaje del sistema; los huecos en los eventos aparecen en el log.

Opciones

• --url <url>: URL WebSocket del Gateway (por defecto según la configuración o ws://127.0.0.1:<port>)
• --token <token>: Token del Gateway (si es necesario)
• --password <password>: Contraseña del Gateway (si es necesario)
• --session <key>: Clave de sesión (por defecto: main, o global cuando el alcance es global)
• --deliver: Entrega las respuestas del asistente al proveedor (desactivado por defecto)
• --thinking <level>: Sobrescribe el nivel de “thinking” para los envíos
• --timeout-ms <ms>: Tiempo de espera del agent en ms (por defecto agents.defaults.timeoutSeconds)

Nota: cuando estableces --url, la TUI no recurre a las credenciales de configuración o del entorno. Pasa --token o --password explícitamente. La falta de credenciales explícitas resultará en un error.

Solució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 u ocupado.
• Revisa los logs del Gateway: openclaw logs --follow.
• Confirma que el agent puede ejecutarse: openclaw status y openclaw models status.
• Si esperas mensajes en un canal de chat, activa la entrega (/deliver on o --deliver).
• --history-limit <n>: Entradas de historial a cargar (por defecto 200).

Solución de problemas de conexión

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

Relacionado

• Control UI — interfaz de control basada en web
• CLI Reference — referencia completa de comandos CLI

Próximos pasos

• Explora cómo configurar tus propios Agents.
• Aprende más sobre el uso de Slash commands para maximizar tu productividad.

AI Setup Assistant