CLI commands

Completamento

openclaw completion

Genera script di completamento per la shell, li memorizza nella cache dello stato di OpenClaw e, facoltativamente, li installa nel profilo della shell.

Utilizzo

bash
openclaw completion                          # stampa lo script zsh sullo standard outputopenclaw completion --shell fish             # stampa lo script fishopenclaw completion --write-state            # memorizza nella cache gli script per tutte le shellopenclaw completion --write-state --install  # memorizza nella cache, quindi installa in un solo passaggioopenclaw completion --shell bash --write-state

Opzioni

  • -s, --shell <shell>: shell di destinazione (zsh, bash, powershell, fish; predefinita: zsh)
  • -i, --install: installa il completamento aggiungendo al profilo della shell una riga che carica lo script memorizzato nella cache
  • --write-state: scrive gli script di completamento in $OPENCLAW_STATE_DIR/completions (valore predefinito: ~/.openclaw/completions) senza stamparli sullo standard output; con --shell scrive solo quello per la shell specificata, altrimenti tutti e quattro
  • -y, --yes: ignora le richieste di conferma dell'installazione (modalità non interattiva)

Flusso di installazione

--install configura il profilo affinché utilizzi lo script memorizzato nella cache, quindi la cache deve già esistere: se manca, il comando non riesce e indica di eseguire openclaw completion --write-state. Combina --write-state --install per eseguire entrambe le operazioni in un solo passaggio. Senza --shell, --install rileva la shell da $SHELL (con ripiego su zsh).

L'installazione scrive un piccolo blocco # OpenClaw Completion nel profilo della shell e sostituisce eventuali righe obsolete e lente source <(openclaw completion ...) con la riga che carica lo script memorizzato nella cache:

Shell Profilo
bash ~/.bashrc (utilizza ~/.bash_profile come ripiego quando ~/.bashrc non è presente)
fish ~/.config/fish/config.fish
powershell ~/.config/powershell/Microsoft.PowerShell_profile.ps1 (su Windows: Documents/PowerShell/Microsoft.PowerShell_profile.ps1, oppure Documents/WindowsPowerShell/... per Windows PowerShell)
zsh ~/.zshrc

Note

  • Senza --install o --write-state, il comando stampa lo script sullo standard output.
  • La generazione del completamento carica immediatamente l'intero albero dei comandi, inclusi i comandi CLI dei Plugin, quindi sono inclusi anche i sottocomandi annidati.
  • openclaw update aggiorna automaticamente la cache del completamento dopo un aggiornamento riuscito; openclaw doctor può riparare configurazioni di completamento mancanti o obsolete.

Contenuti correlati

Was this useful?
On this page

On this page