macOS VM에서 OpenClaw 실행 (샌드박싱)
권장 기본 구성 (대부분의 사용자)
- 소규모 Linux VPS — 상시 운영 게이트웨이와 저렴한 비용. VPS 호스팅 참고.
- 전용 하드웨어 (Mac mini 또는 Linux 머신) — 완전한 제어와 브라우저 자동화를 위한 가정용 IP가 필요한 경우. 많은 사이트가 데이터센터 IP를 차단하므로 로컬 브라우징이 더 잘 작동하는 경우가 많습니다.
- 하이브리드: 저렴한 VPS에 게이트웨이를 유지하고, 브라우저/UI 자동화가 필요할 때 Mac을 노드로 연결. 노드와 게이트웨이 원격 참고.
macOS 전용 기능(iMessage/BlueBubbles)이 필요하거나 일상 Mac에서 엄격한 격리가 필요할 때 macOS VM을 사용하세요.
macOS VM 옵션
Apple Silicon Mac에서의 로컬 VM (Lume)
Lume을 사용하여 Apple Silicon Mac에서 샌드박싱된 macOS VM으로 OpenClaw를 실행합니다.
제공 기능:
- 격리된 완전한 macOS 환경 (호스트는 깨끗하게 유지)
- BlueBubbles를 통한 iMessage 지원 (Linux/Windows에서는 불가능)
- VM 복제로 즉시 초기화
- 추가 하드웨어나 클라우드 비용 없음
호스팅 Mac 프로바이더 (클라우드)
클라우드에서 macOS가 필요하다면 호스팅 Mac 프로바이더도 가능합니다:
- MacStadium (호스팅 Mac)
- 다른 호스팅 Mac 벤더도 가능. 해당 VM + SSH 문서를 따르세요.
macOS VM에 SSH 접근이 확보되면 아래 6단계부터 진행하세요.
빠른 경로 (Lume, 경험 있는 사용자)
- Lume 설치
lume create openclaw --os macos --ipsw latest- 설정 어시스턴트 완료, 원격 로그인(SSH) 활성화
lume run openclaw --no-display- SSH 접속, OpenClaw 설치, 채널 설정
- 완료
필요한 것 (Lume)
- Apple Silicon Mac (M1/M2/M3/M4)
- 호스트에 macOS Sequoia 이상
- VM당 약 60 GB 여유 디스크 공간
- 약 20분
1) Lume 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
~/.local/bin이 PATH에 없다면:
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
확인:
lume --version
문서: Lume 설치
2) macOS VM 생성
lume create openclaw --os macos --ipsw latest
macOS를 다운로드하고 VM을 생성합니다. VNC 창이 자동으로 열립니다.
참고: 인터넷 연결 속도에 따라 다운로드에 시간이 걸릴 수 있습니다.
3) 설정 어시스턴트 완료
VNC 창에서:
- 언어와 지역 선택
- Apple ID 건너뛰기 (나중에 iMessage가 필요하면 로그인)
- 사용자 계정 생성 (사용자 이름과 비밀번호를 기억하세요)
- 선택적 기능 모두 건너뛰기
설정 완료 후 SSH를 활성화합니다:
- 시스템 설정 → 일반 → 공유 열기
- “원격 로그인” 활성화
4) VM의 IP 주소 확인
lume get openclaw
IP 주소를 찾습니다(보통 192.168.64.x).
5) VM에 SSH 접속
ssh [email protected]
youruser를 생성한 계정으로, IP를 VM의 IP로 교체하세요.
6) OpenClaw 설치
VM 안에서:
npm install -g openclaw@latest
openclaw onboard --install-daemon
온보딩 프롬프트를 따라 모델 프로바이더(Anthropic, OpenAI 등)를 설정합니다.
7) 채널 설정
설정 파일을 편집합니다:
nano ~/.openclaw/openclaw.json
채널을 추가합니다:
{
"channels": {
"whatsapp": {
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
},
"telegram": {
"botToken": "YOUR_BOT_TOKEN"
}
}
}
WhatsApp 로그인 (QR 스캔):
openclaw channels login
8) VM 헤드리스 실행
VM을 중지하고 디스플레이 없이 재시작합니다:
lume stop openclaw
lume run openclaw --no-display
VM이 백그라운드에서 실행됩니다. OpenClaw의 데몬이 게이트웨이를 유지합니다.
상태 확인:
ssh [email protected] "openclaw status"
보너스: iMessage 통합
macOS에서 실행하는 핵심 기능입니다. BlueBubbles를 사용하여 OpenClaw에 iMessage를 추가하세요.
VM 안에서:
- bluebubbles.app에서 BlueBubbles 다운로드
- Apple ID로 로그인
- Web API를 활성화하고 비밀번호 설정
- BlueBubbles 웹훅을 게이트웨이로 연결 (예:
https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)
OpenClaw 설정에 추가:
{
"channels": {
"bluebubbles": {
"serverUrl": "http://localhost:1234",
"password": "your-api-password",
"webhookPath": "/bluebubbles-webhook"
}
}
}
게이트웨이를 재시작합니다. 이제 에이전트가 iMessage를 주고받을 수 있습니다.
전체 설정 상세: BlueBubbles 채널
골든 이미지 저장
추가 커스터마이징 전에 깨끗한 상태를 스냅샷합니다:
lume stop openclaw
lume clone openclaw openclaw-golden
언제든 초기화:
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display
24/7 운영
VM을 계속 실행하려면:
- Mac을 전원에 연결한 상태로 유지
- 시스템 설정 → 에너지 절약에서 잠자기 비활성화
- 필요시
caffeinate사용
진정한 상시 운영을 위해서는 전용 Mac mini 또는 소규모 VPS를 고려하세요. VPS 호스팅 참고.
문제 해결
| 문제 | 해결 방법 |
|---|---|
| VM에 SSH 접속 불가 | VM의 시스템 설정에서 “원격 로그인”이 활성화되어 있는지 확인 |
| VM IP가 표시되지 않음 | VM이 완전히 부팅될 때까지 기다린 후 lume get openclaw 다시 실행 |
| Lume 명령어를 찾을 수 없음 | PATH에 ~/.local/bin을 추가 |
| WhatsApp QR이 스캔되지 않음 | openclaw channels login 실행 시 호스트가 아닌 VM에 로그인되어 있는지 확인 |
관련 문서
- VPS 호스팅
- 노드
- 게이트웨이 원격
- BlueBubbles 채널
- Lume 빠른 시작
- Lume CLI 참고
- 무인 VM 설정 (고급)
- Docker 샌드박싱 (대안적 격리 방법)