[OpenClaw 업데이트 트러블슈팅] Mac Homebrew Cask + npm 충돌 해결법

[OpenClaw 업데이트 트러블슈팅] Mac Homebrew Cask + npm 충돌 해결법

OpenClaw 2026.4.1이 나왔다는 걸 보고 업데이트하려다 예상치 못한 충돌을 만났습니다.

환경: Mac (Apple Silicon) · Homebrew Cask로 설치 · 2026.3.24 → 2026.4.2 업그레이드

--- 겪은 문제들 ---

문제 1. brew upgrade openclaw

→ "Warning: Not upgrading openclaw, the latest version is already installed"

Homebrew formula가 최신 버전을 미반영한 상태

문제 2. sudo npm install -g openclaw@latest

→ "npm error EEXIST: file already exists /opt/homebrew/bin/openclaw"

Cask가 점유한 파일과 충돌

문제 3. brew unlink openclaw

→ "Error: No such keg: /opt/homebrew/Cellar/openclaw"

Cask 설치라 unlink 불가

--- 최종 해결 방법 ---

# Step 1: macOS 앱 재설치

brew uninstall --cask openclaw

brew install --cask openclaw

# Step 2: 충돌 파일 제거

sudo rm /opt/homebrew/bin/openclaw

# Step 3: npm으로 CLI 설치

sudo npm install -g openclaw@latest

# Step 4: 게이트웨이 재시작

openclaw gateway restart

핵심: Homebrew Cask(앱)와 npm(CLI)은 같은 경로를 두고 충돌합니다. 앱은 Cask로, CLI는 npm으로 따로 관리하세요.