Vai al contenuto principale

​
openclaw tui

Apri la UI da terminale connessa al Gateway oppure eseguila in modalità integrata locale. Correlati:
  • Guida TUI: TUI

​
Opzioni

FlagPredefinitoDescrizione
--localfalseEsegui sul runtime dell’agente integrato locale invece che su un Gateway.
--url <url>gateway.remote.url dalla configurazioneURL WebSocket del Gateway.
--token <token>(nessuno)Token del Gateway se richiesto.
--password <pass>(nessuno)Password del Gateway se richiesta.
--session <key>main (o global quando l’ambito è globale)Chiave di sessione. Dentro un workspace dell’agente seleziona automaticamente quell’agente, salvo prefisso esplicito.
--deliverfalseRecapita le risposte dell’assistente tramite i canali configurati.
--thinking <level>(predefinito del modello)Override del livello di ragionamento.
--message <text>(nessuno)Invia un messaggio iniziale dopo la connessione.
--timeout-ms <ms>agents.defaults.timeoutSecondsTimeout dell’agente. I valori non validi registrano un avviso e vengono ignorati.
--history-limit <n>200Voci della cronologia da caricare all’aggancio.
Alias: openclaw chat e openclaw terminal invocano lo stesso comando con --local implicito. Note:
  • chat e terminal sono alias per openclaw tui --local.
  • --local non può essere combinato con --url, --token o --password.
  • tui risolve le SecretRefs di autenticazione Gateway configurate per l’autenticazione tramite token/password quando possibile (provider env/file/exec).
  • Quando viene avviata dall’interno di una directory workspace dell’agente configurata, TUI seleziona automaticamente quell’agente come valore predefinito della chiave di sessione (salvo che --session sia esplicitamente agent:<id>:...).
  • Per mostrare il nome host del Gateway nel footer per connessioni non locali basate su URL, esegui openclaw config set tui.footer.showRemoteHost true. L’etichetta host è disattivata per impostazione predefinita e non appare mai per connessioni local loopback o locali integrate.
  • La modalità locale usa direttamente il runtime dell’agente integrato. La maggior parte degli strumenti locali funziona, ma le funzionalità disponibili solo tramite Gateway non sono disponibili.
  • La modalità locale aggiunge /auth [provider] alla superficie dei comandi TUI.
  • I gate di approvazione dei Plugin si applicano comunque in modalità locale. Gli strumenti che richiedono approvazione chiedono una decisione nel terminale; nulla viene approvato automaticamente in silenzio solo perché il Gateway non è coinvolto.
  • Gli obiettivi della sessione appaiono nel footer e possono essere gestiti con /goal.

​
Esempi

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

​
Ciclo di riparazione della configurazione

Usa la modalità locale quando la configurazione corrente è già valida e vuoi che l’agente integrato la ispezioni, la confronti con la documentazione e aiuti a ripararla dallo stesso terminale: Se openclaw config validate sta già fallendo, usa prima openclaw configure o openclaw doctor --fix. openclaw chat non aggira la protezione contro la configurazione non valida. 
openclaw chat
Poi dentro la TUI: 
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
Applica correzioni mirate con openclaw config set o openclaw configure, poi riesegui openclaw config validate. Vedi TUI e Configurazione.

​
Correlati