MacBook Pro에서 로컬 Homebrew와 NVM을 사용한 OpenClaw 설치

한 개발자가 MacBook Pro에서 비관리자 사용자 계정으로 OpenClaw 설치를 성공적으로 문서화했으며, 이 과정에서 Gemini의 안내를 참고했습니다.

설치 접근 방식

설치는 시스템 관리자 권한이 필요하지 않도록 ~/homebrew에 로컬 Homebrew 설정을 사용했습니다. Xcode Command Line Tools는 관리자 계정에서 미리 설치되었으며, OpenClaw, oMLX 및 종속성은 표준 사용자 계정에서 설치되었습니다.

주요 설정 단계

이 과정은 Gemini가 생성한 다음 특정 지침을 따랐습니다:

1단계: 로컬 Homebrew 및 NVM 초기화

mkdir -p ~/homebrew
curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C ~/homebrew
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

2단계: 셸 환경 구성

~/.zshrc 파일에 다음 내용을 추가하도록 수정했습니다:

# 1. HOMEBREW 설정 (oc1에 로컬)
export PATH="/Users/oc1/homebrew/bin:$PATH"
export HOMEBREW_PREFIX="/Users/oc1/homebrew"
export HOMEBREW_CELLAR="/Users/oc1/homebrew/Cellar"
export HOMEBREW_REPOSITORY="/Users/oc1/homebrew"
# 로컬 라이브러리를 위한 컴파일러 플래그 (M3 Max 빌드에 필요)
export LDFLAGS="-L$HOMEBREW_PREFIX/lib"
export CPPFLAGS="-I$HOMEBREW_PREFIX/include"
export PKG_CONFIG_PATH="$HOMEBREW_PREFIX/lib/pkgconfig"
# 2. NVM 설정
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# 3. PYENV 설정
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

3단계: 빌드 종속성 및 pyenv 설치

~/homebrew/bin/brew install --build-from-source openssl readline sqlite3 xz zlib
~/homebrew/bin/brew install --build-from-source pyenv

4단계: Node 및 Python 런타임 설치

nvm install 24
nvm alias default 24
LDFLAGS="-L/Users/oc1/homebrew/lib" CPPFLAGS="-I/Users/oc1/homebrew/include" pyenv install 3.14.3
pyenv global 3.14.3

5단계: OpenClaw 설치

npm install -g pnpm
npm install -g openclaw@latest
openclaw --version

추가 구성 요소

oMLX는 DMG 파일 다운로드를 통해 설치되었으며, Qwen3.5-122B-A10B-MLX-vision-4.7-bit LLM은 oMLX를 통해 다운로드되었습니다. 설치는 M3 Max MacBook Pro에서 수행되었으며, 컴파일러 플래그는 ARM64 최적화 빌드를 위해 특별히 구성되었습니다.