Langsung ke konten utama

OpenClaw di macOS VM (Sandboxing)

Default yang direkomendasikan (sebagian besar pengguna)

  • Linux VPS kecil untuk Gateway yang selalu aktif dan biaya rendah. Lihat hosting VPS.
  • Perangkat keras khusus (Mac mini atau kotak Linux) jika Anda menginginkan kontrol penuh dan IP residensial untuk otomasi browser. Banyak situs memblokir IP pusat data, jadi browsing lokal sering kali bekerja lebih baik.
  • Hybrid: simpan Gateway di VPS murah, lalu hubungkan Mac Anda sebagai node saat Anda memerlukan otomasi browser/UI. Lihat Nodes dan Gateway remote.
Gunakan macOS VM saat Anda secara khusus memerlukan kemampuan khusus macOS (iMessage/BlueBubbles) atau menginginkan isolasi ketat dari Mac harian Anda.

Opsi macOS VM

VM lokal di Apple Silicon Mac Anda (Lume)

Jalankan OpenClaw di macOS VM yang tersandbox pada Apple Silicon Mac Anda saat ini menggunakan Lume. Ini memberi Anda:
  • Lingkungan macOS lengkap dalam isolasi (host Anda tetap bersih)
  • Dukungan iMessage melalui BlueBubbles (mustahil di Linux/Windows)
  • Reset instan dengan melakukan clone VM
  • Tanpa biaya perangkat keras tambahan atau cloud

Provider Mac hosted (cloud)

Jika Anda menginginkan macOS di cloud, provider Mac hosted juga bisa digunakan:
  • MacStadium (Mac hosted)
  • Vendor Mac hosted lain juga bisa digunakan; ikuti dokumentasi VM + SSH mereka
Setelah Anda memiliki akses SSH ke macOS VM, lanjutkan ke langkah 6 di bawah.

Jalur cepat (Lume, pengguna berpengalaman)

  1. Pasang Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Selesaikan Setup Assistant, aktifkan Remote Login (SSH)
  4. lume run openclaw --no-display
  5. SSH masuk, pasang OpenClaw, konfigurasikan channel
  6. Selesai

Yang Anda butuhkan (Lume)

  • Apple Silicon Mac (M1/M2/M3/M4)
  • macOS Sequoia atau yang lebih baru di host
  • ~60 GB ruang disk kosong per VM
  • ~20 menit

1) Pasang Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
Jika ~/.local/bin belum ada di PATH Anda:
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Verifikasi:
lume --version
Dokumentasi: Lume Installation

2) Buat macOS VM

lume create openclaw --os macos --ipsw latest
Ini mengunduh macOS dan membuat VM. Jendela VNC akan terbuka secara otomatis. Catatan: Unduhan dapat memakan waktu cukup lama tergantung koneksi Anda.

3) Selesaikan Setup Assistant

Di jendela VNC:
  1. Pilih bahasa dan region
  2. Lewati Apple ID (atau masuk jika Anda menginginkan iMessage nanti)
  3. Buat akun pengguna (ingat nama pengguna dan kata sandinya)
  4. Lewati semua fitur opsional
Setelah penyiapan selesai, aktifkan SSH:
  1. Buka System Settings → General → Sharing
  2. Aktifkan “Remote Login”

4) Dapatkan alamat IP VM

lume get openclaw
Cari alamat IP-nya (biasanya 192.168.64.x).

5) SSH ke VM

ssh youruser@192.168.64.X
Ganti youruser dengan akun yang Anda buat, dan IP dengan IP VM Anda.

6) Pasang OpenClaw

Di dalam VM:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Ikuti prompt onboarding untuk menyiapkan provider model Anda (Anthropic, OpenAI, dll.).

7) Konfigurasikan channel

Edit file konfigurasi:
nano ~/.openclaw/openclaw.json
Tambahkan channel Anda:
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
Lalu login ke WhatsApp (pindai QR):
openclaw channels login

8) Jalankan VM tanpa tampilan

Hentikan VM lalu jalankan ulang tanpa tampilan:
lume stop openclaw
lume run openclaw --no-display
VM berjalan di latar belakang. daemon OpenClaw menjaga gateway tetap berjalan. Untuk memeriksa status:
ssh youruser@192.168.64.X "openclaw status"

Bonus: integrasi iMessage

Inilah fitur utama menjalankan di macOS. Gunakan BlueBubbles untuk menambahkan iMessage ke OpenClaw. Di dalam VM:
  1. Unduh BlueBubbles dari bluebubbles.app
  2. Masuk dengan Apple ID Anda
  3. Aktifkan Web API dan setel kata sandi
  4. Arahkan webhook BlueBubbles ke gateway Anda (contoh: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)
Tambahkan ke konfigurasi OpenClaw Anda:
{
  channels: {
    bluebubbles: {
      serverUrl: "http://localhost:1234",
      password: "your-api-password",
      webhookPath: "/bluebubbles-webhook",
    },
  },
}
Mulai ulang gateway. Sekarang agen Anda dapat mengirim dan menerima iMessage. Detail penyiapan lengkap: channel BlueBubbles

Simpan golden image

Sebelum menyesuaikan lebih jauh, ambil snapshot state bersih Anda:
lume stop openclaw
lume clone openclaw openclaw-golden
Reset kapan saja:
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

Menjalankan 24/7

Jaga VM tetap berjalan dengan:
  • Menjaga Mac Anda tetap terhubung ke daya
  • Menonaktifkan mode tidur di System Settings → Energy Saver
  • Menggunakan caffeinate jika diperlukan
Untuk benar-benar selalu aktif, pertimbangkan Mac mini khusus atau VPS kecil. Lihat hosting VPS.

Pemecahan masalah

MasalahSolusi
Tidak bisa SSH ke VMPeriksa bahwa “Remote Login” diaktifkan di System Settings VM
IP VM tidak munculTunggu sampai VM selesai boot, lalu jalankan lume get openclaw lagi
Perintah Lume tidak ditemukanTambahkan ~/.local/bin ke PATH Anda
QR WhatsApp tidak bisa dipindaiPastikan Anda login ke VM (bukan host) saat menjalankan openclaw channels login

Dokumentasi terkait