macOS 虚拟机

macOS VM 选项

Apple Silicon Mac 上的本地 VM（Lume）

使用 Lume，在现有 Apple Silicon Mac 上的沙箱隔离 macOS VM 中运行 OpenClaw。这样可以获得：

隔离的完整 macOS 环境（保持宿主机整洁）
通过 imsg 支持 iMessage；默认本地路径无法在 Linux/Windows 上使用
通过克隆 VM 即时重置
无需额外硬件或云服务费用

托管式 Mac 提供商（云端）

如果希望在云端使用 macOS，也可以选择托管式 Mac 提供商：

MacStadium（托管式 Mac）
其他托管式 Mac 供应商也可以使用；请遵循其 VM + SSH 文档

获得 macOS VM 的 SSH 访问权限后，继续执行下方的安装 OpenClaw。

快速路径（Lume，适合有经验的用户）

安装 Lume。
lume create openclaw --os macos --ipsw latest
完成 Setup Assistant，启用 Remote Login（SSH）。
lume run openclaw --no-display
通过 SSH 登录，安装 OpenClaw，并配置渠道。
完成。

所需条件（Lume）

Apple Silicon Mac（M1/M2/M3/M4）
宿主机运行 macOS Sequoia 或更高版本
每个 VM 约需 60 GB 可用磁盘空间
约 20 分钟

1) 安装 Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

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

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

验证：

lume --version

文档：Lume 安装

2) 创建 macOS VM

lume create openclaw --os macos --ipsw latest

这会下载 macOS 并创建 VM。VNC 窗口将自动打开。

下载可能需要一些时间，具体取决于网络连接。

3) 完成 Setup Assistant

在 VNC 窗口中：

选择语言和地区。
跳过 Apple ID（如果之后想使用 iMessage，也可以登录）。
创建用户账户（记住用户名和密码）。
跳过所有可选功能。

设置完成后：

启用 SSH：System Settings -> General -> Sharing，启用 “Remote Login”。
如需以无头模式使用 VM，请启用自动登录：System Settings -> Users & Groups，选择 “Automatically log in as:“，然后选择 VM 用户。

4) 获取 VM IP 地址

lume get openclaw

查找 IP 地址（通常为 192.168.64.x）。

5) 通过 SSH 登录 VM

ssh youruser@192.168.64.X

将 youruser 替换为创建的账户，并将 IP 替换为 VM 的 IP。

6) 安装 OpenClaw

在 VM 内：

npm install -g openclaw@latest
openclaw onboard --install-daemon

按照新手引导提示设置模型提供商（Anthropic、OpenAI 等）。

7) 配置渠道

编辑配置文件：

nano ~/.openclaw/openclaw.json

添加渠道：

{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

然后登录 WhatsApp（扫描二维码）：

openclaw channels login

8) 以无头模式运行 VM

停止 VM，然后在不显示界面的情况下重新启动：

lume stop openclaw
lume run openclaw --no-display

VM 会在后台运行；OpenClaw 守护进程会让 Gateway 网关持续运行。检查状态：

ssh youruser@192.168.64.X "openclaw status"

额外功能：iMessage 集成

这是在 macOS 上运行的杀手级功能。使用 iMessage 和 imsg 将 Messages 添加到 OpenClaw。在 VM 内：

登录 Messages。
安装 imsg。
为运行 OpenClaw/imsg 的进程授予 Full Disk Access 和 Automation 权限。
使用 imsg rpc --help 验证 RPC 支持。

添加到 OpenClaw 配置：

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}

重启 Gateway 网关。智能体现在可以发送和接收 iMessage。完整设置详情：iMessage 渠道。

保存黄金镜像

进一步自定义之前，请为干净状态创建快照：

lume stop openclaw
lume clone openclaw openclaw-golden

随时重置：

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

运行 24/7

通过以下方式保持 VM 运行：

保持 Mac 接通电源
在 System Settings -> Energy Saver 中禁用睡眠
需要时使用 caffeinate

如需真正保持始终在线，请考虑使用专用 Mac mini 或小型 VPS。请参阅 VPS 托管。

故障排查

问题	解决方案
无法通过 SSH 登录 VM	检查 VM 的 System Settings 中是否已启用 “Remote Login”
未显示 VM IP	等待 VM 完全启动，然后再次运行 `lume get openclaw`
找不到 Lume 命令	将 `~/.local/bin` 添加到 PATH
WhatsApp 二维码无法扫描	运行 `openclaw channels login` 时，确保登录的是 VM（而非宿主机）

安装概览

维护

安装方式

托管与部署

Advanced setup

推荐默认方案（适合大多数用户）

macOS VM 选项

Apple Silicon Mac 上的本地 VM（Lume）

托管式 Mac 提供商（云端）

快速路径（Lume，适合有经验的用户）

所需条件（Lume）

1) 安装 Lume

2) 创建 macOS VM

3) 完成 Setup Assistant

4) 获取 VM IP 地址

5) 通过 SSH 登录 VM

6) 安装 OpenClaw

7) 配置渠道

8) 以无头模式运行 VM

额外功能：iMessage 集成

保存黄金镜像

运行 24/7

故障排查

相关文档

​推荐默认方案（适合大多数用户）

​macOS VM 选项

​Apple Silicon Mac 上的本地 VM（Lume）

​托管式 Mac 提供商（云端）

​快速路径（Lume，适合有经验的用户）

​所需条件（Lume）

​1) 安装 Lume

​2) 创建 macOS VM

​3) 完成 Setup Assistant

​4) 获取 VM IP 地址

​5) 通过 SSH 登录 VM

​6) 安装 OpenClaw

​7) 配置渠道

​8) 以无头模式运行 VM

​额外功能：iMessage 集成

​保存黄金镜像

​运行 24/7

​故障排查

​相关文档

推荐默认方案（适合大多数用户）

macOS VM 选项

Apple Silicon Mac 上的本地 VM（Lume）

托管式 Mac 提供商（云端）

快速路径（Lume，适合有经验的用户）

所需条件（Lume）

1) 安装 Lume

2) 创建 macOS VM

3) 完成 Setup Assistant

4) 获取 VM IP 地址

5) 通过 SSH 登录 VM

6) 安装 OpenClaw

7) 配置渠道

8) 以无头模式运行 VM

额外功能：iMessage 集成

保存黄金镜像

运行 24/7

故障排查

相关文档