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

# macOS 虛擬機器

## 建議預設選項（大多數使用者）

* **小型 Linux VPS**，適合常駐閘道且成本低。請參閱 [VPS 託管](/zh-TW/vps)。
* 如果你想要完整控制權，以及用於瀏覽器自動化的**住宅 IP**，請使用**專用硬體**（Mac mini 或 Linux 主機）。許多網站會封鎖資料中心 IP，因此本機瀏覽通常效果更好。
* **混合式**：將閘道放在便宜的 VPS 上，並在需要瀏覽器/UI 自動化時，將你的 Mac 連線為**節點**。請參閱 [節點](/zh-TW/nodes) 和 [遠端閘道](/zh-TW/gateway/remote)。

只有在你明確需要 macOS 專屬能力（例如 iMessage），或想要與日常使用的 Mac 嚴格隔離時，才使用 macOS VM。

## macOS VM 選項

### Apple Silicon Mac 上的本機 VM（Lume）

使用 [Lume](https://cua.ai/docs/lume) 在你現有的 Apple Silicon Mac 上，於沙盒化的 macOS VM 中執行 OpenClaw。這會提供：

* 隔離的完整 macOS 環境（你的主機保持乾淨）
* 透過 `imsg` 支援 iMessage；預設本機路徑在 Linux/Windows 上不可行
* 可透過複製 VM 立即重設
* 不需要額外硬體或雲端成本

### 託管 Mac 供應商（雲端）

如果你想在雲端使用 macOS，託管 Mac 供應商也可行：

* [MacStadium](https://www.macstadium.com/)（託管 Mac）
* 其他託管 Mac 供應商也可以；遵循他們的 VM + SSH 文件

取得 macOS VM 的 SSH 存取權後，請繼續下方的 [安裝 OpenClaw](#6-install-openclaw)。

## 快速路徑（Lume，適合有經驗的使用者）

1. 安裝 Lume。
2. `lume create openclaw --os macos --ipsw latest`
3. 完成設定輔助程式，啟用遠端登入（SSH）。
4. `lume run openclaw --no-display`
5. 透過 SSH 登入，安裝 OpenClaw，設定通道。
6. 完成。

## 你需要的項目（Lume）

* Apple Silicon Mac（M1/M2/M3/M4）
* 主機上的 macOS Sequoia 或更新版本
* 每個 VM 約 60 GB 可用磁碟空間
* 約 20 分鐘

## 1) 安裝 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)"
```

如果 `~/.local/bin` 不在你的 PATH 中：

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

驗證：

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

文件：[Lume 安裝](https://cua.ai/docs/lume/guide/getting-started/installation)

## 2) 建立 macOS VM

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume create openclaw --os macos --ipsw latest
```

這會下載 macOS 並建立 VM。VNC 視窗會自動開啟。

<Note>
  下載可能需要一段時間，取決於你的連線狀況。
</Note>

## 3) 完成設定輔助程式

在 VNC 視窗中：

1. 選擇語言和地區。
2. 跳過 Apple ID（或如果你之後想使用 iMessage，則登入）。
3. 建立使用者帳號（記住使用者名稱和密碼）。
4. 跳過所有選用功能。

設定完成後：

1. 啟用 SSH：系統設定 -> 一般 -> 共享，啟用「遠端登入」。
2. 若要以無頭方式使用 VM，請啟用自動登入：系統設定 -> 使用者與群組，選擇「自動登入為：」，並選擇 VM 使用者。

## 4) 取得 VM IP 位址

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

尋找 IP 位址（通常是 `192.168.64.x`）。

## 5) 透過 SSH 連入 VM

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh youruser@192.168.64.X
```

將 `youruser` 替換為你建立的帳號，並將 IP 替換為你的 VM IP。

## 6) 安裝 OpenClaw

在 VM 內：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
openclaw onboard --install-daemon
```

依照上線設定提示，設定你的模型供應商（Anthropic、OpenAI 等）。

## 7) 設定通道

編輯設定檔：

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

新增你的通道：

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

接著登入 WhatsApp（掃描 QR）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login
```

## 8) 以無頭方式執行 VM

停止 VM，然後在沒有顯示器的情況下重新啟動：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lume stop openclaw
lume run openclaw --no-display
```

VM 會在背景執行；OpenClaw 的 daemon 會讓閘道保持執行。若要檢查狀態：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh youruser@192.168.64.X "openclaw status"
```

## 額外功能：iMessage 整合

這是在 macOS 上執行的最大亮點。使用 [iMessage](/zh-TW/channels/imessage) 搭配 `imsg`，將 Messages 加入 OpenClaw。

在 VM 內：

1. 登入 Messages。
2. 安裝 `imsg`。
3. 授予執行 OpenClaw/`imsg` 的程序完整磁碟取用權與自動化權限。
4. 使用 `imsg rpc --help` 驗證 RPC 支援。

加入你的 OpenClaw 設定：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
```

重新啟動閘道。你的代理現在可以傳送和接收 iMessage。完整設定細節：[iMessage 通道](/zh-TW/channels/imessage)。

## 儲存黃金映像

在進一步自訂之前，先為乾淨狀態建立快照：

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

隨時重設：

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

## 24/7 執行

透過以下方式讓 VM 保持執行：

* 讓你的 Mac 保持接上電源
* 在系統設定 -> 節能中停用睡眠
* 需要時使用 `caffeinate`

若要真正常駐，請考慮使用專用 Mac mini 或小型 VPS。請參閱 [VPS 託管](/zh-TW/vps)。

## 疑難排解

| 問題               | 解決方案                                           |
| ---------------- | ---------------------------------------------- |
| 無法透過 SSH 連入 VM   | 確認 VM 的系統設定中已啟用「遠端登入」                          |
| VM IP 未顯示        | 等待 VM 完全開機，然後再次執行 `lume get openclaw`          |
| 找不到 Lume 命令      | 將 `~/.local/bin` 加入你的 PATH                     |
| WhatsApp QR 無法掃描 | 執行 `openclaw channels login` 時，確認你已登入 VM（不是主機） |

## 相關文件

* [VPS 託管](/zh-TW/vps)
* [節點](/zh-TW/nodes)
* [遠端閘道](/zh-TW/gateway/remote)
* [iMessage 通道](/zh-TW/channels/imessage)
* [Lume 快速入門](https://cua.ai/docs/lume/guide/getting-started/quickstart)
* [Lume 命令列介面參考](https://cua.ai/docs/lume/reference/cli-reference)
* [無人值守 VM 設定](https://cua.ai/docs/lume/guide/fundamentals/unattended-setup)（進階）
* [Docker 沙盒化](/zh-TW/install/docker)（替代隔離方式）