⚡ 공식 한 클릭 제거
openclaw 명령어가 정상적으로 작동하면, 이게 가장 간단하고 권장되는 제거 방식입니다.
대화형 제거 (권장)
터미널을 열고 다음 명령어를 입력하세요:
openclaw uninstall시스템이 단계별로 뭘 삭제할지 물어봐요. Gateway 서비스, 설정 파일, 작업 공간 등요. 프롬프트에 따라 각 항목을 확인하면 되니까 실수로 삭제할 걱정은 없습니다.
대화형 제거의 좋은 점은 특정 데이터를 선택적으로 보관할 수 있다는 거예요 (예: 채팅 기록). 서비스와 CLI만 삭제할 수 있습니다.
비대화형 제거 (자동화 시나리오)
스크립트, CI/CD, 자동화 프로세스에서 조용히 제거해야 한다면:
openclaw uninstall --all --yes --non-interactiveopenclaw를 전역으로 설치하지 않았다면, npx로 임시로 호출할 수 있습니다:
npx -y openclaw uninstall --all --yes --non-interactive--all 옵션은 설정 파일, 채팅 기록, 작업 공간을 포함한 모든 데이터를 삭제합니다. 실행하기 전에 이 데이터들이 필요 없거나 이미 백업했는지 확인하세요.
한 클릭 제거가 하는 일이 뭐예요?
이 명령어는 자동으로 다음 작업들을 수행합니다:
- Gateway 서비스 중지 — 백그라운드에서 실행 중인 게이트웨이 프로세스를 종료합니다.
- 서비스 데몬 제거 — 부팅 시 자동 시작 설정을 삭제합니다 (launchd / systemd / 계획된 작업)
- 상태 및 설정 정리 —
~/.openclaw디렉토리의 설정 파일을 삭제합니다. - 작업 공간 삭제 — AI가 만든 작업 공간 파일을 제거합니다.
- CLI 제거 — 전역 패키지 관리자에서 openclaw 명령어를 제거합니다.
한 클릭 제거가 대부분의 정리 작업을 다루지만, 제거 후 깊은 정리 확인을 한 번 더 진행하길 권합니다. 좋은 습관을 들이는 거죠.
한 클릭 제거가 실패했다면?
다음과 같은 경우에 한 클릭 제거가 제대로 작동하지 않을 수 있어요:
- CLI 도구가 손상되었거나 수동으로 삭제됨
- 권한이 부족함 (특히 시스템 레벨 설치의 경우)
- 환경 변수가 수정되어 설치 경로를 찾을 수 없음
걱정하지 마세요. 이 경우 수동 제거 튜토리얼로 이동해서 단계별로 진행하면 됩니다.