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 可修復遺失或過期的自動完成設定。

相關內容

• 命令列介面參考