> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI

# `openclaw tui`

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

Guía relacionada: [TUI](/es/web/tui)

## Opciones

| Indicador             | Predeterminado                                  | Descripción                                                                                                                |
| --------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `--local`             | `false`                                         | Ejecuta contra el runtime local incrustado 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 se requiere.                                                                                          |
| `--password <pass>`   | (ninguna)                                       | Contraseña del Gateway si se requiere.                                                                                     |
| `--session <key>`     | `main` (o `global` cuando el alcance es global) | Clave de sesión. Dentro de un espacio de trabajo de agente, selecciona automáticamente ese agente salvo que tenga prefijo. |
| `--deliver`           | `false`                                         | Entrega las respuestas del asistente mediante los canales configurados.                                                    |
| `--thinking <level>`  | (predeterminado del modelo)                     | Sobrescritura del 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 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 este comando con
`--local` implícito.

## Notas

* `--local` no se puede combinar con `--url`, `--token` ni `--password`.
* `tui` resuelve los SecretRefs de autenticación del Gateway configurados para autenticación
  con token/contraseña cuando es posible (proveedores `env`/`file`/`exec`).
* Sin una URL o puerto explícitos, `tui` sigue el puerto del Gateway local activo
  registrado por el Gateway en ejecución. `--url`, `OPENCLAW_GATEWAY_URL`,
  `OPENCLAW_GATEWAY_PORT` y la configuración de Gateway remoto explícitos mantienen la precedencia.
* Cuando se inicia desde dentro de un directorio de espacio de trabajo de agente configurado, TUI selecciona automáticamente
  ese agente como valor predeterminado de la clave de sesión (a menos que `--session` sea explícitamente
  `agent:<id>:...`).
* Para mostrar el nombre de host del Gateway en el pie de página para conexiones respaldadas por URL
  no locales, ejecuta `openclaw config set tui.footer.showRemoteHost true`. Desactivado de forma
  predeterminada; nunca se muestra para conexiones de loopback o locales incrustadas.
* El modo local usa directamente el runtime incrustado del agente. La mayoría de las herramientas locales funcionan,
  pero las funciones exclusivas del Gateway no están disponibles.
* El modo local agrega `/auth [provider]` a 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.
* Los [objetivos](/es/tools/goal) de sesión aparecen en el pie de página y se pueden gestionar con
  `/goal`.

## Ejemplos

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 para que el agente incrustado 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` u
`openclaw doctor --fix`; `openclaw chat` no omite la protección de
configuración no válida.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw chat
```

Luego, dentro de TUI:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
!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](/es/web/tui) y
[Configuración](/es/cli/config).

## Relacionado

* [Referencia de CLI](/es/cli)
* [TUI](/es/web/tui)
* [Objetivo](/es/tools/goal)