macOS VMs

macOS VMs 문서는 OpenClaw 공식 문서(install/macos-vm)를 한국어로 정리한 가이드입니다. Run OpenClaw in a sandboxed macOS VM (local or hosted) when you need isolation or iMessage 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Run OpenClaw in a sandboxed macOS VM (local or hosted) when you need isolation or iMessage

한국어 가이드 범위: install/macos-vm 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Recommended default (most users)
macOS VM options
Local VM on your Apple Silicon Mac (Lume)
Hosted Mac providers (cloud)
Quick path (Lume, experienced users)
What you need (Lume)
1) Install Lume
2) Create the macOS VM
3) Complete Setup Assistant
4) Get the VM IP address
5) SSH into the VM
6) Install OpenClaw
7) Configure channels
8) Run the VM headlessly
Bonus: iMessage integration
Save a golden image
Running 24/7
트러블슈팅
Related docs

상세 내용

Recommended default (most users)

Use a macOS VM only when you specifically need macOS-only capabilities such as iMessage, or want strict isolation from your daily Mac.

주요 항목:

Small Linux VPS for an always-on Gateway and low cost. See VPS hosting.
Dedicated hardware (Mac mini or Linux box) if you want full control and a residential IP for browser automation. Many sites block data center IPs, so local browsing often works better.
Hybrid: keep the Gateway on a cheap VPS, and connect your Mac as a node when you need browser/UI automation. See Nodes and Gateway remote.

macOS VM options

이 섹션의 세부 항목은 공식 문서 macOS VM options를 참고하세요.

Local VM on your Apple Silicon Mac (Lume)

Run OpenClaw in a sandboxed macOS VM on your existing Apple Silicon Mac using Lume. This gives you:

주요 항목:

Full macOS environment in isolation (your host stays clean)
iMessage support via imsg; the default local path is impossible on Linux/Windows
Instant reset by cloning VMs
No extra hardware or cloud costs

Hosted Mac providers (cloud)

If you want macOS in the cloud, hosted Mac providers work too:

주요 항목:

MacStadium (hosted Macs)
Other hosted Mac vendors also work; follow their VM + SSH docs

Quick path (Lume, experienced users)

Install Lume. 2. lume create openclaw --os macos --ipsw latest 3. Complete Setup Assistant, enable Remote Login (SSH). 4. lume run openclaw --no-display 5. SSH in, install OpenClaw, configure channels. 6. Done.

What you need (Lume)

주요 항목:

Apple Silicon Mac (M1/M2/M3/M4)
macOS Sequoia or later on the host
~60 GB free disk space per VM
~20 minutes

1) Install Lume

Docs: Lume Installation

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

lume --version

2) Create the macOS VM

This downloads macOS and creates the VM. A VNC window opens automatically.

lume create openclaw --os macos --ipsw latest

3) Complete Setup Assistant

Select language and region. 2. Skip Apple ID (or sign in if you want iMessage later). 3. Create a user account (remember the username and password). 4. Skip all optional features.

4) Get the VM IP address

Look for the IP address (usually 192.168.64.x).

lume get openclaw

5) SSH into the VM

Replace youruser with the account you created, and the IP with your VM's IP.

ssh youruser@192.168.64.X

6) Install OpenClaw

Follow the onboarding prompts to set up your model provider (Anthropic, OpenAI, etc.).

npm install -g openclaw@latest
openclaw onboard --install-daemon

7) Configure channels

nano ~/.openclaw/openclaw.json

{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login

8) Run the VM headlessly

The VM runs in the background; OpenClaw's daemon keeps the gateway running. To check status:

lume stop openclaw
lume run openclaw --no-display

ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage integration

This is the killer feature of running on macOS. Use iMessage with imsg to add Messages to OpenClaw.

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}

Save a golden image

Before customizing further, snapshot your clean state:

lume stop openclaw
lume clone openclaw openclaw-golden

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

Running 24/7

For true always-on, consider a dedicated Mac mini or a small VPS. See VPS hosting.

주요 항목:

Keeping your Mac plugged in
Disabling sleep in System Settings -> Energy Saver
Using caffeinate if needed

트러블슈팅

Problem	Solution
Cannot SSH into VM	Check "Remote Login" is enabled in the VM's System Settings
VM IP not showing	Wait for VM to fully boot, run `lume get openclaw` again
Lume command not found	Add `~/.local/bin` to your PATH
WhatsApp QR not scanning	Ensure you are logged into the VM (not host) when running `openclaw channels login`

주요 항목:

VPS hosting
Nodes
Gateway remote
iMessage channel
Lume Quickstart
Lume CLI Reference
Unattended VM Setup (advanced)
Docker Sandboxing (alternative isolation approach)

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/macos-vm
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

lume --version

lume create openclaw --os macos --ipsw latest

lume get openclaw

ssh youruser@192.168.64.X

macOS VMs

핵심 요약

Run OpenClaw in a sandboxed macOS VM (local or hosted) when you need isolation or iMessage

한국어 가이드 범위: install/macos-vm 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Recommended default (most users)
macOS VM options
Local VM on your Apple Silicon Mac (Lume)
Hosted Mac providers (cloud)
Quick path (Lume, experienced users)
What you need (Lume)
1) Install Lume
2) Create the macOS VM
3) Complete Setup Assistant
4) Get the VM IP address
5) SSH into the VM
6) Install OpenClaw
7) Configure channels
8) Run the VM headlessly
Bonus: iMessage integration
Save a golden image
Running 24/7
트러블슈팅
Related docs

상세 내용

Recommended default (most users)

Use a macOS VM only when you specifically need macOS-only capabilities such as iMessage, or want strict isolation from your daily Mac.

주요 항목:

Small Linux VPS for an always-on Gateway and low cost. See VPS hosting.
Dedicated hardware (Mac mini or Linux box) if you want full control and a residential IP for browser automation. Many sites block data center IPs, so local browsing often works better.
Hybrid: keep the Gateway on a cheap VPS, and connect your Mac as a node when you need browser/UI automation. See Nodes and Gateway remote.

macOS VM options

이 섹션의 세부 항목은 공식 문서 macOS VM options를 참고하세요.

Local VM on your Apple Silicon Mac (Lume)

Run OpenClaw in a sandboxed macOS VM on your existing Apple Silicon Mac using Lume. This gives you:

주요 항목:

Full macOS environment in isolation (your host stays clean)
iMessage support via imsg; the default local path is impossible on Linux/Windows
Instant reset by cloning VMs
No extra hardware or cloud costs

Hosted Mac providers (cloud)

If you want macOS in the cloud, hosted Mac providers work too:

주요 항목:

MacStadium (hosted Macs)
Other hosted Mac vendors also work; follow their VM + SSH docs

Quick path (Lume, experienced users)

Install Lume. 2. lume create openclaw --os macos --ipsw latest 3. Complete Setup Assistant, enable Remote Login (SSH). 4. lume run openclaw --no-display 5. SSH in, install OpenClaw, configure channels. 6. Done.

What you need (Lume)

주요 항목:

Apple Silicon Mac (M1/M2/M3/M4)
macOS Sequoia or later on the host
~60 GB free disk space per VM
~20 minutes

1) Install Lume

Docs: Lume Installation

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

lume --version

2) Create the macOS VM

This downloads macOS and creates the VM. A VNC window opens automatically.

lume create openclaw --os macos --ipsw latest

3) Complete Setup Assistant

Select language and region. 2. Skip Apple ID (or sign in if you want iMessage later). 3. Create a user account (remember the username and password). 4. Skip all optional features.

4) Get the VM IP address

Look for the IP address (usually 192.168.64.x).

lume get openclaw

5) SSH into the VM

Replace youruser with the account you created, and the IP with your VM's IP.

ssh youruser@192.168.64.X

6) Install OpenClaw

Follow the onboarding prompts to set up your model provider (Anthropic, OpenAI, etc.).

npm install -g openclaw@latest
openclaw onboard --install-daemon

7) Configure channels

nano ~/.openclaw/openclaw.json

{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login

8) Run the VM headlessly

The VM runs in the background; OpenClaw's daemon keeps the gateway running. To check status:

lume stop openclaw
lume run openclaw --no-display

ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage integration

This is the killer feature of running on macOS. Use iMessage with imsg to add Messages to OpenClaw.

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}

Save a golden image

Before customizing further, snapshot your clean state:

lume stop openclaw
lume clone openclaw openclaw-golden

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

Running 24/7

For true always-on, consider a dedicated Mac mini or a small VPS. See VPS hosting.

주요 항목:

Keeping your Mac plugged in
Disabling sleep in System Settings -> Energy Saver
Using caffeinate if needed

트러블슈팅

Problem	Solution
Cannot SSH into VM	Check "Remote Login" is enabled in the VM's System Settings
VM IP not showing	Wait for VM to fully boot, run `lume get openclaw` again
Lume command not found	Add `~/.local/bin` to your PATH
WhatsApp QR not scanning	Ensure you are logged into the VM (not host) when running `openclaw channels login`

주요 항목:

VPS hosting
Nodes
Gateway remote
iMessage channel
Lume Quickstart
Lume CLI Reference
Unattended VM Setup (advanced)
Docker Sandboxing (alternative isolation approach)

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/macos-vm
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

lume --version

lume create openclaw --os macos --ipsw latest

lume get openclaw

ssh youruser@192.168.64.X

macOS VMs

핵심 요약

문서 구성

상세 내용

Recommended default (most users)

macOS VM options

Local VM on your Apple Silicon Mac (Lume)

Hosted Mac providers (cloud)

Quick path (Lume, experienced users)

What you need (Lume)

1) Install Lume

2) Create the macOS VM

3) Complete Setup Assistant

4) Get the VM IP address

5) SSH into the VM

6) Install OpenClaw

7) Configure channels

8) Run the VM headlessly

Bonus: iMessage integration

Save a golden image

Running 24/7

트러블슈팅

Related docs

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

macOS VMs

핵심 요약

문서 구성

상세 내용

Recommended default (most users)

macOS VM options

Local VM on your Apple Silicon Mac (Lume)

Hosted Mac providers (cloud)

Quick path (Lume, experienced users)

What you need (Lume)

1) Install Lume

2) Create the macOS VM

3) Complete Setup Assistant

4) Get the VM IP address

5) SSH into the VM

6) Install OpenClaw

7) Configure channels

8) Run the VM headlessly

Bonus: iMessage integration

Save a golden image

Running 24/7

트러블슈팅

Related docs

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드