openclaw completion

產生 Shell 自動補全指令碼、將其快取至 OpenClaw 狀態目錄，並可選擇安裝至你的 Shell 設定檔。

用法

openclaw completion                          # 將 zsh 指令碼輸出至標準輸出openclaw completion --shell fish             # 輸出 fish 指令碼openclaw completion --write-state            # 快取所有 Shell 的指令碼openclaw completion --write-state --install  # 快取後一次完成安裝openclaw completion --shell bash --write-state

選項

• -s, --shell <shell>：目標 Shell（zsh、bash、powershell、fish；預設：zsh）
• -i, --install：在你的 Shell 設定檔中加入載入快取指令碼的來源行，以安裝自動補全
• --write-state：將自動補全指令碼寫入 $OPENCLAW_STATE_DIR/completions（預設為 ~/.openclaw/completions），而不輸出至標準輸出；搭配 --shell 時只寫入該 Shell，否則寫入全部四種 Shell
• -y, --yes：略過安裝確認提示（非互動式）

安裝流程

--install 會讓你的設定檔指向快取的指令碼，因此快取必須先存在：若不存在，命令會失敗並提示你執行 openclaw completion --write-state。搭配 --write-state --install 可一次完成兩者。未指定 --shell 時，--install 會從 $SHELL 偵測 Shell（偵測失敗時使用 zsh）。

安裝程序會將一小段 # OpenClaw Completion 區塊寫入你的 Shell 設定檔，並以快取來源行取代任何較舊且緩慢的 source <(openclaw completion ...) 行：

注意事項

• 未指定 --install 或 --write-state 時，命令會將指令碼輸出至標準輸出。
• 產生自動補全時會立即載入完整的命令樹，包括外掛的命令列介面命令，因此也會包含巢狀子命令。
• openclaw update 會在成功更新後自動重新整理自動補全快取；openclaw doctor 可修復缺失或過期的自動補全設定。

相關內容

• 命令列介面參考