CLI commands

Vervollständigung

openclaw completion

Generieren Sie Shell-Vervollständigungsskripte, speichern Sie diese im OpenClaw-Zustand zwischen und installieren Sie sie optional in Ihrem Shell-Profil.

Verwendung

bash
openclaw completion                          # zsh-Skript auf stdout ausgebenopenclaw completion --shell fish             # fish-Skript ausgebenopenclaw completion --write-state            # Skripte für alle Shells zwischenspeichernopenclaw completion --write-state --install  # zwischenspeichern und anschließend in einem Schritt installierenopenclaw completion --shell bash --write-state

Optionen

  • -s, --shell <shell>: Ziel-Shell (zsh, bash, powershell, fish; Standard: zsh)
  • -i, --install: Vervollständigung installieren, indem dem Shell-Profil eine Source-Zeile für das zwischengespeicherte Skript hinzugefügt wird
  • --write-state: Vervollständigungsskript(e) nach $OPENCLAW_STATE_DIR/completions schreiben (Standard: ~/.openclaw/completions), ohne sie auf stdout auszugeben; mit --shell wird nur das Skript für diese Shell geschrieben, andernfalls für alle vier
  • -y, --yes: Bestätigungsaufforderungen bei der Installation überspringen (nicht interaktiv)

Installationsablauf

--install verweist Ihr Profil auf das zwischengespeicherte Skript. Daher muss der Cache zuerst vorhanden sein: Fehlt er, schlägt der Befehl fehl und fordert Sie auf, openclaw completion --write-state auszuführen. Kombinieren Sie --write-state --install, um beides in einem Schritt auszuführen. Ohne --shell erkennt --install die Shell anhand von $SHELL (mit zsh als Fallback).

Die Installation schreibt einen kleinen Block # OpenClaw Completion in Ihr Shell-Profil und ersetzt alle älteren langsamen Zeilen des Musters source <(openclaw completion ...) durch die zwischengespeicherte Source-Zeile:

Shell Profil
bash ~/.bashrc (verwendet ~/.bash_profile als Fallback, wenn ~/.bashrc fehlt)
fish ~/.config/fish/config.fish
powershell ~/.config/powershell/Microsoft.PowerShell_profile.ps1 (unter Windows: Documents/PowerShell/Microsoft.PowerShell_profile.ps1 oder Documents/WindowsPowerShell/... für Windows PowerShell)
zsh ~/.zshrc

Hinweise

  • Ohne --install oder --write-state gibt der Befehl das Skript auf stdout aus.
  • Bei der Generierung der Vervollständigung wird der vollständige Befehlsbaum einschließlich der CLI-Befehle von Plugins vorab geladen, sodass verschachtelte Unterbefehle enthalten sind.
  • openclaw update aktualisiert den Vervollständigungs-Cache nach einer erfolgreichen Aktualisierung automatisch; openclaw doctor kann fehlende oder veraltete Vervollständigungskonfigurationen reparieren.

Verwandte Themen

Was this useful?
On this page

On this page