Chuyển đến nội dung chính

OpenClaw trên VM macOS (Sandboxing)

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

  • Small Linux VPS for an always-on Gateway and low cost. See VPS hosting.
  • 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: 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.
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)

  1. Cài đặt Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Hoàn tất Setup Assistant, bật Remote Login (SSH)
  4. lume run openclaw --no-display
  5. SSH vào, cài OpenClaw, cấu hình các kênh
  6. 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:
  1. Chọn ngôn ngữ và khu vực
  2. Bỏ qua Apple ID (hoặc đăng nhập nếu bạn muốn iMessage sau này)
  3. Tạo tài khoản người dùng (ghi nhớ tên đăng nhập và mật khẩu)
  4. Bỏ qua tất cả các tính năng tùy chọn
Sau khi hoàn tất, 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

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 [email protected] "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:
  1. Tải BlueBubbles từ bluebubbles.app
  2. Đăng nhập bằng Apple ID của bạn
  3. Bật Web API và đặt mật khẩu
  4. 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 đượcKiểm tra “Remote Login” đã được bật trong System Settings của VM
Không thấy IP của VMChờ VM khởi động hoàn tất, chạy lại lume get openclaw
Không tìm thấy lệnh LumeThê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