English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

TUI

openclaw tui

Abre la interfaz de terminal conectada al Gateway, o ejecútala en modo local integrado.

Relacionado:

  • Guía de TUI: TUI

Opciones

Indicador Predeterminado Descripción
--local false Ejecuta contra el runtime del agente local integrado en lugar de un Gateway.
--url <url> gateway.remote.url de la configuración URL WebSocket del Gateway.
--token <token> (ninguno) Token del Gateway si se requiere.
--password <pass> (ninguno) Contraseña del Gateway si se requiere.
--session <key> main (o global cuando el ámbito es global) Clave de sesión. Dentro de un workspace de agente, selecciona automáticamente ese agente salvo que tenga prefijo.
--deliver false Entrega las respuestas del asistente a través de los canales configurados.
--thinking <level> (predeterminado del modelo) Sobrescritura del nivel de razonamiento.
--message <text> (ninguno) Envía un mensaje inicial después de conectar.
--timeout-ms <ms> agents.defaults.timeoutSeconds Tiempo de espera del agente. Los valores no válidos registran una advertencia y se ignoran.
--history-limit <n> 200 Entradas del historial que se cargarán al adjuntar.

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

Notas:

  • chat y terminal son alias de openclaw tui --local.
  • --local no se puede combinar con --url, --token ni --password.
  • tui resuelve los SecretRefs de autenticación del gateway configurado para autenticación con token/contraseña cuando es posible (proveedores env/file/exec).
  • Cuando se inicia desde dentro de un directorio de workspace de agente configurado, TUI selecciona automáticamente ese agente para el valor predeterminado de la clave de sesión (salvo que --session sea explícitamente agent:<id>:...).
  • Para mostrar el nombre de host del Gateway en el pie de página para conexiones no locales respaldadas por URL, ejecuta openclaw config set tui.footer.showRemoteHost true. La etiqueta del host está desactivada de forma predeterminada y nunca aparece para conexiones de loopback o locales integradas.
  • El modo local usa directamente el runtime del agente integrado. La mayoría de las herramientas locales funcionan, pero las funciones exclusivas del Gateway no están disponibles.
  • El modo local agrega /auth [provider] dentro de la superficie de comandos de TUI.
  • Las puertas de aprobación de Plugin siguen aplicándose en modo local. Las herramientas que requieren aprobación solicitan una decisión en la terminal; nada se aprueba automáticamente en silencio porque el Gateway no interviene.
  • Los objetivos de sesión aparecen en el pie de página y se pueden administrar con /goal.

Ejemplos

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfix

Bucle de reparación de configuración

Usa el modo local cuando la configuración actual ya valide 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 de configuración no válida.

bash
openclaw chat

Luego, dentro de TUI:

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

Aplica correcciones específicas con openclaw config set u openclaw configure, luego vuelve a ejecutar openclaw config validate. Consulta TUI y Configuración.

Relacionado

Was this useful?
On this page

On this page