openclaw completion

Generate shell completion scripts, cache them under OpenClaw state, and optionally install them into your shell profile.

Usage

openclaw completion                          # print zsh script to stdoutopenclaw completion --shell fish             # print fish scriptopenclaw completion --write-state            # cache scripts for all shellsopenclaw completion --write-state --install  # cache, then install in one stepopenclaw completion --shell bash --write-state

Options

• -s, --shell <shell>: shell target (zsh, bash, powershell, fish; default: zsh)
• -i, --install: install completion by adding a source line for the cached script to your shell profile
• --write-state: write completion script(s) to $OPENCLAW_STATE_DIR/completions (default ~/.openclaw/completions) without printing to stdout; with --shell writes only that shell, otherwise all four
• -y, --yes: skip install confirmation prompts (non-interactive)

Install flow

--install points your profile at the cached script, so the cache must exist first: if it is missing, the command fails and tells you to run openclaw completion --write-state. Combine --write-state --install to do both in one step. Without --shell, --install detects the shell from $SHELL (falling back to zsh).

The install writes a small # OpenClaw Completion block into your shell profile and replaces any older slow source <(openclaw completion ...) lines with the cached source line:

Notes

• Without --install or --write-state, the command prints the script to stdout.
• Completion generation eagerly loads the full command tree, including plugin CLI commands, so nested subcommands are included.
• openclaw update refreshes the completion cache automatically after a successful update; openclaw doctor can repair missing or stale completion setups.

Related

• CLI reference