> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 完成

# `openclaw completion`

生成 shell 补全脚本，将其缓存在 OpenClaw 状态目录下，并可选择安装到你的 shell 配置文件中。

## 用法

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 目标（`zsh`、`bash`、`powershell`、`fish`；默认：`zsh`）
* `-i, --install`：通过向你的 shell 配置文件添加缓存脚本的 source 行来安装补全
* `--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 ...)` 行替换为缓存 source 行：

| 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。
* 补全生成会预先加载完整命令树，包括插件 CLI 命令，因此会包含嵌套子命令。
* `openclaw update` 会在成功更新后自动刷新补全缓存；`openclaw doctor` 可以修复缺失或过期的补全设置。

## 相关

* [CLI 参考](/zh-CN/cli)