OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

제거

두 가지 방법이 있습니다.

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

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

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

bash
openclaw uninstall

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

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

bash
openclaw uninstall --dry-run --all

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

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

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

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

  1. Gateway 서비스를 중지합니다.
bash
openclaw gateway stop
  1. Gateway 서비스를 제거합니다(launchd/systemd/schtasks).
bash
openclaw gateway uninstall
  1. 상태와 구성을 삭제합니다.
bash
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

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

  1. 작업 공간을 삭제합니다(선택 사항, 에이전트 파일 제거).
bash
rm -rf ~/.openclaw/workspace
  1. CLI 설치를 제거합니다(사용한 방법에 해당하는 명령 선택).
bash
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw
  1. macOS 앱을 설치한 경우:
bash
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>).

bash
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은 이를 자동으로 감지하여 제거합니다.

bash
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를 실행합니다. 두 파일을 모두 제거합니다.

powershell
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. 위에 설명한 대로 상태와 작업 공간을 제거합니다.

관련 문서

Was this useful?
On this page

On this page