Pular para o conteúdo principal

​
openclaw tui

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

​
Opções

FlagPadrãoDescrição
--localfalseExecuta contra o runtime local incorporado do agente em vez de um Gateway.
--url <url>gateway.remote.url da configuraçãoURL 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.
--deliverfalseEntrega 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.timeoutSecondsTempo limite do agente. Valores inválidos registram um aviso e são ignorados.
--history-limit <n>200Entradas 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 da sessão aparecem no rodapé e podem ser gerenciadas com /goal.

​
Exemplos

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. 
openclaw chat
Então, dentro da TUI: 
!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 e Configuração.

​
Relacionado