Ir al contenido

TUI

Abra la interfaz de usuario de terminal conectada a Gateway, o ejecútela en modo integrado local.

Relacionado:

  • Guía de la TUI: TUI
FlagPredeterminadoDescripción
--localfalseEjecutar contra el runtime del agente integrado local en lugar de un Gateway.
--url <url>gateway.remote.url de la configuraciónURL WebSocket del Gateway.
--token <token>(ninguno)Token del Gateway si es necesario.
--password <pass>(ninguno)Contraseña del Gateway si es necesaria.
--session <key>main (o global cuando el ámbito es global)Clave de sesión. Dentro de un espacio de trabajo de agente, selecciona automáticamente ese agente a menos que se prefije.
--deliverfalseEntregar respuestas del asistente a través de canales configurados.
--thinking <level>(predeterminado del modelo)Anulación del nivel de pensamiento.
--message <text>(ninguno)Enviar un mensaje inicial después de conectarse.
--timeout-ms <ms>agents.defaults.timeoutSecondsTiempo de espera del agente. Los valores no válidos registran una advertencia y se ignoran.
--history-limit <n>200Entradas del historial que cargar al adjuntar.

Alias: openclaw chat y openclaw terminal invocan el mismo comando con --local implícito.

Notas:

  • chat y terminal son alias para openclaw tui --local.
  • --local no se puede combinar con --url, --token o --password.
  • tui resuelve los SecretRefs de autenticación del gateway configurados para autenticación de token/contraseña cuando sea posible (proveedores env/file/exec).
  • Cuando se inicia desde dentro de un directorio de espacio de trabajo de agente configurado, la TUI selecciona automáticamente ese agente para el valor predeterminado de la clave de sesión (a menos que --session sea explícitamente agent:<id>:...).
  • El modo local usa el runtime del agente integrado directamente. La mayoría de las herramientas locales funcionan, pero las funciones exclusivas del Gateway no están disponibles.
  • El modo local añade /auth [provider] dentro de la superficie de comandos de la TUI.
  • Las puertas de aprobación de complementos aún se aplican en modo local. Las herramientas que requieren aprobación solicitan una decisión en la terminal; nada se aprueba automáticamente en silencio porque la Pasarela no está involucrada.
Ventana de terminal
openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix

Use el modo local cuando la configuración actual ya sea válida y desee que el agente integrado la inspeccione, la compare con la documentación y ayude a repararla desde la misma terminal:

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

Ventana de terminal
openclaw chat

Luego, dentro de la TUI:

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

Aplique correcciones específicas con openclaw config set o openclaw configure, y luego vuelva a ejecutar openclaw config validate. Consulte TUI y Config.