OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Web interfaces

TUI

Inicio rápido

Modo Gateway

  1. Inicie el Gateway.
bash
openclaw gateway
  1. Abra la TUI.
bash
openclaw tui
  1. Escriba un mensaje y pulse Intro.

Gateway remoto:

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

Use --password si su Gateway utiliza autenticación mediante contraseña.

Modo local

Ejecute la TUI sin un Gateway:

bash
openclaw chat# oopenclaw tui --local
  • openclaw chat y openclaw terminal son alias de openclaw tui --local.
  • --local no se puede combinar con --url, --token ni --password.
  • El modo local utiliza directamente el entorno de ejecución integrado del agente. La mayoría de las herramientas locales funcionan, pero las funciones exclusivas del Gateway no están disponibles.
  • openclaw sin argumentos (sin subcomando) elige un destino automáticamente: una instalación sin configurar ejecuta la incorporación para inferencia; una configuración no válida abre las indicaciones clásicas de Doctor; un Gateway configurado y accesible abre este shell de la TUI en modo Gateway; de lo contrario, un modelo local configurado lo abre en modo local.

Qué se muestra

  • Encabezado: URL de conexión, agente actual y sesión actual.
  • Registro del chat: mensajes del usuario, respuestas del asistente, avisos del sistema y tarjetas de herramientas.
  • Línea de estado: estado de la conexión o ejecución (conectando, ejecutándose, transmitiendo, inactivo, error).
  • Pie: agente + sesión + modelo + estado del objetivo + reflexión/rápido/detallado/seguimiento/razonamiento + recuentos de tokens + entrega. Cuando tui.footer.showRemoteHost está activado, las conexiones remotas al Gateway también muestran el host de conexión.
  • Entrada: editor de texto con autocompletado.

Modelo mental: agentes + sesiones

  • Los agentes son identificadores únicos (por ejemplo, main y 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 la sesión de ese agente.

  • Ámbito de la sesión:

    • per-sender (predeterminado): cada agente tiene muchas sesiones.
    • global: la TUI siempre utiliza la sesión global (el selector puede estar vacío).

  • El agente y la sesión actuales siempre están visibles en el pie.

  • Para mostrar el host del Gateway en conexiones no locales basadas en URL, habilítelo con:

    bash
    openclaw config set tui.footer.showRemoteHost true

    El valor predeterminado es false. Las conexiones de local loopback y locales integradas nunca muestran una etiqueta de host.

  • Si la sesión tiene un objetivo, el pie muestra su estado resumido: Persiguiendo el objetivo, Objetivo en pausa (/goal resume), Objetivo bloqueado (/goal resume) u Objetivo alcanzado.

  • Cuando se inicia sin --session, la TUI en modo Gateway reanuda la última sesión seleccionada para el mismo Gateway, agente y ámbito de sesión si esa sesión aún existe. Pasar --session, /session, /new o /reset sigue siendo una acción explícita.

Envío + entrega

  • Los mensajes siempre se envían al Gateway (o al entorno de ejecución integrado en modo local); entregar la respuesta del asistente a un proveedor de chat es un paso independiente, desactivado de forma predeterminada.
  • La TUI es una superficie de origen interna, como WebChat, no un canal de salida genérico. Los entornos que requieren tools.message para las respuestas visibles pueden satisfacer el turno activo de la TUI con un message.send sin destino; la entrega explícita mediante un proveedor sigue utilizando los canales configurados habituales y nunca recurre a lastChannel.
  • La entrega queda fijada para toda la sesión de la TUI al iniciarla: iníciela con openclaw tui --deliver para activarla. No hay ningún comando de barra /deliver ni opción en Configuración que permita cambiarla durante la sesión; reinicie la TUI para modificarla.

Selectores + superposiciones

  • Selector de modelos: muestra los modelos disponibles y establece la anulación para la sesión.
  • Selector de agentes: permite elegir otro agente.
  • Selector de sesiones: muestra hasta 50 sesiones del agente actual actualizadas durante los últimos 7 días. Use /session <key> para ir a una sesión conocida más antigua.
  • Configuración (/settings): permite alternar la expansión de la salida de las herramientas y la visibilidad de la reflexión. Este panel no controla la entrega.

Atajos de teclado

  • Intro: enviar mensaje
  • Esc: cancelar la ejecución activa
  • Ctrl+C: borrar la entrada (púlselo dos veces para salir)
  • Ctrl+D: salir
  • Ctrl+L: selector de modelos
  • Ctrl+G: selector de agentes
  • Ctrl+P: selector de sesiones
  • Ctrl+O: alternar la expansión de la salida de las herramientas
  • Ctrl+T: alternar la visibilidad de la reflexión (vuelve a cargar el historial)

Comandos de barra

Principales:

  • /help
  • /status (reenviado al Gateway; muestra el resumen de sesión/modelo)
  • /gateway-status (alias /gwstatus; muestra directamente el estado de conexión del Gateway)
  • /agent <id> (o /agents)
  • /session <key> (o /sessions)
  • /model <provider/model> (o /models)

Controles de la sesión:

  • /think <off|minimal|low|medium|high> (los niveles superiores pueden añadir niveles como xhigh/max, según el modelo)
  • /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 borra la anulación de la sesión)
  • /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
  • /elevated <on|off|ask|full> (alias: /elev)
  • /activation <mention|always>

Ciclo de vida de la sesión:

  • /new (crea una sesión nueva y aislada con una clave nueva; no afecta a otros clientes de la TUI en la sesión anterior)
  • /reset (restablece en el mismo lugar la clave de la sesión actual)
  • /abort (cancela la ejecución activa)
  • /settings
  • /exit (o /quit)

Solo en modo local:

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

Crestodian:

  • /crestodian [request] vuelve de la TUI normal del agente al chat de Crestodian para configuración/reparación y, opcionalmente, reenvía una solicitud.

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

Comandos del shell local

  • Añada ! al principio de una línea para ejecutar un comando del shell local en el host de la TUI.
  • La TUI solicita una vez por sesión permiso para la ejecución local; si lo rechaza, ! permanece desactivado durante la sesión.
  • Los comandos se ejecutan en un shell nuevo y no interactivo en el directorio de trabajo de la TUI (sin cd ni variables de entorno persistentes).
  • Los comandos del shell local reciben OPENCLAW_SHELL=tui-local en su entorno.
  • Un ! aislado se envía como mensaje normal; los espacios iniciales no activan la ejecución local.

Asistente Crestodian de configuración y reparación

Crestodian es el asistente de nivel cero para configuración y reparación, disponible como openclaw crestodian después de que el modelo predeterminado configurado supere una comprobación de inferencia en vivo. Si la inferencia no está disponible, una invocación interactiva vuelve a la incorporación para inferencia y la automatización falla mostrando indicaciones para la reparación. Se ejecuta dentro del mismo shell local de la TUI que openclaw tui --local, respaldado por un agente de IA restringido a las operaciones tipadas de Crestodian y sujetas a aprobación:

bash
openclaw crestodian                       # iniciar de forma interactivaopenclaw crestodian -m "status"           # ejecutar una solicitud y saliropenclaw crestodian -m "set default model openai/gpt-5.2" --yes   # aplicar una escritura de configuración
  • Las escrituras persistentes de configuración necesitan aprobación: confírmelas de forma interactiva o pase --yes.
  • --json imprime el resumen de inicio como JSON en lugar de iniciar el chat.
  • Desde Crestodian, una solicitud open-tui (por ejemplo, pedir hablar con un agente normal) cierra Crestodian y abre la TUI habitual del agente; use /crestodian allí para volver.

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

Si openclaw config validate ya está fallando, empiece primero con openclaw configure u openclaw doctor --fix; openclaw chat sigue necesitando una configuración que pueda cargarse para iniciarse.

Ciclo habitual:

  1. Inicie el modo local:
bash
openclaw chat
  1. Pida al agente que compruebe lo que quiera, por ejemplo:
text
Compara la configuración de autenticación de mi Gateway con la documentación y sugiere la corrección más pequeña.
  1. Use comandos del shell local para obtener pruebas exactas y realizar la validación:
text
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor
  1. Aplique cambios específicos con openclaw config set u openclaw configure y, después, vuelva a ejecutar !openclaw config validate.
  2. Si Doctor recomienda una migración o reparación automática, revísela y ejecute !openclaw doctor --fix.

Consejos:

  • Prefiera openclaw config set u openclaw configure antes que editar manualmente openclaw.json.
  • openclaw docs "<query>" busca en el índice de documentación en vivo desde la misma máquina.
  • openclaw config validate --json resulta útil cuando se necesitan errores estructurados de esquema y de resolución de SecretRef.

Salida de las herramientas

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

Colores del terminal

  • La TUI mantiene el texto del cuerpo del asistente con el color de primer plano predeterminado del terminal para que siga siendo legible tanto en terminales claros como oscuros.
  • Si el terminal utiliza un fondo claro y la detección automática es incorrecta, establezca OPENCLAW_THEME=light antes de iniciar openclaw tui.
  • Para forzar en su lugar la paleta oscura original, establezca OPENCLAW_THEME=dark.

Historial + transmisión

  • Al conectarse, la TUI carga el historial más reciente (200 mensajes de forma predeterminada).
  • Las respuestas transmitidas se actualizan en el mismo lugar hasta que finalizan.
  • La TUI también escucha los eventos de herramientas del agente para mostrar tarjetas de herramientas más completas.

Detalles de la conexión

  • La TUI se conecta con el identificador de cliente openclaw-tui bajo el modo general de cliente ui (el mismo modo que utilizan Control UI y WebChat para la política del Gateway).
  • Las reconexiones muestran un mensaje del sistema; las interrupciones de eventos se indican en el registro.

Opciones

  • --local: Ejecutar con el entorno de ejecución integrado del agente local
  • --url <url>: URL WebSocket del Gateway (el valor predeterminado es gateway.remote.url de la configuración, o ws://127.0.0.1:<port> en local loopback)
  • --token <token>: Token del Gateway (si es necesario)
  • --password <password>: Contraseña del Gateway (si es necesaria)
  • --tls-fingerprint <sha256>: Huella digital esperada del certificado TLS para un Gateway wss:// fijado
  • --session <key>: Clave de sesión (valor predeterminado: main, o global cuando el ámbito es global)
  • --deliver: Entregar las respuestas del asistente al proveedor (desactivado de forma predeterminada)
  • --thinking <level>: Anular el nivel de reflexión para los envíos
  • --message <text>: Enviar un mensaje inicial después de conectarse
  • --timeout-ms <ms>: Tiempo de espera del agente en ms (el valor predeterminado es agents.defaults.timeoutSeconds)
  • --history-limit <n>: Entradas del historial que se cargarán (valor predeterminado: 200)

Solución de problemas

No hay salida después de enviar un mensaje:

  • Ejecute /status en la TUI para confirmar que el Gateway está conectado e inactivo/ocupado.
  • Compruebe los registros del Gateway: openclaw logs --follow.
  • Confirme que el agente puede ejecutarse: openclaw status y openclaw models status.
  • Si espera mensajes en un canal de chat, confirme que la TUI se inició con --deliver (no se puede activar posteriormente sin reiniciarla).

Solución de problemas de conexión

  • disconnected: asegúrese de que el Gateway esté en ejecución y de que --url/--token/--password sean correctos.
  • No aparecen agentes en el selector: compruebe openclaw agents list y la configuración de enrutamiento.
  • Selector de sesiones vacío: puede que esté en el ámbito global o que aún no tenga sesiones.

Contenido relacionado

Was this useful?
On this page

On this page