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

Mặc định được khuyến nghị (hầu hết người dùng)

  • VPS Linux nhỏ để chạy Gateway luôn bật 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 cư cho tự động hóa trình duyệt. Nhiều trang chặn IP trung tâm dữ liệu, nên duyệt cục bộ thường hoạt động tốt hơn.
  • Kết hợp: giữ Gateway trên một VPS giá rẻ, và kết nối máy Mac của bạn làm Node khi cần tự động hóa trình duyệt/giao diện người dùng. Xem NodeGateway từ xa.
Dùng VM macOS khi bạn cần riêng các khả năng chỉ có trên macOS như iMessage hoặc muốn cách ly chặt chẽ khỏi máy Mac dùng hằng ngày.

Tùy chọn VM macOS

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

Chạy OpenClaw trong một VM macOS được sandbox trên máy Mac Apple Silicon hiện có của bạn bằng Lume. Điều này mang lại cho bạn:
  • Môi trường macOS đầy đủ trong trạng thái cách ly (máy chủ của bạn vẫn sạch)
  • Hỗ trợ iMessage qua imsg (đường dẫn cục bộ mặc định là không thể trên Linux/Windows)
  • Đặt lại tức thì bằng cách nhân bản VM
  • Không cần thêm phần cứng hoặc chi phí đám mây

Nhà cung cấp Mac lưu trữ (đám mây)

Nếu bạn muốn dùng macOS trên đám mây, các nhà cung cấp Mac lưu trữ cũng hoạt động:
  • MacStadium (Mac được lưu trữ)
  • Các nhà cung cấp Mac lưu trữ khác cũng hoạt động; làm theo tài liệu VM + SSH của họ
Khi bạn có quyền truy cập SSH vào một VM macOS, tiếp tục ở bước 6 bên dưới.

Đường dẫn 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 Trợ lý thiết lập, bật Đăng nhập từ xa (SSH)
  4. lume run openclaw --no-display
  5. SSH vào, cài đặt OpenClaw, cấu hình các kênh
  6. Hoàn tất

Bạn cần gì (Lume)

  • Máy Mac Apple Silicon (M1/M2/M3/M4)
  • macOS Sequoia hoặc mới hơn trên máy chủ
  • Khoảng 60 GB dung lượng đĩa trống cho mỗi VM
  • Khoảng 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: Cài đặt Lume

2) Tạo VM macOS

lume create openclaw --os macos --ipsw latest
Lệnh này tải macOS xuống và tạo VM. Một cửa sổ VNC sẽ tự động mở.
Quá trình tải xuống có thể mất một lúc tùy thuộc vào kết nối của bạn.

3) Hoàn tất Trợ lý thiết lập

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 dùng iMessage sau)
  3. Tạo tài khoản người dùng (nhớ tên người dùng và mật khẩu)
  4. Bỏ qua tất cả tính năng tùy chọn
Sau khi thiết lập hoàn tất:
  1. Bật SSH: Mở Cài đặt Hệ thống -> Cài đặt chung -> Chia sẻ và bật “Đăng nhập từ xa”.
  2. Để dùng VM không có giao diện hiển thị, bật tự động đăng nhập: Mở Cài đặt Hệ thống -> Người dùng & Nhóm, chọn “Tự động đăng nhập dưới dạng:”, rồi chọn người dùng VM.

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à thay 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 lời nhắc onboarding để thiết lập nhà cung cấp mô hình của bạn (Anthropic, OpenAI, v.v.).

7) Cấu hình 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 vào WhatsApp (quét QR):
openclaw channels login

8) Chạy VM ở chế độ không có giao diện hiển thị

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. Daemon của OpenClaw giữ Gateway tiếp tục chạy. Để kiểm tra trạng thái:
ssh youruser@192.168.64.X "openclaw status"

Phần bổ sung: tích hợp iMessage

Đây là tính năng nổi bật nhất của việc chạy trên macOS. Dùng iMessage với imsg để thêm Messages vào OpenClaw. Bên trong VM:
  1. Đăng nhập vào Messages.
  2. Cài đặt imsg.
  3. Cấp quyền Truy cập toàn bộ đĩa và Tự động hóa cho tiến trình đang chạy OpenClaw/imsg.
  4. Xác minh hỗ trợ RPC bằng imsg rpc --help.
Thêm vào cấu hình OpenClaw của bạn:
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
Khởi động lại Gateway. Giờ đây agent của bạn có thể gửi và nhận iMessage. Chi tiết thiết lập đầy đủ: kênh iMessage

Lưu ảnh vàng

Trước khi tùy chỉnh thêm, hãy chụp nhanh trạng thái sạch của bạn:
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:
  • Luôn cắm nguồn máy Mac
  • Tắt chế độ ngủ trong Cài đặt Hệ thống → Trình tiết kiệm năng lượng
  • Dùng caffeinate nếu cần
Để thực sự luôn bật, hãy cân nhắc một Mac mini chuyên dụng hoặc một VPS nhỏ. Xem lưu trữ VPS.

Khắc phục sự cố

Vấn đềGiải pháp
Không thể SSH vào VMKiểm tra “Đăng nhập từ xa” đã được bật trong Cài đặt Hệ thống của VM
IP VM không hiển thịChờ 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
QR WhatsApp không quét đượcĐảm bảo bạn đã đăng nhập vào VM (không phải máy chủ) khi chạy openclaw channels login

Tài liệu liên quan