openclaw completion
產生 shell 補全指令碼,將其快取到 OpenClaw 狀態底下,並可選擇安裝到你的 shell 設定檔中。
用法
選項
-s, --shell <shell>:shell 目標(zsh、bash、powershell、fish;預設: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可以修復缺少或過時的補全設定。