OpenClaw trên macOS VMs (Sandboxing)

Khuyến nghị mặc định (cho hầu hết người dùng)

• Linux VPS nhỏ để chạy Gateway 24/7 với chi phí thấp. Xem VPS hosting.
• Phần cứng riêng (Mac mini hoặc máy Linux) nếu các bạn muốn kiểm soát hoàn toàn và có IP dân cư cho browser automation. Nhiều trang web chặn IP data center, nên duyệt web local thường hoạt động tốt hơn.
• Hybrid: giữ Gateway trên VPS rẻ, và kết nối Mac của các bạn như một node khi cần browser/UI automation. Xem Nodes và Gateway remote.

Dùng macOS VM khi các bạn cần các tính năng chỉ có trên macOS (iMessage/BlueBubbles) hoặc muốn tách biệt hoàn toàn khỏi Mac hàng ngày.

Các lựa chọn macOS VM

VM local trên Apple Silicon Mac (Lume)

Chạy OpenClaw trong macOS VM sandbox trên Apple Silicon Mac hiện tại của các bạn bằng Lume.

Điều này cho các bạn:

• Môi trường macOS đầy đủ được tách biệt (máy chủ vẫn sạch sẽ)
• Hỗ trợ iMessage qua BlueBubbles (không thể trên Linux/Windows)
• Reset ngay lập tức bằng cách clone VM
• Không tốn thêm phần cứng hay chi phí cloud

Nhà cung cấp Mac cloud (hosted)

Nếu các bạn muốn macOS trên cloud, các nhà cung cấp Mac hosted cũng hoạt động tốt:

• MacStadium (hosted Macs)
• Các nhà cung cấp Mac hosted khác cũng được; làm theo tài liệu VM + SSH của họ

Khi đã có quyền truy cập SSH vào macOS VM, tiếp tục ở bước 6 bên dưới.

Hướng dẫn nhanh (Lume, cho người có kinh nghiệm)

1. Cài đặt Lume
2. lume create openclaw --os macos --ipsw latest
3. Hoàn thành Setup Assistant, bật Remote Login (SSH)
4. lume run openclaw --no-display
5. SSH vào, cài OpenClaw, cấu hình channels
6. Xong

Yêu cầu (Lume)

• Apple Silicon Mac (M1/M2/M3/M4)
• macOS Sequoia trở lên trên máy chủ
• ~60 GB dung lượng trống mỗi VM
• ~20 phút

1) Cài đặt Lume

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

Nếu ~/.local/bin chưa có trong PATH:

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

Kiểm tra:

lume --version

Tài liệu: Lume Installation

2) Tạo macOS VM

lume create openclaw --os macos --ipsw latest

Lệnh này sẽ tải macOS và tạo VM. Cửa sổ VNC sẽ tự động mở.

Lưu ý: Quá trình tải có thể mất một lúc tùy vào kết nối mạng của các bạn.

3) Hoàn thành Setup Assistant

Trong cửa sổ VNC:

1. Chọn ngôn ngữ và khu vực
2. Bỏ qua Apple ID (hoặc đăng nhập nếu muốn dùng iMessage sau)
3. Tạo tài khoản người dùng (nhớ username và password)
4. Bỏ qua tất cả các tính năng tùy chọn

Sau khi setup xong, bật SSH:

1. Mở System Settings → General → Sharing
2. Bật “Remote Login”

4) Lấy địa chỉ IP của VM

lume get openclaw

Tìm địa chỉ IP (thường là 192.168.64.x).

5) SSH vào VM

ssh [email protected]

Thay youruser bằng tài khoản các bạn đã tạo, và IP bằng IP của VM.

6) Cài đặt OpenClaw

Bên trong VM:

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

Làm theo các bước onboarding để thiết lập model provider (Anthropic, OpenAI, v.v.).

7) Cấu hình channels

Chỉnh sửa file config:

nano ~/.openclaw/openclaw.json

Thêm channels của các bạn:

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

Sau đó đăng nhập WhatsApp (quét QR):

openclaw channels login

8) Chạy VM ở chế độ headless

Dừng VM và khởi động lại không có màn hình:

lume stop openclaw
lume run openclaw --no-display

VM chạy ở chế độ nền. Daemon của OpenClaw giữ cho gateway tiếp tục hoạt động.

Để kiểm tra trạng thái:

ssh [email protected] "openclaw status"

Bonus: Tích hợp iMessage

Đây là tính năng đặc biệt khi chạy trên macOS. Dùng BlueBubbles để thêm iMessage vào OpenClaw.

Bên trong VM:

1. Tải BlueBubbles từ bluebubbles.app
2. Đăng nhập bằng Apple ID
3. Bật Web API và đặt password
4. Trỏ BlueBubbles webhooks về gateway của các bạn (ví dụ: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Thêm vào config OpenClaw:

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

Khởi động lại gateway. Giờ agent của các bạn có thể gửi và nhận iMessages.

Chi tiết thiết lập đầy đủ: BlueBubbles channel

Lưu golden image

Trước khi tùy chỉnh thêm, snapshot trạng thái sạch:

lume stop openclaw
lume clone openclaw openclaw-golden

Reset bất cứ lúc nào:

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

Chạy 24/7

Giữ VM chạy liên tục bằng cách:

• Cắm điện Mac
• Tắt chế độ ngủ trong System Settings → Energy Saver
• Dùng caffeinate nếu cần

Để chạy thực sự 24/7, các bạn nên xem xét Mac mini riêng hoặc VPS nhỏ. Xem VPS hosting.

Troubleshooting

Tài liệu liên quan

• VPS hosting
• Nodes
• Gateway remote
• BlueBubbles channel
• Lume Quickstart
• Lume CLI Reference
• Unattended VM Setup (nâng cao)
• Docker Sandboxing (cách tiếp cận tách biệt khác)