Skip to main content

​
openclaw completion

셸 자동 완성 스크립트를 생성하고 OpenClaw 상태 디렉터리에 캐시하며, 선택적으로 셸 프로필에 설치합니다.

​
사용법

​
옵션

  • -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 ...) 줄을 캐시된 스크립트를 불러오는 줄로 교체합니다.

​
참고 사항

  • --install 또는 --write-state를 사용하지 않으면 명령이 스크립트를 stdout에 출력합니다.
  • 자동 완성 생성 시 Plugin CLI 명령을 포함한 전체 명령 트리를 즉시 로드하므로 중첩된 하위 명령도 포함됩니다.
  • openclaw update는 업데이트가 성공하면 자동 완성 캐시를 자동으로 새로 고칩니다. openclaw doctor는 누락되거나 오래된 자동 완성 설정을 복구할 수 있습니다.

​
관련 항목