CLI commands

Finalización

openclaw completion

Genera scripts de autocompletado para el shell, los almacena en caché en el estado de OpenClaw y, opcionalmente, los instala en el perfil de tu shell.

Uso

bash
openclaw completion                          # imprimir el script de zsh en stdoutopenclaw completion --shell fish             # imprimir el script de fishopenclaw completion --write-state            # almacenar en caché los scripts de todos los shellsopenclaw completion --write-state --install  # almacenar en caché e instalar en un solo pasoopenclaw completion --shell bash --write-state

Opciones

  • -s, --shell <shell>: shell de destino (zsh, bash, powershell, fish; valor predeterminado: zsh)
  • -i, --install: instala el autocompletado añadiendo al perfil de tu shell una línea que carga el script almacenado en caché
  • --write-state: escribe los scripts de autocompletado en $OPENCLAW_STATE_DIR/completions (valor predeterminado: ~/.openclaw/completions) sin imprimirlos en stdout; con --shell, solo escribe el del shell indicado; de lo contrario, escribe los de los cuatro
  • -y, --yes: omite las solicitudes de confirmación de instalación (modo no interactivo)

Flujo de instalación

--install configura tu perfil para que cargue el script almacenado en caché, por lo que la caché debe existir primero: si no existe, el comando falla y te indica que ejecutes openclaw completion --write-state. Combina --write-state --install para realizar ambas acciones en un solo paso. Sin --shell, --install detecta el shell mediante $SHELL (y utiliza zsh como alternativa).

La instalación escribe un pequeño bloque # OpenClaw Completion en el perfil de tu shell y sustituye cualquier línea antigua y lenta source <(openclaw completion ...) por la línea que carga el script almacenado en caché:

Shell Perfil
bash ~/.bashrc (utiliza ~/.bash_profile como alternativa cuando no existe ~/.bashrc)
fish ~/.config/fish/config.fish
powershell ~/.config/powershell/Microsoft.PowerShell_profile.ps1 (en Windows: Documents/PowerShell/Microsoft.PowerShell_profile.ps1, o Documents/WindowsPowerShell/... para Windows PowerShell)
zsh ~/.zshrc

Notas

  • Sin --install ni --write-state, el comando imprime el script en stdout.
  • La generación del autocompletado carga de inmediato todo el árbol de comandos, incluidos los comandos de la CLI de los plugins, por lo que se incluyen los subcomandos anidados.
  • openclaw update actualiza automáticamente la caché de autocompletado después de una actualización correcta; openclaw doctor puede reparar configuraciones de autocompletado ausentes u obsoletas.

Contenido relacionado

Was this useful?
On this page

On this page