> ## 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`

Abra a interface de terminal conectada ao Gateway ou execute-a no modo local incorporado.

Relacionado:

* Guia da TUI: [TUI](/pt-BR/web/tui)

## Opções

| Flag                  | Padrão                                        | Descrição                                                                                                              |
| --------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `--local`             | `false`                                       | Executa contra o runtime local incorporado do agente em vez de um Gateway.                                             |
| `--url <url>`         | `gateway.remote.url` da configuração          | URL WebSocket do Gateway.                                                                                              |
| `--token <token>`     | (nenhum)                                      | Token do Gateway, se necessário.                                                                                       |
| `--password <pass>`   | (nenhuma)                                     | Senha do Gateway, se necessária.                                                                                       |
| `--session <key>`     | `main` (ou `global` quando o escopo é global) | Chave da sessão. Dentro de um workspace de agente, seleciona automaticamente esse agente, a menos que haja um prefixo. |
| `--deliver`           | `false`                                       | Entrega respostas do assistente por meio dos canais configurados.                                                      |
| `--thinking <level>`  | (padrão do modelo)                            | Substituição do nível de raciocínio.                                                                                   |
| `--message <text>`    | (nenhuma)                                     | Envia uma mensagem inicial após conectar.                                                                              |
| `--timeout-ms <ms>`   | `agents.defaults.timeoutSeconds`              | Tempo limite do agente. Valores inválidos registram um aviso e são ignorados.                                          |
| `--history-limit <n>` | `200`                                         | Entradas do histórico a carregar ao anexar.                                                                            |

Aliases: `openclaw chat` e `openclaw terminal` invocam o mesmo comando com `--local` implícito.

Notas:

* `chat` e `terminal` são aliases para `openclaw tui --local`.
* `--local` não pode ser combinado com `--url`, `--token` ou `--password`.
* `tui` resolve SecretRefs de autenticação do Gateway configurados para autenticação por token/senha quando possível (provedores `env`/`file`/`exec`).
* Quando iniciada de dentro de um diretório de workspace de agente configurado, a TUI seleciona automaticamente esse agente como padrão da chave de sessão (a menos que `--session` seja explicitamente `agent:<id>:...`).
* Para mostrar o nome do host do Gateway no rodapé para conexões baseadas em URL não locais, execute `openclaw config set tui.footer.showRemoteHost true`. O rótulo do host fica desativado por padrão e nunca aparece para conexões loopback ou locais incorporadas.
* O modo local usa diretamente o runtime incorporado do agente. A maioria das ferramentas locais funciona, mas recursos exclusivos do Gateway ficam indisponíveis.
* O modo local adiciona `/auth [provider]` dentro da superfície de comandos da TUI.
* Os controles de aprovação de Plugin ainda se aplicam no modo local. Ferramentas que exigem aprovação solicitam uma decisão no terminal; nada é aprovado automaticamente de forma silenciosa porque o Gateway não está envolvido.
* As [metas](/pt-BR/tools/goal) da sessão aparecem no rodapé e podem ser gerenciadas com `/goal`.

## Exemplos

```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
```

## Loop de reparo da configuração

Use o modo local quando a configuração atual já for validada e você quiser que o agente incorporado a inspecione, compare-a com a documentação e ajude a repará-la a partir do mesmo terminal:

Se `openclaw config validate` já estiver falhando, use `openclaw configure` ou `openclaw doctor --fix` primeiro. `openclaw chat` não contorna a proteção contra configuração inválida.

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

Então, dentro da TUI:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
```

Aplique correções direcionadas com `openclaw config set` ou `openclaw configure` e depois execute `openclaw config validate` novamente. Consulte [TUI](/pt-BR/web/tui) e [Configuração](/pt-BR/cli/config).

## Relacionado

* [Referência da CLI](/pt-BR/cli)
* [TUI](/pt-BR/web/tui)
* [Meta](/pt-BR/tools/goal)