CLI commands
TUI
openclaw tui
Abra a interface de terminal conectada ao Gateway ou execute-a no modo local incorporado.
Relacionado:
- Guia da TUI: 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:
chateterminalsão aliases paraopenclaw tui --local.--localnão pode ser combinado com--url,--tokenou--password.tuiresolve SecretRefs de autenticação do Gateway configurados para autenticação por token/senha quando possível (provedoresenv/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
--sessionseja explicitamenteagent:<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 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 bugfixLoop 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 chatEntão, dentro da TUI:
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctorAplique correções direcionadas com openclaw config set ou openclaw configure e depois execute openclaw config validate novamente. Consulte TUI e Configuração.
