Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

openclaw tui

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

Opções

FlagPadrãoDescrição
--localfalseExecuta contra o ambiente de execução do agente incorporado local 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>(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.
--deliverfalseEntrega 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.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. 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

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

Relacionado