제거 매뉴얼macOS / Linux / WindowsDocker / Podman / Nix / Ansible

OpenClaw 완전 제거 가이드

이건 단순한 ‘앱 삭제’가 아닙니다. 백그라운드 게이트웨이 서비스, 상태/설정 디렉터리, 컨테이너 잔여물을 처리하고, (강력 권장) 부여했던 권한과 키를 철회해야 합니다.

권장 순서

먼저 openclaw uninstall 또는 서비스 중지 → 그다음 CLI 제거.

원클릭 복사

각 명령 블록 오른쪽 상단에 복사 버튼이 있습니다.

보안 마무리

제거 후 OAuth 철회 / API 키 회전을 잊지 마세요.

Step 0

먼저 확인: 어떻게 설치했나요?

설치 방식에 따라 제거 경로가 달라집니다. 10초 안에 해당 섹션을 찾으세요.

A. 일반 로컬 설치

openclaw 명령이 동작하고 UI/서비스가 백그라운드에 있을 수 있음.

섹션으로 이동

B. CLI가 없음

openclaw 명령은 없지만 서비스/프로세스가 남아 있음.

섹션으로 이동

C/D. 컨테이너 (Docker/Podman)

docker-setup.sh 또는 setup-podman.sh 사용.

섹션으로 이동

E/F. Nix / Ansible

nix-openclaw 또는 openclaw-ansible로 배포.

섹션으로 이동

Step 1

공식 제거 (CLI 있음)

openclaw 명령이 동작한다면 내장 제거기를 먼저 사용하세요.

1.1 한 줄 명령 (권장)

대부분 사용자에게 적합: 대화형 제거, 안내에 따라 진행.

bash

openclaw uninstall

1.2 자동화 / 무인

자동화 환경용: 대화형 프롬프트를 건너뜁니다.

bash

openclaw uninstall --all --yes --non-interactive

# 或者 npx 直接跑
npx -y openclaw uninstall --all --yes --non-interactive

Step 2

CLI는 없지만 서비스는 실행 중

openclaw 명령이 없지만 백그라운드 서비스가 실행 중인 경우.

macOS (launchd)

기본 label: ai.openclaw.gateway (구버전 이름이 있을 수 있음). 서비스 중지 후 plist 삭제.

bash

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

이전 이름 확인:

bash

ls -1 ~/Library/LaunchAgents | grep -Ei 'openclaw|clawd|clawdbot|molt'
launchctl list | grep -Ei 'openclaw|clawd|clawdbot|molt'

Linux (systemd user)

기본 unit: openclaw-gateway.service (profile이 접미사를 추가할 수 있음).

bash

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

확인:

bash

systemctl --user list-unit-files | grep -i openclaw
systemctl --user status openclaw-gateway.service

Windows (Scheduled Task)

기본 작업 이름: OpenClaw Gateway (profile이 접미사를 추가할 수 있음).

powershell

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

Step 3

잔여 파일 제거

상태/설정/워크스페이스와 레거시 디렉터리를 정리합니다.

기본 경로

상태/설정과 워크스페이스는 보통 ~/.openclaw

bash

rm -rf ~/.openclaw

레거시 디렉터리 (선택)

이전 버전을 사용했다면 아래 경로를 확인하세요.

bash

rm -rf ~/.clawdbot
rm -rf ~/clawdbot

Step 4

Docker / Podman

컨테이너 게이트웨이를 제거하고 호스트 데이터를 정리합니다.

Docker Compose

리포지토리 디렉터리에서 컨테이너를 중지/삭제합니다.

bash

docker compose down

docker compose down -v

호스트 영속 디렉터리 삭제:

bash

rm -rf ~/.openclaw

Podman (rootless)

Quadlet 서비스를 중지한 뒤 컨테이너와 데이터를 제거합니다.

bash

sudo systemctl --machine openclaw@ --user stop openclaw.service
sudo -u openclaw podman rm -f openclaw

Podman 모드 호스트 데이터 삭제:

bash

sudo rm -rf /home/openclaw/.openclaw
sudo rm -f /home/openclaw/.config/containers/systemd/openclaw.container
sudo systemctl --machine openclaw@ --user daemon-reload

Step 5

Nix / Ansible

Nix / Ansible 배포 환경용.

Nix / Home Manager

nix-openclaw 모듈을 제거하거나 비활성화한 뒤 다시 적용합니다.

bash

home-manager switch

home-manager switch --rollback

필요하면 상태 디렉터리(커스텀 경로일 수 있음)를 삭제합니다.

Ansible (openclaw-ansible)

서비스를 중지/비활성화한 뒤 설치 경로와 데이터를 삭제합니다.

bash

sudo systemctl stop openclaw
sudo systemctl disable openclaw

sudo rm -rf /opt/openclaw
sudo rm -rf /home/openclaw/openclaw
sudo rm -rf /home/openclaw/.openclaw

더 이상 필요 없다면 openclaw 사용자를 삭제하세요.

bash

sudo userdel -r openclaw

Step 6

제거 후 자가 점검

서비스/포트/로컬 디렉터리가 깨끗한지 확인합니다.

Step 7

접근 철회 및 키 로테이션

제거가 곧 권한 철회는 아닙니다. 최소 보안 조치를 수행하세요.

최소한 아래 세 가지는 완료하세요:

OpenClaw에 제공한 API 키를 회전(기존 키 무효화).
의심스러운 세션 로그아웃/삭제(채팅 앱, 이메일, 클라우드 콘솔 등).
OAuth/App 권한 철회(Google/Microsoft/GitHub 등).

플랫폼마다 경로가 다르니 각 보안 센터 안내에 따르세요.