제거

두 가지 방법이 있습니다:

  • openclaw이 아직 설치되어 있다면 간편 방법.
  • CLI가 삭제되었지만 서비스가 계속 실행 중이면 수동 서비스 제거.

간편 방법 (CLI가 아직 설치됨)

내장 제거 도구를 사용하는 것을 권장합니다:

openclaw uninstall

비대화형 (자동화 / npx):

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

수동 단계 (동일한 결과):

  1. 게이트웨이 서비스 중지:
openclaw gateway stop
  1. 게이트웨이 서비스 제거 (launchd/systemd/schtasks):
openclaw gateway uninstall
  1. 상태 + 설정 삭제:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

OPENCLAW_CONFIG_PATH를 상태 디렉토리 외부의 커스텀 위치로 설정한 경우 해당 파일도 삭제하세요.

  1. 워크스페이스 삭제 (선택사항, 에이전트 파일 제거):
rm -rf ~/.openclaw/workspace
  1. CLI 설치 제거 (사용한 방법 선택):
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
  1. macOS 앱을 설치한 경우:
rm -rf /Applications/OpenClaw.app

참고:

  • 프로필(--profile / OPENCLAW_PROFILE)을 사용한 경우, 각 상태 디렉토리(기본값 ~/.openclaw-<profile>)에 대해 3단계를 반복하세요.
  • 원격 모드에서는 상태 디렉토리가 게이트웨이 호스트에 있으므로 1-4단계를 거기에서도 실행하세요.

수동 서비스 제거 (CLI 미설치)

게이트웨이 서비스가 계속 실행 중이지만 openclaw이 없을 때 사용합니다.

macOS (launchd)

기본 레이블은 ai.openclaw.gateway(또는 ai.openclaw.<profile>; 레거시 com.openclaw.*가 아직 존재할 수 있음)입니다:

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

프로필을 사용한 경우 레이블과 plist 이름을 ai.openclaw.<profile>로 교체하세요. 레거시 com.openclaw.* plist가 있으면 제거하세요.

Linux (systemd 사용자 유닛)

기본 유닛 이름은 openclaw-gateway.service(또는 openclaw-gateway-<profile>.service)입니다:

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

Windows (예약된 작업)

기본 작업 이름은 OpenClaw Gateway(또는 OpenClaw Gateway (<profile>))입니다. 작업 스크립트는 상태 디렉토리 아래에 있습니다.

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

프로필을 사용한 경우 해당 작업 이름과 ~\.openclaw-<profile>\gateway.cmd를 삭제하세요.

일반 설치 vs 소스 체크아웃

일반 설치 (install.sh / npm / pnpm / bun)

https://openclaw.ai/install.sh 또는 install.ps1을 사용했다면 CLI는 npm install -g openclaw@latest로 설치되었습니다. npm rm -g openclaw(또는 해당 방식으로 설치한 경우 pnpm remove -g / bun remove -g)으로 제거하세요.

소스 체크아웃 (git clone)

저장소 체크아웃에서 실행한 경우(git clone + openclaw ... / bun run openclaw ...):

  1. 저장소를 삭제하기 전에 게이트웨이 서비스를 제거하세요(위의 간편 방법 또는 수동 서비스 제거 사용).
  2. 저장소 디렉토리를 삭제합니다.
  3. 위에 표시된 대로 상태 + 워크스페이스를 제거합니다.