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, 경험 있는 사용자)

  1. Lume 설치
  2. lume create openclaw --os macos --ipsw latest
  3. 설정 어시스턴트 완료, 원격 로그인(SSH) 활성화
  4. lume run openclaw --no-display
  5. SSH 접속, OpenClaw 설치, 채널 설정
  6. 완료

필요한 것 (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 창에서:

  1. 언어와 지역 선택
  2. Apple ID 건너뛰기 (나중에 iMessage가 필요하면 로그인)
  3. 사용자 계정 생성 (사용자 이름과 비밀번호를 기억하세요)
  4. 선택적 기능 모두 건너뛰기

설정 완료 후 SSH를 활성화합니다:

  1. 시스템 설정 → 일반 → 공유 열기
  2. “원격 로그인” 활성화

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 안에서:

  1. bluebubbles.app에서 BlueBubbles 다운로드
  2. Apple ID로 로그인
  3. Web API를 활성화하고 비밀번호 설정
  4. 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에 로그인되어 있는지 확인

관련 문서