TUI

Inicio rápido

Modo Gateway

Inicie la Gateway.

openclaw gateway

Abra la TUI.

openclaw tui

Escriba un mensaje y presione Enter.

Gateway remota:

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

Use --password si su Gateway usa autenticación por contraseña.

Modo local

Ejecute la TUI sin un Gateway:

openclaw chat
# or
openclaw tui --local

Notas:

openclaw chat y openclaw terminal son alias de openclaw tui --local.
--local no se puede combinar con --url, --token o --password.
El modo local utiliza directamente el tiempo de ejecución del agente integrado. La mayoría de las herramientas locales funcionan, pero las funciones exclusivas del Gateway no están disponibles.
openclaw y openclaw crestodian también usan este shell de TUI, con Crestodian como el backend de chat de configuración y reparación local.

Lo que ves

Encabezado: URL de conexión, agente actual, sesión actual.
Registro de chat: mensajes de 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/trace/reasoning + recuento de tokens + entregar.
Entrada: editor de texto con autocompletado.

Modelo mental: agentes + sesiones

Los agentes son slugs únicos (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 escribe /session main, la TUI lo expande a agent:<currentAgent>:main.
- Si escribe /session agent:other:main, cambia explícitamente a esa sesión de agente.
Ámbito de sesión:
- per-sender (predeterminado): cada agente tiene muchas sesiones.
- global: la TUI siempre usa la sesión global (el selector puede estar vacío).
El agente actual + la sesión siempre son visibles en el pie de página.
Cuando se inicia sin --session, la TUI en modo de puerta de enlace reanuda la última sesión seleccionada para la misma puerta de enlace, agente y alcance de sesión si esa sesión todavía existe. Pasar --session, /session, /new o /reset permanece explícito.

Envío y entrega

Los mensajes se envían a la puerta de enlace; la entrega a los proveedores está desactivada por defecto.
La TUI es una superficie de origen interna como WebChat, no un canal de salida genérico. Los arneses que requieren tools.message para respuestas visibles pueden satisfacer el turno activo de la TUI con un message.send sin destino; la entrega explícita del proveedor aún utiliza los canales configurados normales y nunca recurre a lastChannel.
Activar la entrega en:
- /deliver on
- o el panel Configuración
- o comenzar con openclaw tui --deliver

Selectores y superposiciones

Selector de modelo: enumera los modelos disponibles y establece la anulación de la sesión.
Selector de agente: elige un agente diferente.
Selector de sesión: muestra hasta 50 sesiones para el agente actual actualizadas en los últimos 7 días. Use /session <key> para saltar a una sesión conocida anterior.
Configuración: alternar entrega, expansión de salida de herramienta y visibilidad del pensamiento.

Atajos de teclado

Enter: enviar mensaje
Esc: abortar ejecución activa
Ctrl+C: borrar entrada (presione 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: alternar expansión de salida de herramienta
Ctrl+T: alternar visibilidad del pensamiento (recarga el historial)

Comandos de barra

Núcleo:

/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>
/trace <on|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 (restablecer la sesión)
/abort (abortar la ejecución activa)
/settings
/exit

Solo en modo local:

/auth [provider] abre el flujo de autenticación/inicio de sesión del proveedor dentro de la TUI.

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

Comandos de shell local

Prefije una línea con ! para ejecutar un comando de shell local en el host de la TUI.
La TUI solicita una vez por sesión permitir la ejecución local; si se rechaza, ! se mantiene deshabilitado para la sesión.
Los comandos se ejecutan en un shell nuevo y no interactivo en el directorio de trabajo de la TUI (sin cd/env persistente).
Los comandos de shell local 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.

Reparar configuraciones desde la TUI local

Use el modo local cuando la configuración actual ya sea válida y desee que el agente integrado la inspeccione en la misma máquina, la compare con la documentación, y ayude a reparar desviaciones sin depender de un Gateway en ejecución.

Si openclaw config validate ya está fallando, comience con openclaw configure o openclaw doctor --fix primero. openclaw chat no omite el guardián de configuración inválida.

Bucle típico:

Iniciar modo local:

openclaw chat

Pregunte al agente qué desea que verifique, por ejemplo:

Compare my gateway auth config with the docs and suggest the smallest fix.

Use comandos de shell local para obtener pruebas exactas y validación:

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

Aplique cambios específicos con openclaw config set o openclaw configure, luego vuelva a ejecutar !openclaw config validate.
Si Doctor recomienda una migración o reparación automática, revísela y ejecute !openclaw doctor --fix.

Consejos:

Prefiera openclaw config set o openclaw configure antes que editar openclaw.json manualmente.
openclaw docs "<query>" busca en el índice de documentos en vivo desde la misma máquina.
openclaw config validate --json es útil cuando desea errores de esquema estructurado y SecretRef/resolvabilidad.

Resultados de herramientas

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

Colores de la terminal

La TUI mantiene el texto del cuerpo del asistente en el primer plano predeterminado de su terminal para que las terminales oscuras y claras sigan siendo legibles.
Si tu terminal usa un fondo claro y la detección automática es incorrecta, establece OPENCLAW_THEME=light antes de iniciar openclaw tui.
Para forzar la paleta oscura original en su lugar, establece OPENCLAW_THEME=dark.

Historial + streaming

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

Detalles de la 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 registro.

Opciones

--local: Ejecutar contra el runtime de agente integrado local
--url <url>: URL del WebSocket del Gateway (por defecto es la 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 ámbito es global)
--deliver: Entregar respuestas del asistente al proveedor (por defecto desactivado)
--thinking <level>: Anular el nivel de pensamiento para los envíos
--message <text>: Enviar un mensaje inicial después de conectarse
--timeout-ms <ms>: Tiempo de espera del agente en ms (por defecto agents.defaults.timeoutSeconds)
--history-limit <n>: Entradas de historial a cargar (por defecto 200)

Solución de problemas

Sin salida después de enviar un mensaje:

Ejecuta /status en la TUI para confirmar que el Gateway está conectado y inactivo/ocupado.
Revisa los registros 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).

Solución de problemas de conexión

disconnected: asegúrate de que el Gateway se esté ejecutando y que tus --url/--token/--password sean correctos.
No hay agentes en el selector: verifica openclaw agents list y tu configuración de enrutamiento.
Selector de sesiones vacío: es posible que estés en el ámbito global o que aún no tengas sesiones.

Relacionado

Control UI — interfaz de control basada en web
Config — inspecciona, valida y edita openclaw.json
Doctor — comprobaciones guiadas de reparación y migración
CLI Reference — referencia completa de comandos de la CLI