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 配置文件添加缓存脚本的 source 行，以安装补全功能
• --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）。

安装过程会在你的 shell 配置文件中写入一个简短的 # OpenClaw Completion 块，并将所有较旧且缓慢的 source <(openclaw completion ...) 行替换为引用缓存的 source 行：

说明

• 未使用 --install 或 --write-state 时，该命令会将脚本输出到标准输出。
• 生成补全脚本时会立即加载完整的命令树，包括插件 CLI 命令，因此也会包含嵌套子命令。
• openclaw update 会在成功更新后自动刷新补全缓存；openclaw doctor 可以修复缺失或过期的补全设置。

相关内容

• CLI 参考