OpenClaw sa macOS VMs (Sandboxing)¶

Inirerekomendang default (para sa karamihan ng user)¶

Maliit na Linux VPS para sa laging-on na Gateway at mababang gastos. Tingnan ang VPS hosting.
Dedicated hardware (Mac mini o Linux box) kung gusto mo ng ganap na kontrol at isang residential IP para sa browser automation. Maraming site ang nagba-block ng mga data center IP, kaya madalas mas gumagana ang lokal na pagba-browse.
Hybrid: panatilihin ang Gateway sa murang VPS, at ikonekta ang iyong Mac bilang isang node kapag kailangan mo ng browser/UI automation. Tingnan ang Nodes at Gateway remote.

Gumamit ng macOS VM kapag partikular mong kailangan ang macOS-only na kakayahan (iMessage/BlueBubbles) o gusto mo ng mahigpit na isolation mula sa iyong pang-araw-araw na Mac.

Mga opsyon sa macOS VM¶

Lokal na VM sa iyong Apple Silicon Mac (Lume)¶

Patakbuhin ang OpenClaw sa isang sandboxed macOS VM sa iyong kasalukuyang Apple Silicon Mac gamit ang Lume.

Ibinibigay nito sa iyo ang:

Buong macOS environment na hiwalay (mananatiling malinis ang iyong host)
Suporta sa iMessage sa pamamagitan ng BlueBubbles (imposible sa Linux/Windows)
Agarang reset sa pamamagitan ng pag-clone ng mga VM
Walang karagdagang hardware o gastos sa cloud

Mga hosted Mac provider (cloud)¶

Kung gusto mo ng macOS sa cloud, gumagana rin ang mga hosted Mac provider:

MacStadium (mga hosted Mac)
Gumagana rin ang ibang hosted Mac vendor; sundin ang kanilang mga doc para sa VM + SSH

Kapag may SSH access ka na sa isang macOS VM, magpatuloy sa hakbang 6 sa ibaba.

Mabilis na ruta (Lume, bihasang user)¶

I-install ang Lume
lume create openclaw --os macos --ipsw latest
Kumpletuhin ang Setup Assistant, i-enable ang Remote Login (SSH)
lume run openclaw --no-display
Mag-SSH, i-install ang OpenClaw, i-configure ang mga channel
Tapos

Mga kailangan (Lume)¶

Apple Silicon Mac (M1/M2/M3/M4)
macOS Sequoia o mas bago sa host
~60 GB na libreng disk space bawat VM
~20 minuto

1. I-install ang Lume¶

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

Kung ang ~/.local/bin ay wala sa iyong PATH:

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

I-verify:

lume --version

Dokumentasyon: Pag-install ng Lume

2. Lumikha ng macOS VM¶

lume create openclaw --os macos --ipsw latest

I-da-download nito ang macOS at lilikha ng VM. Awtomatikong magbubukas ang isang VNC window.

Tandaan: Maaaring magtagal ang pag-download depende sa iyong koneksyon.

3. Kumpletuhin ang Setup Assistant¶

Sa VNC window:

Piliin ang wika at rehiyon
I-skip ang Apple ID (o mag-sign in kung gusto mo ng iMessage sa kalaunan)
Gumawa ng user account (tandaan ang username at password)
I-skip ang lahat ng opsyonal na feature

Pagkatapos makumpleto ang setup, i-enable ang SSH:

Buksan ang System Settings → General → Sharing
I-enable ang "Remote Login"

4. Kunin ang IP address ng VM¶

lume get openclaw

Hanapin ang IP address (karaniwan ay 192.168.64.x).

5. Mag-SSH papunta sa VM¶

ssh youruser@192.168.64.X

Palitan ang youruser ng account na ginawa mo, at ang IP ng IP ng iyong VM.

6. I-install ang OpenClaw¶

Sa loob ng VM:

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

Sundin ang mga onboarding prompt para i-set up ang iyong model provider (Anthropic, OpenAI, atbp.).

7. I-configure ang mga channel¶

I-edit ang config file:

nano ~/.openclaw/openclaw.json

Idagdag ang iyong mga channel:

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

Pagkatapos ay mag-login sa WhatsApp (i-scan ang QR):

openclaw channels login

8. Patakbuhin ang VM nang headless¶

Itigil ang VM at i-restart nang walang display:

lume stop openclaw
lume run openclaw --no-display

Tumatakbo ang VM sa background. Pinananatiling tumatakbo ng daemon ng OpenClaw ang gateway.

Para tingnan ang status:

ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage integration¶

Ito ang killer feature ng pagtakbo sa macOS. Gamitin ang BlueBubbles upang idagdag ang iMessage sa OpenClaw.

Sa loob ng VM:

I-download ang BlueBubbles mula sa bluebubbles.app
Mag-sign in gamit ang iyong Apple ID
I-enable ang Web API at magtakda ng password
Ituro ang mga webhook ng BlueBubbles sa iyong gateway (halimbawa: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Idagdag sa iyong OpenClaw config:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

I-restart ang Gateway. Ngayon ay makakapagpadala at makakatanggap na ng iMessages ang iyong agent.

Buong detalye ng setup: BlueBubbles channel

Mag-save ng golden image¶

Bago mag-customize pa, i-snapshot ang iyong malinis na estado:

lume stop openclaw
lume clone openclaw openclaw-golden

Mag-reset anumang oras:

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

Pagpapatakbo 24/7¶

Panatilihing tumatakbo ang VM sa pamamagitan ng:

Pagpapanatiling naka-plug in ang iyong Mac
Pag-disable ng sleep sa System Settings → Energy Saver
Paggamit ng caffeinate kung kinakailangan

Para sa tunay na laging-on, isaalang-alang ang isang dedicated Mac mini o isang maliit na VPS. Tingnan ang VPS hosting.

Pag-troubleshoot¶

Problema	Solusyon
Hindi makapag-SSH sa VM	Tiyaking naka-enable ang "Remote Login" sa System Settings ng VM
Hindi lumalabas ang VM IP	Hintaying ganap na mag-boot ang VM, patakbuhin muli ang `lume get openclaw`
Hindi makita ang Lume command	Idagdag ang `~/.local/bin` sa iyong PATH
Hindi ma-scan ang WhatsApp QR	Tiyaking naka-login ka sa VM (hindi sa host) kapag pinapatakbo ang `openclaw channels login`

Kaugnay na docs¶

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

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

macOS VMs