OpenClaw를 완전히 삭제하는 방법

새로운 툴을 설치해서 테스트하다 보면 다시 지워야 할 때가 있죠. 그런데 단순히 실행 파일만 삭제하면 백그라운드에서 서비스가 계속 돌아가거나 설정 파일이 남아서 시스템이 지저분해지기도 해요.

OpenClaw를 깔끔하게 지우고 싶은데 어디서부터 손을 대야 할지 고민인 개발자분들을 위해, 서비스 중지부터 잔여 파일 제거까지 모든 단계를 정리했습니다.

필요한 것

• OpenClaw가 설치된 시스템 (CLI가 설치되어 있거나 서비스가 실행 중인 상태)
• 터미널(Terminal) 또는 PowerShell 실행 권한
• (선택 사항) 설치 시 사용했던 패키지 매니저 (npm, pnpm, bun)

빠른 시작

가장 권장하는 방법은 내장된 언인스톨러를 사용하는 거예요. 5분도 걸리지 않습니다.

openclaw uninstall

만약 자동화 스크립트나 npx를 사용 중이라 대화형 프롬프트를 건너뛰고 싶다면 아래 명령어를 사용하세요.

openclaw uninstall --all --yes --non-interactive
# 또는
npx -y openclaw uninstall --all --yes --non-interactive

상세 제거 단계 (Easy Path)

CLI가 아직 설치되어 있다면 위 명령어로 충분하지만, 수동으로 하나씩 확인하며 지우고 싶다면 다음 순서를 따르세요.

1. 서비스 중지 및 제거

먼저 실행 중인 Gateway 서비스를 멈추고 시스템 등록을 해제해야 합니다.

openclaw gateway stop
openclaw gateway uninstall

2. 상태 및 설정 파일 삭제

기본적으로 ~/.openclaw 디렉토리에 모든 설정이 저장됩니다. 이 폴더를 삭제하세요.

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

참고: OPENCLAW_CONFIG_PATH를 별도로 지정했다면 해당 파일도 직접 지워야 합니다.

3. 워크스페이스 및 CLI 삭제

에이전트 파일이 담긴 워크스페이스를 지우고(선택 사항), 설치 방식에 맞춰 CLI를 제거하세요.

# 워크스페이스 삭제
rm -rf ~/.openclaw/workspace

# 패키지 매니저에 따른 삭제
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw

macOS 앱으로 설치했다면 /Applications/OpenClaw.app 경로의 파일을 삭제하면 됩니다.

문제 해결

CLI를 이미 지웠는데 서비스가 계속 실행되나요?

명령어는 없는데 Gateway가 백그라운드에서 돌고 있다면 OS별로 직접 서비스를 제거해야 합니다.

macOS (launchd)

launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

Linux (systemd)

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Windows (Scheduled Task)

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

프로필(Profile)을 사용했나요?

--profile 옵션을 사용했다면 각 프로필마다 상태 디렉토리가 따로 생성됩니다(예: ~/.openclaw-<profile>). 이 디렉토리들도 각각 삭제해야 완전히 제거됩니다.

소스 코드에서 직접 설치(git clone)했나요?

레포지토리를 지우기 전에 반드시 위에서 설명한 openclaw gateway uninstall을 먼저 실행하세요. 그 다음 레포지토리 폴더와 상태 디렉토리를 삭제하면 됩니다.

---

삭제 과정에서 예상치 못한 문제가 발생하면 AI Setup Assistant에게 물어보세요.

다음 단계

• 설치 가이드 바로가기
• Gateway 설정 확인하기