跳轉到主要內容

openclaw completion

產生 shell 補全指令碼,將其快取到 OpenClaw 狀態底下,並可選擇安裝到你的 shell 設定檔中。

用法

openclaw completion                          # print zsh script to stdout
openclaw completion --shell fish             # print fish script
openclaw completion --write-state            # cache scripts for all shells
openclaw completion --write-state --install  # cache, then install in one step
openclaw completion --shell bash --write-state

選項

  • -s, --shell <shell>:shell 目標(zshbashpowershellfish;預設:zsh
  • -i, --install:透過將快取指令碼的 source 行加入你的 shell 設定檔來安裝補全
  • --write-state:將補全指令碼寫入 $OPENCLAW_STATE_DIR/completions(預設 ~/.openclaw/completions),且不輸出到 stdout;搭配 --shell 時只寫入該 shell,否則寫入全部四種
  • -y, --yes:略過安裝確認提示(非互動式)

安裝流程

--install 會讓你的設定檔指向快取指令碼,因此快取必須先存在:如果缺少快取,命令會失敗並提示你執行 openclaw completion --write-state。合併使用 --write-state --install 可在一個步驟中完成兩者。不使用 --shell 時,--install 會從 $SHELL 偵測 shell(退回使用 zsh)。 安裝會將一小段 # OpenClaw Completion 區塊寫入你的 shell 設定檔,並用快取來源行取代任何較舊且緩慢的 source <(openclaw completion ...) 行:
Shell設定檔
bash~/.bashrc(缺少 ~/.bashrc 時退回使用 ~/.bash_profile
fish~/.config/fish/config.fish
powershell~/.config/powershell/Microsoft.PowerShell_profile.ps1(在 Windows 上:Documents/PowerShell/Microsoft.PowerShell_profile.ps1,或 Windows PowerShell 使用 Documents/WindowsPowerShell/...
zsh~/.zshrc

備註

  • 不使用 --install--write-state 時,此命令會將指令碼輸出到 stdout。
  • 產生補全時會預先載入完整命令樹,包括外掛命令列介面命令,因此會包含巢狀子命令。
  • openclaw update 會在成功更新後自動重新整理補全快取;openclaw doctor 可以修復缺少或過時的補全設定。

相關