CLI commands

TUI

openclaw tui

Abre la interfaz de terminal conectada al Gateway o la ejecuta en modo integrado local.

Relacionado:

  • Guía de TUI: TUI

Notas:

  • chat y terminal son alias de openclaw tui --local.
  • --local no puede combinarse con --url, --token ni --password.
  • tui resuelve SecretRefs de autenticación del Gateway configurados para autenticación por token/contraseña cuando es 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 directamente el runtime integrado del agente. 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 barreras de aprobación de Plugins siguen aplicándose en modo local. Las herramientas que requieren aprobación solicitan una decisión en la terminal; nada se aprueba automáticamente de forma silenciosa porque el Gateway no interviene.

Ejemplos

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

Bucle de reparación de configuración

Usa el modo local cuando la configuración actual ya es válida y quieras 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, usa primero openclaw configure o openclaw doctor --fix. openclaw chat no omite la protección contra configuración inválida.

openclaw chat

Luego, dentro de la TUI:

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

Aplica correcciones concretas con openclaw config set o openclaw configure, y luego vuelve a ejecutar openclaw config validate. Consulta TUI y Config.

Relacionado