Skip to main content

​
openclaw tui

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

​
Opções

Aliases: openclaw chat e openclaw terminal invocam este comando com --local implícito.

​
Observações

  • --local não pode ser combinado com --url, --token, --password nem --tls-fingerprint.
  • tui resolve as SecretRefs de autenticação do Gateway configuradas para autenticação por token/senha quando possível (provedores env/file/exec).
  • Sem uma URL ou porta explícita, tui usa a porta local ativa do Gateway registrada pelo Gateway em execução. --url, OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_PORT e a configuração do Gateway remoto explícitos mantêm a precedência.
  • Quando iniciada dentro do diretório de espaço de trabalho de um agente configurado, a TUI seleciona automaticamente esse agente como padrão da chave da sessão (a menos que --session seja explicitamente agent:<id>:...).
  • Para exibir o nome do host do Gateway no rodapé de conexões não locais baseadas em URL, execute openclaw config set tui.footer.showRemoteHost true. Desativado por padrão; nunca é exibido em conexões local loopback ou locais incorporadas.
  • O modo local usa diretamente o ambiente de execução incorporado do agente. A maioria das ferramentas locais funciona, mas os recursos exclusivos do Gateway não ficam disponíveis.
  • O modo local adiciona /auth [provider] à superfície de comandos da TUI.
  • As verificações de aprovação de Plugins continuam válidas no modo local: ferramentas que exigem aprovação solicitam uma decisão no terminal; nada é aprovado automaticamente de forma silenciosa.
  • Os objetivos da sessão aparecem no rodapé e podem ser gerenciados com /goal.

​
Exemplos

​
Ciclo de reparo da configuração

Use o modo local para que o agente incorporado inspecione a configuração atual, compare-a com a documentação e ajude a corrigi-la no mesmo terminal. Se openclaw config validate já estiver falhando, execute primeiro openclaw configure ou openclaw doctor --fix; openclaw chat não ignora a proteção contra configuração inválida.
Em seguida, dentro da TUI:
Aplique correções específicas com openclaw config set ou openclaw configure e, em seguida, execute novamente openclaw config validate. Consulte TUI e Configuração.

​
Relacionados