OpenClaw 완전 삭제 가이드: 흔적 없이 지우기

프로그램을 삭제했다고 생각했는데 여전히 백그라운드 프로세스가 리소스를 잡아먹고 있거나 웹 인터페이스에 접속되는 것을 발견하면 정말 짜증납니다. OpenClaw와 관련해 가장 흔한 오해 중 하나는 npm uninstall 명령만 실행하면 모든 것이 해결된다는 식의 생각입니다. 실제로는 이 방법으로 CLI (명령줄 인터페이스)를 삭제할 순 있지만, 백그라운드 게이트웨이와 작업 공간은 물론 중요한 정보가 포함될 수 있는 설정 파일까지 그대로 남게 됩니다.

기기에서 OpenClaw를 진정으로 완벽히 제거하려면 CLI, 백그라운드 서비스, 그리고 로컬 데이터 및 인증 정보라는 3가지 부분을 모두 처리해야 합니다.

사용자의 초기 설정 방식에 맞춘, 안전하고 철저한 OpenClaw의 제거 가이드라인을 소개합니다.

1. 나의 설치 환경 파악하기

명령어를 실행하기 전에 먼저 자신이 어떤 범주에 속하는지 파악하세요. 이에 따라 정리 과정이 달라집니다.

설치 유형	증상
일반 로컬 (작동 중)	터미널에 여전히 `openclaw`를 입력할 수 있습니다. 가장 간단한 경우입니다.
고아 서비스 (Orphaned)	CLI는 삭제했지만, 포트가 여전히 수신 중이거나 프로세스가 실행 중입니다.
Docker / Podman	애초에 컨테이너(`docker compose up` 또는 `podman`)를 사용하여 시작했습니다.
인프라 환경 (Nix/Ansible)	`nix-openclaw` 플레이크나 Ansible 플레이북을 통해 서버에 배포했습니다.

2. 공식적이고 가장 안전한 방법 (일반 로컬 설치 환경용)

CLI가 여전히 온전하다면 즉시 수동으로 패키지를 삭제하지 마세요. OpenClaw에 내장된 도구를 사용하여 백그라운드 서비스를 먼저 해제해야 합니다.

단계별 서비스 해제

게이트웨이 서비스 중지 및 제거: 재부팅 시 다시 시작되는 것을 방지합니다.

bash

openclaw gateway stopopenclaw gateway uninstall

로컬 상태 및 환경 설정 지우기:

bash

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

(주의: 다중 프로필을 사용 중인 경우는 각각의 ~/.openclaw-<profile> 디렉토리에 대해 이 과정을 반복해야 합니다).

CLI 언인스톨: 이제 기존 패키지 매니저를 이용해 안전하게 패키지를 제거할 수 있습니다.

bash

npm rm -g openclaw# 또는 해당하는 경우 pnpm / bun의 동일 명령어를 사용

빠른 삭제: 한 번의 자동화 작업으로 즉시 제거하고 싶다면 다음을 실행하세요: openclaw uninstall --all --yes --non-interactive (또는 npx를 통해: npx -y openclaw uninstall --all --yes --non-interactive).

3. 수동 데이터 정리: CLI는 없어졌으나 서비스가 남은 경우

CLI를 삭제했지만 여전히 유령처럼 실행 중인 백그라운드 서비스가 멈춰있다면 운영체제의 서비스 관리자에 직접 개입해야 합니다.

macOS (Launchd)

OpenClaw는 LaunchAgent로 등록됩니다. 이를 부팅 해제하고 .plist 파일을 제거해야 합니다.

bash

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

팁: 구버전의 경우 com.clawdbot.gateway.plist 나 bot.molt.gateway.plist 같은 이름이었을 수 있습니다. ls -1 ~/Library/LaunchAgents | grep -Ei 'openclaw|clawd|molt' 명령으로 찾을 수 있습니다.

Linux (Systemd)

사용자 레벨 시스템의 systemd 유닛을 비활성화하고 제거합니다.

bash

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

Windows (작업 스케줄러)

Windows에서는 예약된 작업을 통해 게이트웨이를 활성 상태로 유지합니다. PowerShell을 열고 다음 명령어를 실행하세요.

powershell

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

4. 컨테이너 환경 (Docker & Podman)

컨테이너를 사용한 경우, 정리 과정에는 컨테이너 종료와 마운트된 호스트 디렉토리 지우기가 포함됩니다.

Docker Compose

리포지토리 디렉토리로 이동하여 컨테이너와 볼륨을 제거합니다:

bash

docker compose down -vrm -rf ~/.openclaw

(선택사항: 남은 이미지들을 찾거나 지우기 위해 docker images | grep -i openclaw 를 실행해 봅니다).

Podman (루트리스)

서비스를 중지하고, 컨테이너를 제거한 다음 관련 사용자 전용 데이터를 삭제합니다.

bash

sudo systemctl --machine openclaw@ --user stop openclaw.servicesudo -u openclaw podman rm -f openclawsudo rm -rf /home/openclaw/.openclaw

5. 서버 인프라 (Nix & Ansible)

선언적 혹은 자동화된 서버 배포로 진행한 경우 배포 설정을 되돌려야 합니다.

Nix / Home Manager: 구성 내에서 programs.openclaw.enable = true; 줄을 지우거나 주석처리 한 다음, home-manager switch 로 변경 사항을 적용합니다. 마지막으로 ~/.openclaw 상태 디렉토리를 제거합니다.
Ansible: openclaw systemd 서비스를 멈추고 비활성화합니다. 이후 /opt/openclaw 디렉토리와 openclaw 사용자의 홈 디렉토리를 수동 조작으로 삭제합니다. 만약 이 전용 사용자를 더 이상 이용하지 않는 경우, sudo userdel -r openclaw 로 시스템 상에서 안전하게 정리하세요.

6. 핵심 보안 단계: 각종 인증 정보 철회

로컬 애플리케이션을 삭제한다고 해서 해당 클라우드 접근 권한이 자동으로 철회되는 것은 아닙니다. 만약 OpenClaw가 여러분의 API나 메신저 플랫폼, 클라우드 등 다양한 환경에 접근할 수 있게 설정해 두었었다면, 단순히 로컬 폴더만 지우고 끝내는 것은 엄청난 보안 상의 실수를 초래할 수 있습니다.

안전하고 완전하게 오프보딩하려면 다음 절차를 따라주십시오:

API 키 갱신(로테이션): OpenClaw에게 부여했던 모든 키 (OpenAI, Anthropic 등)를 재생성합니다. 기존 키는 모두 유출되었다고 가정하고 제공업체 시스템의 대시보드에서 안전하게 소거합니다.
세션 종료하기: WhatsApp, Telegram, Slack 등 연동한 적 있는 메신저 플랫폼으로 이동하여 "활성 세션" 혹은 "연결된 장치" 목록을 점검하고 봇과 관련된 인스턴스가 보이면 즉시 로그아웃합니다.
OAuth 철회하기: 구글이나 마이크로소프트, GitHub의 보안 설정 항목 등을 면밀하게 확인한 뒤 승인된 서드파티 앱 메뉴에서 OpenClaw의 접근을 일괄 취소합니다.