⚠️ 실행 전 필수 체크
- 제거할 게 openclaw뿐인가요, Node/Git도 지울 건가요?
~/.claude,~/.claude.json는 절대 건드리지 않습니다 (다른 도구)- 진행 중이던 다른 프로젝트가 있나요? 있으면 먼저 백업
- 명령어는 한 줄씩 실행하고 결과를 확인합니다
🍎 Step 1. 현재 상태 확인
뭐가 깔려있는지 먼저 봅니다.
which openclaw
ls -la ~/.openclaw 2>/dev/null && echo "→ .openclaw 존재" || echo "→ 이미 없음"
npm ls -g --depth=0 2>/dev/null | grep -iE "openclaw|clawhub"
🍎 Step 2. openclaw 제거
글로벌 패키지와 설정 폴더만 제거합니다. Node / brew / nvm 은 건드리지 않습니다.
npm uninstall -g openclaw clawhub
rm -rf ~/.openclaw
🍎 Step 3. 제거 확인
which openclaw
openclaw --version 2>/dev/null || echo "✅ 제거 완료"
✅ 성공:
which openclaw 에서 아무것도 안 나오면 OK
🍎 재설치
npm install -g openclaw
openclaw onboard
🛑 절대 건드리지 마세요:
~/.claude, ~/.claude.json, ~/.nvm, brew — 다른 작업용 환경이 날아갑니다.
Windows는 PowerShell 네이티브 레이어와 WSL2 Ubuntu 내부 레이어 2곳 모두에 설치되어 있을 수 있습니다. 두 곳을 순서대로 제거합니다.
PowerShell Step 1. 현재 상태 확인
PowerShell을 관리자 권한으로 열어주세요. (Win + X → "터미널 (관리자)")
where.exe openclaw
where.exe node
where.exe git
winget list | findstr /i "node git"
PowerShell Step 2. openclaw 제거
npm uninstall -g openclaw clawhub 2>$null
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
where.exe openclaw
PowerShell Step 3. Node.js 제거
위 Step 1의 winget list 결과에서 확인된 실제 패키지 ID로 실행하세요.
winget uninstall OpenJS.NodeJS.LTS -e
# 안 되면: winget uninstall OpenJS.NodeJS -e
Remove-Item -Recurse -Force "$env:APPDATA\npm" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm-cache" -ErrorAction SilentlyContinue
winget 으로 제거가 안 되면 설정 > 앱 > 설치된 앱 에서 "Node.js" 를 찾아 수동 제거
PowerShell Step 4. Git 제거
winget uninstall Git.Git -e
Remove-Item -Force "$env:USERPROFILE\.gitconfig" -ErrorAction SilentlyContinue
PowerShell Step 5. PowerShell 레이어 확인
where.exe node
where.exe git
where.exe openclaw
✅ 성공: 셋 다 아무것도 안 나오면 OK. 터미널을 완전히 닫았다가 새로 열어야 PATH 캐시가 갱신됩니다.
WSL Step 6. WSL 제거 — Level 선택
세미나에서 "wsl --install부터 처음 보여주기"가 목적이면 Level 2를 선택하세요. WSL을 빠르게 리셋만 하려면 Level 0.
📊 Level 비교
| Level | 제거 범위 | 재부팅 | 소요 | 데모 효과 |
|---|---|---|---|---|
| 0 | 배포판 데이터만 | 불필요 | ~1분 | ⭐⭐ |
| 1 | 배포판 + WSL 앱 | 불필요 | ~5분 | ⭐⭐⭐⭐ |
| 2 | + Windows Features 비활성화 | 필수 | ~15분 | ⭐⭐⭐⭐⭐ |
⚠️ 실행 전 체크: Docker Desktop(WSL2 backend)을 쓰고 있다면 Level 1/2는 Docker도 함께 영향받습니다. 다른 WSL 배포판(Debian/Kali 등)에 작업물이 있다면 먼저 백업하세요.
Level 0 배포판만 삭제
배포판 이름은 wsl --list --verbose 결과에서 확인한 NAME 사용.
wsl --list --verbose
wsl --unregister Ubuntu
wsl --list --verbose
"설치된 배포가 없습니다" 가 나오면 이미 Level 0 완료 상태. → Level 1부터 이어서 진행하세요.
재설치
wsl --install -d Ubuntu
Level 1 배포판 + WSL 앱 제거
0. 사전 확인
현재 WSL 상태와 wsl --uninstall 지원 여부를 체크합니다.
wsl --list --verbose
wsl --help | findstr /i "uninstall"
두 번째 줄이 빈 출력이면
wsl --uninstall이 없는 버전 → winget 방식으로 제거
1. 배포판 unregister (있는 것만)
wsl --unregister Ubuntu
# 다른 배포판도 있으면 각각:
# wsl --unregister Debian
# wsl --unregister kali-linux
2. WSL 엔진 종료
wsl --shutdown
3. WSL 앱 제거 (⭐ 권장: winget)
winget uninstall Microsoft.WSL -e
또는 wsl --help에 --uninstall 옵션이 있으면 wsl --uninstall로 대체 가능.
4. 확인
wsl --version
where.exe wsl
✅ 성공:
wsl --version 에서 "인식되지 않습니다" 가 나오면 OK. 경로가 여전히 보이면 PowerShell 창을 닫고 새로 열어 다시 확인.
Level 1 재설치
wsl --install
Level 2 완전 초기화 (재부팅 필수)
"wsl --install부터 처음 보여주기" 데모를 위해 Windows Features까지 꺼서 "WSL이 한 번도 설치된 적 없는 상태"로 만듭니다.
1. Level 1의 1~4 단계 먼저 실행
배포판 unregister → WSL shutdown → winget uninstall Microsoft.WSL -e 까지 완료하세요.
2. Windows Optional Features 비활성화
dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux /norestart
dism.exe /online /disable-feature /featurename:VirtualMachinePlatform /norestart
3. 잔여 파일 제거
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Packages\CanonicalGroupLimited*" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Packages\MicrosoftCorporationII.WindowsSubsystemForLinux*" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\lxss" -ErrorAction SilentlyContinue
4. 재부팅 (필수)
Restart-Computer
🛑 재부팅 필수. Features 비활성화는 재부팅 후에 완료됩니다. 재부팅 전에는
wsl --install이 정상 동작하지 않을 수 있습니다.
✨ Level 2 재설치 — "마법의 한 줄"
wsl --install
이 한 줄이 Windows Features 자동 활성화 + WSL 앱 자동 다운로드 + Ubuntu 자동 설치까지 수행합니다. Windows 재부팅 한 번 더 요구될 수 있고, 재부팅 후 Ubuntu 터미널이 자동으로 열리면 사용자명/암호를 설정하세요. 총 10~15분 소요.
대안 Ubuntu는 남기고 내부 도구만 제거
WSL 환경은 유지하고 openclaw/Node/Git만 지우고 싶다면, PowerShell에서 wsl 입력 후 Ubuntu 터미널에서:
openclaw 제거
npm uninstall -g openclaw clawhub
rm -rf ~/.openclaw ~/.config/openclaw
Node.js 제거 — nvm 방식
nvm deactivate
nvm uninstall --lts
rm -rf ~/.nvm
sed -i '/NVM_DIR/d' ~/.bashrc
Node.js 제거 — apt 방식
sudo apt remove --purge -y nodejs npm
sudo apt autoremove -y
rm -rf ~/.npm
Git 제거
sudo apt remove --purge -y git
sudo apt autoremove -y
rm -f ~/.gitconfig
WSL 내부 확인
which node
which git
which openclaw
🆘 자주 막히는 곳
npm: command not found (Mac) → Node 자체가 없음. openclaw도 이미 없을 확률 높음 —
rm -rf ~/.openclaw 만 실행winget: 인식되지 않는 명령 → Windows 10 구버전 — "설정 > 앱" 에서 수동 제거
EACCES / Permission denied (Mac) →
sudo 쓰지 말고 nvm 경로 확인Permission denied (Windows) → 관리자 권한 PowerShell 로 재실행
where.exe openclaw 가 여전히 경로 출력 → PATH 캐시 — 터미널 완전히 닫고 새 창에서 다시 확인
WSL 에서 apt 가 느림 →
sudo apt update 부터 먼저 실행📥 재설치 흐름
- Mac:
npm install -g openclaw→openclaw onboard→openclaw --version - Windows: WSL2 + Ubuntu + nvm + Node LTS + openclaw
자세한 설치 흐름은 → nupik.kr/install
📞 도움이 필요할 때
보충수업 중: 손 들기 🙋
세미나 후: #ai_native_education 슬랙 채널
긴급: 앤드류(강사)에게 DM