OpenClawSkills
GitHub
Platforms • TutorialHeader.readTime

macOS VMs

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

Tutorial.step

Recommended default (most users)

- ''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''.

Use a macOS VM when you specifically need macOS-only capabilities (iMessage/BlueBubbles) or want strict isolation from your daily Mac.

Tutorial.step

macOS VM options

#

Tutorial.step

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 BlueBubbles (impossible on Linux/Windows)

- Instant reset by cloning VMs

- No extra hardware or cloud costs

#

Tutorial.step

Hosted Mac providers (cloud)

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

- ''MacStadium'' (hosted Macs)

- Other hosted Mac vendors also work; follow their VM + SSH docs

Once you have SSH access to a macOS VM, continue at step 6 below.

Tutorial.step

What you need (Lume)

- Apple Silicon Mac (M1/M2/M3/M4)

- macOS Sequoia or later on host

- ~60 GB free disk space per VM

- ~20 minutes

Tutorial.step

2) Create macOS VM

Bash
lume create openclaw --os macos --ipsw latest

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

Note: The download can take a while depending on your connection.

Tutorial.step

4) Get VM's IP address

Bash
lume get openclaw

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

Tutorial.step

6) Install OpenClaw

Inside the VM:

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

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

Tutorial.step

8) Run the VM headlessly

Stop the VM and restart without display:

Bash
lume stop openclaw
lume run openclaw --no-display

The VM runs in the background. OpenClaw's daemon keeps the gateway running.

To check status:

Bash
ssh [email protected] "openclaw status"
Tutorial.step

Save a golden image

Before customizing further, snapshot your clean state:

Bash
lume stop openclaw
lume clone openclaw openclaw-golden

Reset anytime:

Bash
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display
Tutorial.step

Troubleshooting

| Problem | Solution |

| |

Tutorial.step

Related docs