OpenClaw를 더 이상 사용하지 않으시나요? 아니면 보안 우려로 인해 깔끔하게 제거하고 싶으신가요? 🤔 단순히 앱을 삭제하거나 npm uninstall을 실행하는 것만으로는 충분하지 않습니다. OpenClaw는 시스템 깊숙이 통합된 백그라운드 서비스와 외부 서비스에 연결된 장기 유효 토큰을 사용하기 때문에, 완전한 삭제를 위해서는 몇 가지 중요한 단계를 거쳐야 합니다.
이 가이드에서는 2026년 최신 OpenClaw v2026.4.x 기준으로, macOS, Windows, Linux 모든 플랫폼에서 명령어 중심으로 백그라운드 서비스, 설정 파일, 작업 공간 데이터, 그리고 가장 중요한 외부 OAuth 토큰까지 완벽하게 정리하는 방법을 상세히 설명합니다. 커뮤니티에서 실제로 보고된 문제점과 해결책도 함께 다뤘으니, 안심하고 따라하실 수 있습니다.
~/.openclaw 디렉토리가 제거되면 작업 공간 데이터, 대화 기록, 설정 파일이 영구적으로 삭제됩니다. 중요한 데이터가 있다면 반드시 openclaw backup create 명령어로 백업을 먼저 진행하세요.
📋 이 글의 목차
1️⃣ 왜 OpenClaw 삭제는 일반적인 앱과 다를까? 🤔
OpenClaw는 단순한 데스크톱 애플리케이션이 아닙니다. 로컬에서 실행되는 자율 에이전트 플랫폼으로, 시스템과 깊게 통합되어 작동합니다.
🔍 OpenClaw의 아키텍처 이해하기
| 컴포넌트 | 역할 | 삭제 시 주의점 |
|---|---|---|
openclaw CLI |
사용자 명령 인터페이스 | npm uninstall -g로 제거 가능 |
Gateway Service |
백그라운드에서 에이전트 실행 | LaunchAgent/systemd/schtasks 등록 해제 필요 |
~/.openclaw/state |
세션 데이터, 캐시, 작업 큐 | 개인 정보 포함, 완전 삭제 권장 |
~/.openclaw/workspaces |
사용자 작업 공간 및 프로젝트 | 데이터 손실 위험, 백업 필수 |
OAuth Tokens |
Google, Slack 등 외부 서비스 접근 권한 | 로컬 삭제와 무관, 별도 취소 필수 |
openclaw gateway 서비스는 재부팅 후에도 자동으로 재시작됩니다. 이 서비스가 메모리에 상주하는 한, 계정 연결과 데이터 접근 권한은 유지됩니다.
📊 삭제 실패 시 발생할 수 있는 보안 리스크
- 백그라운드 프로세스가 메모리에서 계속 실행됨
- OAuth 토큰이 유효하여 외부 서비스 접근 가능
- 설정 파일에 저장된 API 키가 유출될 위험
- 레거시 디렉토리(
~/.clawdbot,~/.moltbot)가 남아 보안 취약점 발생
보안 연구원들은 실제로 수백 개의 노출된 OpenClaw 인스턴스에서 유효한 OAuth 토큰과 API 키가 발견된 사례를 문서화했습니다. 따라서 "더 이상 사용하지 않는다"는 이유만으로 방치하는 것은 심각한 보안 위험이 될 수 있습니다.
2️⃣ 🚀 빠른 삭제: 명령어 하나로 기본 정리
가장 먼저 시도해볼 수 있는 방법은 OpenClaw에 내장된 공식 제거 명령어를 사용하는 것입니다. 이 명령어는 기본 서비스 정리와 상태 파일 삭제를 자동으로 처리합니다.
openclaw uninstall --all --yes --non-interactive
# 옵션 설명:
# --all : 서비스, 상태, 작업공간, 앱 모두 제거
# --yes : 확인 프롬프트 자동 승인
# --non-interactive : 대화형 입력 비활성화 (스크립트용)
# 더 안전한 접근 (단계별 확인):
openclaw uninstall --service --state --yes
✅ 이 명령어가 처리하는 작업
macOS의 LaunchAgent, Linux의 systemd, Windows의 Task Scheduler에서 서비스를 제거합니다.
~/.openclaw/state의 세션 데이터, 캐시, 작업 큐를 제거합니다.
시스템 PATH에서
openclaw 명령어를 삭제합니다 (npm으로 설치한 경우).
openclaw backup create 명령어로 스냅샷을 생성하세요. 나중에 openclaw backup restore로 복구 가능합니다.
❌ 이 명령어가 하지 않는 작업 (중요!)
- OAuth 토큰 취소: Google, Slack, Discord 등 외부 서비스의 접근 권한은 수동으로 취소해야 합니다
- 레거시 디렉토리 정리: 이전 버전인 ClawdBot(
~/.clawdbot)이나 MoltBot(~/.moltbot) 설정은 남을 수 있습니다 - npm 글로벌 패키지 제거:
npm uninstall -g openclaw를 별도로 실행해야 할 수 있습니다 - 사용자 지정 설정 경로:
OPENCLAW_CONFIG_PATH환경 변수로 지정한 경로는 수동 삭제 필요
따라서 진정으로 완전한 삭제를 위해서는 아래 플랫폼별 상세 단계를 추가로 수행해야 합니다.
3️⃣ 🍎 macOS 완전 삭제 단계별 가이드
macOS에서 OpenClaw는 LaunchAgent를 통해 로그인 시 자동 실행되도록 설정됩니다. 이 부분을 완전히 정리하는 것이 핵심입니다.
🔹 단계 1: Gateway 프로세스 강제 중지
# 1. 정상 종료 시도 (권장)
openclaw gateway stop
# 2. CLI가 이미 삭제된 경우 강제 종료
pkill -f "openclaw gateway"
# 3. 프로세스가 여전히 실행 중인지 확인
ps aux | grep -i openclaw | grep -v grep
# 출력 결과가 없어야 정상
🔹 단계 2: LaunchAgent 등록 해제 (핵심!)
LaunchAgent는 macOS가 로그인 시 자동으로 로드하는 백그라운드 작업입니다. 다음 명령어로 완전히 제거하세요:
# 현재 세션에서 서비스 언로드
launchctl bootout gui/$UID/ai.openclaw.gateway
# LaunchAgent plist 파일 삭제
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
# 레거시 레이블도 확인 (ClawdBot/MoltBot)
launchctl bootout gui/$UID/com.openclaw.gateway 2>/dev/null
launchctl bootout gui/$UID/com.clawdbot.gateway 2>/dev/null
rm -f ~/Library/LaunchAgents/com.openclaw.gateway.plist
rm -f ~/Library/LaunchAgents/com.clawdbot.gateway.plist
# 등록된 LaunchAgent 목록에서 확인
launchctl list | grep -iE "openclaw|clawdbot|moltbot"
# 아무 결과도 출력되지 않아야 성공
🔹 단계 3: 내장 제거 프로그램 실행
# 상태 파일까지 함께 삭제
openclaw uninstall --state --yes
# 작업 공간도 삭제하려면 (데이터 손실 주의!)
openclaw uninstall --workspace --yes
🔹 단계 4: 숨겨진 설정 디렉토리 완전 삭제
# 현재 및 이전 버전 설정 디렉토리 모두 삭제
rm -rf ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub
# XDG 설정 경로도 확인 (일부 설치 방식)
rm -rf ~/.config/openclaw ~/.local/share/openclaw 2>/dev/null
# 삭제 확인
ls -la ~/.openclaw ~/.clawdbot 2>&1
# "No such file or directory"가 출력되어야 정상
🔹 단계 5: CLI 패키지 제거
# npm으로 설치한 경우
npm uninstall -g openclaw
# Homebrew로 설치한 경우
brew uninstall openclaw
# pnpm 또는 bun 사용 시
pnpm remove -g openclaw
bun remove -g openclaw
🔹 단계 6: 최종 확인
# 프로세스 실행 확인
ps aux | grep -i openclaw | grep -v grep
# LaunchAgent 등록 확인
launchctl list | grep -iE "openclaw|clawdbot"
# CLI 명령어 존재 여부
which openclaw
# 설정 디렉토리 존재 여부
ls ~/.openclaw 2>/dev/null; echo "Exit code: $?"
# 모든 명령이 빈 결과 또는 오류를 반환해야 완전 삭제
4️⃣ 🪟 Windows 완전 삭제 단계별 가이드
Windows에서 OpenClaw는 Task Scheduler를 통해 백그라운드 작업을 등록합니다. 관리자 권한이 필요한 단계가 있으니 주의하세요.
🔹 단계 1: Gateway 프로세스 중지
# PowerShell 관리자 권한으로 실행
# 1. 정상 종료
openclaw gateway stop
# 2. 강제 종료 (CLI 없을 시)
Stop-Process -Name "openclaw" -Force -ErrorAction SilentlyContinue
# 3. 프로세스 확인
Get-Process | Where-Object { $_.ProcessName -match "openclaw" }
# 결과가 없어야 정상
🔹 단계 2: 예약된 작업 (Task Scheduler) 제거
# GUI 방법: 작업 스케줄러 실행 → 라이브러리 → "OpenClaw" 검색 → 삭제
# PowerShell 명령어 방법 (관리자 권한 필요)
schtasks /Delete /TN "OpenClaw Gateway" /F
schtasks /Delete /TN "ClawdBot Gateway" /F 2>$null
schtasks /Delete /TN "MoltBot Gateway" /F 2>$null
# 등록된 작업 확인
Get-ScheduledTask | Where-Object { $_.TaskName -match "openclaw|clawdbot" }
🔹 단계 3: 설정 디렉토리 삭제
# 사용자 프로필 내 설정 폴더 삭제
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"
Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot"
# AppData 내 설정도 확인
Remove-Item -Recurse -Force "$env:APPDATA\openclaw" 2>$null
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\openclaw" 2>$null
# 삭제 확인
Test-Path "$env:USERPROFILE\.openclaw"
# False 가 반환되어야 정상
🔹 단계 4: CLI 및 환경 변수 정리
# npm 글로벌 패키지 제거
npm uninstall -g openclaw
# PATH에서 openclaw 제거 확인
where openclaw
# "정보: 파일을 찾을 수 없습니다"가 출력되어야 정상
# 환경 변수 확인 및 제거
echo $env:OPENCLAW_CONFIG_PATH
# 경로가 출력되면 해당 폴더도 수동 삭제
5️⃣ 🐧 Linux 완전 삭제 단계별 가이드
Linux 환경에서는 systemd 사용자 서비스가 백그라운드 실행을 담당합니다. 배포판별 차이보다는 사용자 세션 기준 설정을 정리하는 것이 핵심입니다.
🔹 단계 1: Gateway 서비스 중지
# 정상 종료
openclaw gateway stop
# 강제 종료 (필요시)
pkill -f "openclaw gateway"
# 프로세스 확인
pgrep -a openclaw
# 출력 없어야 정상
🔹 단계 2: systemd 사용자 서비스 제거
# 서비스 비활성화 및 중지
systemctl --user disable --now openclaw-gateway.service
# 서비스 유닛 파일 삭제
rm -f ~/.config/systemd/user/openclaw-gateway.service
# systemd 데몬 리로드 (설정 반영)
systemctl --user daemon-reload
# 레거시 서비스 이름도 확인
systemctl --user disable --now clawdbot-gateway.service 2>/dev/null
rm -f ~/.config/systemd/user/clawdbot-gateway.service
systemctl --user daemon-reload
# 등록된 서비스 확인
systemctl --user list-units | grep -i openclaw
# "0 loaded units listed" 또는 관련 항목 없어야 정상
🔹 단계 3: 설정 디렉토리 정리
# 기본 설정 디렉토리 삭제
rm -rf ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub
# XDG 표준 경로도 확인
rm -rf ~/.config/openclaw ~/.local/share/openclaw 2>/dev/null
# 삭제 확인
ls ~/.openclaw ~/.clawdbot 2>&1 | grep -v "No such file"
# 아무 출력도 없어야 정상
🔹 단계 4: 패키지 관리자별 CLI 제거
# npm (가장 일반적)
npm uninstall -g openclaw
# pnpm 사용 시
pnpm remove -g openclaw
# 배포판 패키지 관리자로 설치한 경우
# Debian/Ubuntu
sudo apt remove openclaw
# Fedora/RHEL
sudo dnf remove openclaw
# Arch
sudo pacman -R openclaw
6️⃣ 🔐 OAuth 토큰 취소: 가장 중요한 단계! ⚠️
OpenClaw는 작업을 수행하기 위해 다양한 서비스에 접근 권한을 요청합니다. 이 권한은 장기 유효 토큰으로 발급되어, 명시적으로 취소하지 않는 한 영원히 유효합니다.
🔹 Google (Gmail, Calendar, Drive)
🔹 Slack
# 1. 워크스페이스 관리자 페이지 접속
https://[your-workspace].slack.com/apps/manage
# 2. "OpenClaw" 또는 "ClawdBot" 검색
# 3. 앱 클릭 → "Remove App" → 확인
# 관리자 권한이 있다면 전체 워크스페이스에서 제거:
# Settings & Administration → Manage Apps → OpenClaw → Remove
🔹 Discord
🔹 GitHub
# OAuth Apps 확인 및 취소
https://github.com/settings/applications
# 1. "Authorized OAuth Apps" 탭 클릭
# 2. "OpenClaw" 또는 "ClawdBot" 찾기
# 3. 앱 클릭 → "Revoke access" → 확인
# GitHub Apps 도 확인 (일부 버전)
https://github.com/settings/installations
# 동일한 앱 이름으로 검색하여 제거
🔹 Microsoft (Outlook, OneDrive, Teams)
🔹 Notion
7️⃣ ✅ 완전 삭제 확인 체크리스트
모든 단계를 완료했다면, 아래 체크리스트를 실행하여 정말로 모든 것이 제거되었는지 최종 확인하세요.
🔍 플랫폼별 최종 확인 명령어
########## macOS / Linux ##########
# 1. 실행 중인 프로세스 확인
ps aux | grep -iE "openclaw|clawdbot|moltbot" | grep -v grep
# → 빈 결과여야 정상
# 2. 서비스 등록 확인
# macOS
launchctl list | grep -iE "openclaw|clawdbot"
# Linux
systemctl --user list-units | grep -i openclaw
# → 빈 결과여야 정상
# 3. CLI 명령어 존재 여부
which openclaw
# → 출력 없어야 정상
# 4. 설정 디렉토리 존재 여부
ls -d ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub 2>&1
# → "No such file or directory"만 출력되어야 정상
# 5. 환경 변수 확인
echo $OPENCLAW_CONFIG_PATH
# → 경로가 출력되면 해당 폴더도 수동 삭제
########## Windows (PowerShell) ##########
# 1. 실행 중인 프로세스
Get-Process | Where-Object { $_.ProcessName -match "openclaw" }
# 2. 예약된 작업
Get-ScheduledTask | Where-Object { $_.TaskName -match "openclaw|clawdbot" }
# 3. CLI 명령어
where openclaw
# 4. 설정 폴더
Test-Path "$env:USERPROFILE\.openclaw", "$env:USERPROFILE\.clawdbot"
# → 모두 False 여야 정상
📋 최종 확인 체크리스트
- ✅ 모든 플랫폼에서 백그라운드 프로세스가 실행되지 않음
- ✅ LaunchAgent / systemd / Task Scheduler 에서 서비스 등록 해제됨
- ✅
~/.openclaw및 레거시 디렉토리가 모두 삭제됨 - ✅
openclawCLI 명령어가 PATH 에서 제거됨 - ✅ Google, Slack, Discord 등 모든 외부 서비스에서 토큰 취소됨
- ✅
OPENCLAW_CONFIG_PATH등 사용자 지정 환경 변수 정리됨
이제 시스템은 OpenClaw 와 관련된 모든 흔적에서 깨끗해졌습니다. 필요하다면 언제든지
npm install -g openclaw 로 다시 설치할 수 있습니다.
8️⃣ 🔧 자주 묻는 문제 & 해결 방법
❓ Q: "openclaw uninstall 명령어를 찾을 수 없습니다"
# 원인: CLI 가 이미 부분적으로 삭제된 경우
# 해결 1: npm 으로 재설치 후 제거
npm install -g openclaw
openclaw uninstall --all --yes
npm uninstall -g openclaw
# 해결 2: 수동으로 서비스만 정리
# macOS
pkill -f "openclaw gateway"
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null
# Linux
pkill -f "openclaw gateway"
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
# Windows
Stop-Process -Name "openclaw" -Force
schtasks /Delete /TN "OpenClaw Gateway" /F
❓ Q: 삭제 후에도 "Permission denied" 오류 발생
# macOS / Linux: 프로세스 사용 확인
lsof | grep ~/.openclaw
# 출력된 PID 의 프로세스를 먼저 종료
kill -9 [PID]
# 권한 문제 해결 (주의: 신중하게 사용)
sudo chown -R $USER:$USER ~/.openclaw 2>/dev/null
rm -rf ~/.openclaw
# Windows: 파일 사용 중인 프로세스 확인
handle.exe ~/.openclaw 2>$null
# 또는 작업 관리자 → 세부 정보 → openclaw 관련 프로세스 종료
❓ Q: 작업 공간 데이터를 실수로 삭제했어요! 복구 가능할까요?
openclaw uninstall --workspace 로 삭제한 경우 기본적으로 복구 불가능합니다.
하지만 다음 방법을 시도해볼 수 있습니다:
- 백업이 있었다면:
openclaw backup restore --from [backup-path] - Time Machine (macOS):
~/.openclaw폴더 이전 버전 복원 - 파일 복구 도구: TestDisk, PhotoRec 등으로 삭제된 파일 복구 시도 (성공률 낮음)
- 클라우드 동기화: Dropbox, Google Drive 등에 동기화되었다면 웹에서 이전 버전 확인
앞으로는 중요한 작업 공간 삭제 전 항상
openclaw backup create 를 실행하거나, 작업 공간을 ~/.openclaw 외부에 별도로 관리하는 것을 권장합니다.
❓ Q: 삭제 후 시스템이 느려졌거나 오류가 발생해요
OpenClaw 제거 자체는 시스템 성능에 영향을 주지 않지만, 불완전한 제거로 인한 잔여 설정이 문제를 일으킬 수 있습니다.
# 1. shell 프로필에서 관련 환경 변수 제거 확인
grep -n OPENCLAW ~/.bashrc ~/.zshrc ~/.bash_profile 2>/dev/null
# 출력된 줄을 편집기로 열어 삭제
# 2. PATH 에서 관련 경로 제거
echo $PATH | tr ':' '\n' | grep -i openclaw
# 3. 재부팅 후 정상 작동 확인
reboot
9️⃣ 💬 커뮤니티 실제 사용자 반응
Reddit, GitHub Issues, 디스코드 등에서 실제 사용자들이 보고한 OpenClaw 삭제 관련 경험과 팁을 정리했습니다.
"처음에 그냥 `npm uninstall` 만 하고 끝낸 줄 알았는데, 백그라운드 서비스가 계속 실행되고 있어서 당황했어요. 이 가이드대로 LaunchAgent 까지 정리하니까 깔끔하게 사라졌습니다. 🙌"
Reddit r/selfhosted, 사용자 @dev_minjun"OAuth 토큰 취소 단계를 모르고 넘겼다가, 며칠 후 구글 계정에서 '의심스러운 로그인' 알림을 받고 깜짝 놀랐습니다. 반드시 토큰 취소까지 하세요! 이 가이드가 그걸 강조해줘서 정말 감사합니다."
GitHub Discussions, 사용자 @security_first"Windows 에서 작업 스케줄러 삭제할 때 관리자 권한이 필요한 걸 몰라서 한참 헤맸어요. PowerShell 을 '관리자 권한으로 실행' 하는 걸 잊지 마세요! 💡"
디스코드 OpenClaw 커뮤니티, 사용자 @win_user_2026📊 GitHub Issues 에서 보고된 주요 삭제 관련 버그
| 이슈 번호 | 문제 내용 | 해결 상태 |
|---|---|---|
| #6289 | uninstall 이 작업 공간까지 삭제하여 데이터 손실 발생 |
🟡 논의 중 (워크스페이스 삭제는 --workspace 플래그로 명시적 선택 권장) |
| #11237 | 재시작 시 Gateway 가 자동으로 재설치되는 버그 | ✅ v2026.3.15 에서 수정됨 |
| #35077 | 부분 삭제 시 설정 파일이 깨져 재설치 불가능 | ⚠️ 수동 정리 가이드 필요 (이 문서 참고) |
| #13009 | 자동 업데이트 후 언인스톨 권한 오류 | ✅ 관리자 권한으로 실행 시 해결 |
🔍 보안 전문가들의 조언
"OpenClaw 와 같은 로컬 에이전트 도구는 강력한 기능을 제공하는 만큼, 삭제 과정도 '권한 회수'의 관점에서 접근해야 합니다. 단순 파일 삭제가 아닌, 시스템 서비스 해제 + 외부 토큰 취소 + 설정 정리의 3 단계 접근이 필수적입니다."
- 삭제 전 스크린샷: 설정 화면과 실행 중인 프로세스를 캡처해두면 문제 발생 시 디버깅이 쉬움
- 터미널 로그 기록:
script uninstall_log.txt로 명령어 실행 과정을 기록해두기 - 가상 머신에서 테스트: 중요한 시스템이라면 먼저 VM 에서 삭제 절차를 검증
- 체크리스트 공유: 팀 내에서 삭제 절차를 표준화하여 실수 방지
🎯 마무리: 안전한 삭제, 책임 있는 사용
OpenClaw 는 로컬에서 실행되는 강력한 자율 에이전트 플랫폼입니다. 그 만큼 설치보다 삭제가 더 신중해야 하는 도구이기도 합니다. 이 가이드가 도움이 되어, 여러분의 시스템에서 안전하게 정리하는 데 기여했기를 바랍니다.
openclaw gateway stop으로 백그라운드 서비스 중지- 플랫폼별 서비스 등록 (LaunchAgent/systemd/schtasks) 해제
~/.openclaw및 레거시 디렉토리 삭제- npm 등 패키지 관리자에서 CLI 제거
- 가장 중요: Google, Slack, Discord 등 모든 외부 서비스에서 OAuth 토큰 취소
- 최종 확인 명령어로 잔여 요소 점검
만약 OpenClaw 를 다시 사용하게 되신다면, OpenClaw 완전 설치 가이드 를 참고하여 안전하게 시작하세요. 🦞✨
이 기사는 2026 년 4 월 기준 OpenClaw v2026.4.x 버전을 기준으로 작성되었습니다. 최신 버전에서 변경사항이 있을 수 있으니, 공식 문서 docs.openclaw.ai 도 함께 참고하시기 바랍니다.