🔧 수동 단계별 제거

한 클릭 제거가 불가능할 때 (예: CLI가 손상됨), 다음 단계들을 수동으로 따르세요. 순서가 중요해요. 먼저 서비스를 중지하고, 파일을 삭제한 후, 마지막에 도구를 제거합니다.

1단계: Gateway 서비스 중지

먼저 백그라운드에서 실행 중인 Gateway 서비스를 중지했는지 확인하세요:

openclaw gateway stop

openclaw 명령어가 이미 작동하지 않는다면, 이 단계를 건너뛰고 시스템 명령어로 강제 중지하세요 (해당 시스템의 전용 정리 페이지 참고).

부팅 시 자동 시작 설정을 제거해서 재시작 후 서비스가 다시 나타나지 않도록 하세요:

openclaw gateway uninstall

마찬가지로 CLI를 사용할 수 없으면 수동으로 진행해야 합니다. macOS는 launchd 정리, Linux는 systemd 정리, Windows는 계획된 작업 정리. 각 시스템 전용 페이지를 참고하세요.

OpenClaw의 모든 설정 파일, 채팅 기록, 실행 상태는 상태 디렉토리에 저장됩니다:

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

OPENCLAW_STATE_DIR 환경 변수를 사용자 정의했다면, 실제 경로를 확인해야 합니다. 기본값은 ~/.openclaw입니다.

⚠️ 이 단계는 되돌릴 수 없습니다! 모든 채팅 기록과 사용자 설정이 삭제됩니다. 나중에 필요할 수도 있다면, 먼저 전체 ~/.openclaw 디렉토리를 백업하세요. 백업에 대한 자세한 정보는 주의사항을 참고하세요.

3단계에서 이미 전체 .openclaw 디렉토리를 삭제했다면, 이 단계를 건너뛸 수 있습니다. 아니면 작업 공간을 따로 정리하세요:

rm -rf ~/.openclaw/workspace

처음 OpenClaw를 설치한 방식에 따라 해당하는 제거 명령어를 선택하세요:

npm rm -g openclaw

pnpm remove -g openclaw

bun remove -g openclaw

# CLI 버전
brew uninstall openclaw-cli

# 데스크톱 앱 버전
brew uninstall --cask openclaw

소스 코드에서 설치했다면, 먼저 앞의 서비스 중지와 제거 단계를 완료한 후, 소스 코드 디렉토리를 그냥 삭제하면 됩니다. 반드시 서비스를 먼저 중지한 후 디렉토리를 삭제하세요. 아니면 서비스가 이미 삭제된 경로를 참고하려다가 에러가 발생할 수 있습니다.

사용자 정의 Profile을 사용했다면 (예: 직장용, 개인용), 각 Profile마다 독립적인 상태 디렉토리가 있으니 하나씩 삭제해야 합니다:

# 모든 openclaw 관련 profile 디렉토리 삭제
rm -rf ~/.openclaw
rm -rf ~/.openclaw-*

💡 Profile이 몇 개인지 확실하지 않나요? ls -la ~ | grep openclaw를 실행해 보면 알 수 있습니다.