OpenClaw trên VM macOS (Sandboxing)¶

Mặc định được khuyến nghị (đa số người dùng)¶

VPS Linux nhỏ cho Gateway luôn hoạt động với chi phí thấp. Xem lưu trữ VPS.
Phần cứng chuyên dụng (Mac mini hoặc máy Linux) nếu bạn muốn toàn quyền kiểm soát và một IP dân dụng cho tự động hóa trình duyệt. Nhiều trang web chặn IP trung tâm dữ liệu, vì vậy duyệt web từ máy cục bộ thường hoạt động tốt hơn.
Hybrid: giữ Gateway trên một VPS giá rẻ và kết nối Mac của bạn như một node khi bạn cần tự động hóa trình duyệt/UI. Xem Nút và Gateway từ xa.

Chỉ dùng VM macOS khi bạn thực sự cần các khả năng chỉ có trên macOS (iMessage/BlueBubbles) hoặc muốn cách ly nghiêm ngặt khỏi chiếc Mac dùng hằng ngày.

Các tùy chọn VM macOS¶

VM cục bộ trên Mac Apple Silicon của bạn (Lume)¶

Chạy OpenClaw trong một VM macOS dạng sandbox trên Mac Apple Silicon hiện có bằng Lume.

Bạn sẽ có:

Môi trường macOS đầy đủ và cách ly (máy chủ của bạn luôn sạch)
Hỗ trợ iMessage qua BlueBubbles (không thể trên Linux/Windows)
Đặt lại tức thì bằng cách sao chép VM
Không cần phần cứng bổ sung hay chi phí đám mây

Nhà cung cấp Mac được host (đám mây)¶

Nếu bạn muốn macOS trên đám mây, các nhà cung cấp Mac được host cũng phù hợp:

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

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

Lộ trình nhanh (Lume, người dùng có kinh nghiệm)¶

Cài đặt Lume
lume create openclaw --os macos --ipsw latest
Hoàn tất Setup Assistant, bật Remote Login (SSH)
lume run openclaw --no-display
SSH vào, cài OpenClaw, cấu hình các kênh
Xong

Những gì bạn cần (Lume)¶

Mac Apple Silicon (M1/M2/M3/M4)
macOS Sequoia hoặc mới hơn trên máy chủ
~60 GB dung lượng trống cho 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 của bạn:

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

Xác minh:

lume --version

Tài liệu: Lume Installation

2. Tạo VM macOS¶

lume create openclaw --os macos --ipsw latest

Thao tác này tải macOS và tạo VM. A VNC window opens automatically.

Lưu ý: Việc tải có thể mất thời gian tùy thuộc vào kết nối của bạn.

3. Hoàn tất Setup Assistant¶

Trong cửa sổ VNC:

Chọn ngôn ngữ và khu vực
Bỏ qua Apple ID (hoặc đăng nhập nếu bạn muốn iMessage sau này)
Tạo tài khoản người dùng (ghi nhớ tên đăng nhập và mật khẩu)
Bỏ qua tất cả các tính năng tùy chọn

Sau khi hoàn tất, bật SSH:

Mở System Settings → General → Sharing
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 youruser@192.168.64.X

Thay youruser bằng tài khoản 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 hướng dẫn ban đầu để thiết lập nhà cung cấp mô hình của bạn (Anthropic, OpenAI, v.v.).

7. Cấu hình các kênh¶

Chỉnh sửa tệp cấu hình:

nano ~/.openclaw/openclaw.json

Thêm các kênh của 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 không giao diện¶

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 trong nền. OpenClaw's daemon keeps the gateway running.

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

ssh youruser@192.168.64.X "openclaw status"

Phần thưởng: tích hợp iMessage¶

This is the killer feature of running on macOS. Use BlueBubbles to add iMessage to OpenClaw.

Bên trong VM:

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

Thêm vào cấu hình OpenClaw của bạn:

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

Khởi động lại gateway. Now your agent can send and receive iMessages.

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

Lưu một golden image¶

Trước khi tùy biến thêm, hãy chụp snapshot trạng thái sạch:

lume stop openclaw
lume clone openclaw openclaw-golden

Đặt lại 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 bằng cách:

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

Để luôn luôn hoạt động thực sự, hãy cân nhắc một Mac mini chuyên dụng hoặc một VPS nhỏ. See VPS hosting.

Xử lý sự cố¶

Vấn đề	Giải pháp
Không SSH vào VM được	Kiểm tra "Remote Login" đã được bật trong System Settings của VM
Không thấy IP của VM	Chờ VM khởi động hoàn tất, chạy lại `lume get openclaw`
Không tìm thấy lệnh Lume	Thêm `~/.local/bin` vào PATH của bạn
Không quét được QR WhatsApp	Đảm bảo bạn đang đăng nhập trong VM (không phải máy chủ) khi chạy `openclaw channels login`

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 cách ly thay thế)

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

macOS VMs