Maintenance
제거하기
두 가지 경로가 있습니다.
openclaw가 아직 설치되어 있다면 쉬운 경로- CLI는 사라졌지만 서비스가 아직 실행 중이라면 수동 서비스 제거
쉬운 경로(CLI가 아직 설치된 경우)
권장: 내장 제거기를 사용하세요.
openclaw uninstall
비대화형(자동화 / npx):
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
수동 단계(동일한 결과):
- gateway 서비스 중지:
openclaw gateway stop
- gateway 서비스 제거(launchd/systemd/schtasks):
openclaw gateway uninstall
- 상태 + config 삭제:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
상태 디렉터리 밖의 사용자 지정 위치에 OPENCLAW_CONFIG_PATH를 설정했다면 그 파일도 삭제하세요.
- 워크스페이스 삭제(선택 사항, 에이전트 파일 제거):
rm -rf ~/.openclaw/workspace
- CLI 설치 제거(사용한 방식 선택):
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
- macOS 앱을 설치했다면:
rm -rf /Applications/OpenClaw.app
참고:
- profile(
--profile/OPENCLAW_PROFILE)을 사용했다면 각 상태 디렉터리마다 3단계를 반복하세요(기본값은~/.openclaw-<profile>). - 원격 모드에서는 상태 디렉터리가 gateway 호스트에 있으므로 1-4단계도 그곳에서 실행하세요.
수동 서비스 제거(CLI가 설치되지 않은 경우)
gateway 서비스가 계속 실행되는데 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
profile을 사용했다면 레이블과 plist 이름을 ai.openclaw.<profile>로 바꾸세요. 레거시 com.openclaw.* plist가 있으면 그것도 제거하세요.
Linux (systemd 사용자 unit)
기본 unit 이름은 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"
profile을 사용했다면 해당 작업 이름과 ~\.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 또는 bun으로 설치했다면 pnpm remove -g / bun remove -g 사용).
소스 체크아웃(git clone)
repo 체크아웃에서 실행하는 경우(git clone + openclaw ... / bun run openclaw ...):
- repo를 삭제하기 전에 gateway 서비스를 제거하세요(위의 쉬운 경로 또는 수동 서비스 제거 사용).
- repo 디렉터리를 삭제하세요.
- 위에서 설명한 대로 상태 + 워크스페이스를 제거하세요.