CLI commands

TUI

`openclaw tui`

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

Guía relacionada: TUI

Opciones

Opción	Valor predeterminado	Descripción
`--local`	`false`	Se ejecuta con el entorno de ejecución local integrado del agente 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 es necesario.
`--password <pass>`	(ninguna)	Contraseña del Gateway, si es necesaria.
`--tls-fingerprint <sha256>`	`gateway.remote.tlsFingerprint`	Huella digital esperada del certificado TLS para un Gateway `wss://` fijado.
`--session <key>`	`main` (o `global` si el ámbito es global)	Clave de sesión. Dentro del espacio de trabajo de un agente, selecciona automáticamente ese agente, salvo que se especifique un prefijo.
`--deliver`	`false`	Entrega las respuestas del asistente a través de los canales configurados.
`--thinking <level>`	(valor predeterminado del modelo)	Sustituye el nivel de razonamiento.
`--message <text>`	(ninguno)	Envía un mensaje inicial después de conectarse.
`--timeout-ms <ms>`	`agents.defaults.timeoutSeconds`	Tiempo de espera del agente. Los valores no válidos generan una advertencia en el registro y se ignoran.
`--history-limit <n>`	`200`	Número de entradas del historial que se cargan al conectarse.

Los alias openclaw chat y openclaw terminal invocan este comando con --local implícito.

Notas

--local no se puede combinar con --url, --token, --password ni --tls-fingerprint.
Cuando es posible, tui resuelve los SecretRefs de autenticación del Gateway configurados para la autenticación mediante token o contraseña (proveedores env/file/exec).
Si no se especifica una URL ni un puerto, tui usa el puerto local activo del Gateway registrado por el Gateway en ejecución. Las opciones explícitas --url, OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_PORT y la configuración del Gateway remoto conservan la prioridad.
Cuando se inicia desde el directorio del espacio de trabajo de un agente configurado, la TUI selecciona automáticamente ese agente como valor predeterminado de la clave de sesión (a menos que --session se especifique explícitamente como agent:<id>:...).
Para mostrar el nombre de host del Gateway en el pie de página de conexiones no locales basadas en URL, ejecuta openclaw config set tui.footer.showRemoteHost true. Está desactivado de forma predeterminada y nunca se muestra en conexiones local loopback ni en conexiones locales integradas.
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.
El modo local añade /auth [provider] al conjunto de comandos de la TUI.
Las comprobaciones de aprobación de los Plugins siguen aplicándose en el modo local: las herramientas que requieren aprobación solicitan una decisión en la terminal; nada se aprueba automáticamente de forma silenciosa.
Los objetivos de la sesión aparecen en el pie de página y se pueden gestionar 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 la configuración

Usa el modo local para que el agente integrado inspeccione la configuración actual, la compare con la documentación y ayude a repararla desde la misma terminal.

Si openclaw config validate ya está fallando, ejecuta primero openclaw configure o openclaw doctor --fix; openclaw chat no omite la protección contra configuraciones no válidas.

bash

openclaw chat

Después, dentro de la TUI:

text

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

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

Contenido relacionado

Was this useful?

TUI