Skip to main content

openclaw tui

Apre l’interfaccia utente del terminale connessa al Gateway oppure la esegue in modalità locale incorporata. Guida correlata: TUI

Opzioni

Gli alias openclaw chat e openclaw terminal richiamano questo comando con --local implicito.

Note

  • --local non può essere combinato con --url, --token, --password o --tls-fingerprint.
  • Quando possibile, tui risolve i SecretRef di autenticazione del Gateway configurati per l’autenticazione tramite token/password (provider env/file/exec).
  • Se non vengono specificati esplicitamente un URL o una porta, tui usa la porta attiva del Gateway locale registrata dal Gateway in esecuzione. --url, OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_PORT e la configurazione del Gateway remoto esplicitamente impostati mantengono la precedenza.
  • Se avviata dall’interno della directory dello spazio di lavoro di un agente configurato, la TUI seleziona automaticamente tale agente come valore predefinito della chiave di sessione, a meno che --session non sia esplicitamente nel formato agent:<id>:....
  • Per mostrare il nome host del Gateway nel piè di pagina per le connessioni non locali basate su URL, esegui openclaw config set tui.footer.showRemoteHost true. È disattivato per impostazione predefinita e non viene mai mostrato per connessioni local loopback o locali incorporate.
  • La modalità locale usa direttamente il runtime incorporato dell’agente. La maggior parte degli strumenti locali funziona, ma le funzionalità disponibili solo tramite Gateway non sono accessibili.
  • La modalità locale aggiunge /auth [provider] ai comandi disponibili nella TUI.
  • I controlli di approvazione dei Plugin si applicano anche in modalità locale: gli strumenti che richiedono approvazione chiedono una decisione nel terminale; nulla viene approvato automaticamente e senza avviso.
  • Gli obiettivi della sessione compaiono nel piè di pagina e possono essere gestiti con /goal.

Esempi

Ciclo di riparazione della configurazione

Usa la modalità locale per consentire all’agente incorporato di esaminare la configurazione corrente, confrontarla con la documentazione e aiutarti a correggerla dallo stesso terminale. Se openclaw config validate non riesce già, esegui prima openclaw configure o openclaw doctor --fix; openclaw chat non ignora il controllo che impedisce l’uso di una configurazione non valida.
Quindi, all’interno della TUI:
Applica correzioni mirate con openclaw config set o openclaw configure, quindi esegui nuovamente openclaw config validate. Consulta TUI e Configurazione.

Argomenti correlati