제거

두 가지 방법이 있습니다.

• openclaw이 아직 설치되어 있다면 간편한 방법을 사용합니다.
• CLI가 제거되었지만 서비스가 아직 실행 중이라면 수동 서비스 제거를 사용합니다.

간편한 방법(CLI가 아직 설치된 경우)

권장: 내장 제거 프로그램을 사용합니다.

openclaw uninstall

--workspace도 선택하지 않는 한 상태를 제거해도 구성된 작업 공간 디렉터리는 유지됩니다.

제거할 항목을 미리 확인합니다(안전함).

openclaw uninstall --dry-run --all

비대화형 실행(자동화 / npx). 범위를 확인한 후에만 주의해서 사용하세요.

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

플래그: --service, --state, --workspace, --app은 개별 범위를 선택하며, --all은 네 가지 범위를 모두 선택합니다.

수동 단계(결과는 동일함):

1. Gateway 서비스를 중지합니다.

openclaw gateway stop

2. Gateway 서비스를 제거합니다(launchd/systemd/schtasks).

openclaw gateway uninstall

3. 상태와 구성을 삭제합니다.

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

OPENCLAW_CONFIG_PATH를 상태 디렉터리 외부의 사용자 지정 위치로 설정했다면 해당 파일도 삭제합니다. ~/.openclaw/workspace처럼 상태 디렉터리 내부의 작업 공간을 유지하려면 rm -rf를 실행하기 전에 다른 곳으로 옮기거나 상태 디렉터리의 내용을 선별적으로 삭제합니다.

4. 작업 공간을 삭제합니다(선택 사항, 에이전트 파일 제거).

rm -rf ~/.openclaw/workspace

5. CLI 설치를 제거합니다(사용한 방법에 해당하는 명령 선택).

npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw

6. macOS 앱을 설치한 경우:

rm -rf /Applications/OpenClaw.app

참고:

• 프로필(--profile / OPENCLAW_PROFILE)을 사용했다면 각 상태 디렉터리에 대해 3단계를 반복합니다(기본값은 ~/.openclaw-<profile>).
• 원격 모드에서는 상태 디렉터리가 Gateway 호스트에 있으므로 해당 호스트에서도 1~4단계를 실행합니다.

수동 서비스 제거(CLI가 설치되지 않은 경우)

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

macOS(launchd)

기본 레이블은 ai.openclaw.gateway입니다(프로필을 사용하면 ai.openclaw.<profile>).

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

프로필을 사용했다면 레이블과 plist 이름을 ai.openclaw.<profile>로 바꿉니다.

Linux(systemd 사용자 유닛)

기본 유닛 이름은 openclaw-gateway.service입니다(또는 openclaw-gateway-<profile>.service). 매우 오래된 설치에서 업그레이드한 머신에는 이름 변경 전의 clawdbot-gateway.service 유닛이 여전히 존재할 수 있습니다. openclaw uninstall / openclaw gateway uninstall은 이를 자동으로 감지하여 제거합니다.

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

Windows(예약된 작업)

기본 작업 이름은 OpenClaw Gateway입니다(또는 OpenClaw Gateway (<profile>)). 이 작업은 상태 디렉터리 아래의 창 없는 gateway.vbs 스크립트를 실행하고, 이 스크립트는 다시 gateway.cmd를 실행합니다. 두 파일을 모두 제거합니다.

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

프로필을 사용했다면 해당 작업 이름과 ~\.openclaw-<profile> 아래의 gateway.cmd / gateway.vbs 파일을 삭제합니다.

일반 설치와 소스 체크아웃 비교

일반 설치(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. 저장소를 삭제하기 전에 Gateway 서비스를 제거합니다(위의 간편한 방법 또는 수동 서비스 제거 사용).
2. 저장소 디렉터리를 삭제합니다.
3. 위에 설명한 대로 상태와 작업 공간을 제거합니다.

관련 문서

• 설치 개요
• 마이그레이션 가이드