> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Máy ảo macOS

## 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](/vi/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 [Node](/vi/nodes) và [Gateway từ xa](/vi/gateway/remote).

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](https://cua.ai/docs/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](https://www.macstadium.com/) (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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
/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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
```

Xác minh:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume --version
```

Tài liệu: [Cài đặt Lume](https://cua.ai/docs/lume/guide/getting-started/installation)

***

## 2) Tạo VM macOS

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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ở.

<Note>
  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.
</Note>

***

## 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume get openclaw
```

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

***

## 5) SSH vào VM

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nano ~/.openclaw/openclaw.json
```

Thêm các kênh của bạn:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/vi/channels/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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/vi/channels/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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume stop openclaw
lume clone openclaw openclaw-golden
```

Đặt lại bất cứ lúc nào:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/vi/vps).

***

## Khắc phục sự cố

| Vấn đề                      | Giải pháp                                                                               |
| --------------------------- | --------------------------------------------------------------------------------------- |
| Không thể SSH vào VM        | Kiể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 Lume    | Thê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

* [lưu trữ VPS](/vi/vps)
* [Node](/vi/nodes)
* [Gateway từ xa](/vi/gateway/remote)
* [kênh iMessage](/vi/channels/imessage)
* [Khởi động nhanh Lume](https://cua.ai/docs/lume/guide/getting-started/quickstart)
* [Tham chiếu CLI Lume](https://cua.ai/docs/lume/reference/cli-reference)
* [Thiết lập VM không giám sát](https://cua.ai/docs/lume/guide/fundamentals/unattended-setup) (nâng cao)
* [Sandboxing bằng Docker](/vi/install/docker) (cách cách ly thay thế)