CLI commands
완료
openclaw completion
셸 자동 완성 스크립트를 생성하고 OpenClaw 상태 디렉터리에 캐시하며, 선택적으로 셸 프로필에 설치합니다.
사용법
openclaw completion # zsh 스크립트를 stdout에 출력openclaw completion --shell fish # fish 스크립트 출력openclaw completion --write-state # 모든 셸의 스크립트 캐시openclaw completion --write-state --install # 한 단계로 캐시한 후 설치openclaw completion --shell bash --write-state옵션
-s, --shell <shell>: 대상 셸(zsh,bash,powershell,fish; 기본값:zsh)-i, --install: 캐시된 스크립트를 불러오는 줄을 셸 프로필에 추가하여 자동 완성을 설치--write-state: stdout에 출력하지 않고 자동 완성 스크립트를$OPENCLAW_STATE_DIR/completions(기본값~/.openclaw/completions)에 기록합니다.--shell을 사용하면 해당 셸만 기록하고, 사용하지 않으면 네 가지 셸을 모두 기록합니다.-y, --yes: 설치 확인 프롬프트 건너뛰기(비대화형)
설치 흐름
--install은 프로필이 캐시된 스크립트를 가리키도록 하므로 캐시가 먼저 존재해야 합니다. 캐시가 없으면 명령이 실패하고 openclaw completion --write-state를 실행하라는 메시지가 표시됩니다. --write-state --install을 함께 사용하면 두 작업을 한 단계로 수행할 수 있습니다. --shell을 사용하지 않으면 --install은 $SHELL에서 셸을 감지하며, 감지하지 못하면 zsh를 사용합니다.
설치 시 셸 프로필에 작은 # OpenClaw Completion 블록을 작성하고, 기존의 느린 source <(openclaw completion ...) 줄을 캐시된 스크립트를 불러오는 줄로 교체합니다.
| 셸 | 프로필 |
|---|---|
| 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에 출력합니다.- 자동 완성 생성 시 Plugin CLI 명령을 포함한 전체 명령 트리를 즉시 로드하므로 중첩된 하위 명령도 포함됩니다.
openclaw update는 업데이트가 성공하면 자동 완성 캐시를 자동으로 새로 고칩니다.openclaw doctor는 누락되거나 오래된 자동 완성 설정을 복구할 수 있습니다.
관련 항목
Was this useful?
