CLI commands

TUI

`openclaw tui`

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

Relacionado:

Guia da TUI: TUI

Opções

Flag	Padrão	Descrição
`--local`	`false`	Executa contra o ambiente de execução do agente incorporado local 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>`	(nenhum)	Senha do Gateway, se necessária.
`--session <key>`	`main` (ou `global` quando o escopo é global)	Chave da sessão. Dentro de um espaço de trabalho de agente, seleciona automaticamente esse agente, a menos que haja prefixo.
`--deliver`	`false`	Entrega respostas do assistente pelos canais configurados.
`--thinking <level>`	(padrão do modelo)	Substituição do nível de raciocínio.
`--message <text>`	(nenhum)	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.

Observações:

chat e terminal são aliases para openclaw tui --local.
--local não pode ser combinado com --url, --token ou --password.
tui resolve SecretRefs configuradas de autenticação do Gateway para autenticação por token/senha quando possível (provedores env/file/exec).
Quando iniciada de dentro de um diretório de espaço de trabalho 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>:...).
O modo local usa diretamente o ambiente de execução do agente incorporado. A maioria das ferramentas locais funciona, mas os recursos exclusivos do Gateway não ficam disponíveis.
O modo local adiciona /auth [provider] dentro da superfície de comandos da TUI.
Os gates 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 só porque o Gateway não está envolvido.

Exemplos

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

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 ignora a proteção contra configuração inválida.

bash

openclaw chat

Então, dentro da TUI:

text

!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, em seguida, execute novamente openclaw config validate. Consulte TUI e Config.

Relacionado

Was this useful?