macOS VMs
推荐默认配置(大多数用户)¶
- 小型 Linux VPS:用于始终保持在线且成本低廉的 Gateway。参见 VPS 托管。
- 专用硬件(Mac mini 或 Linux 主机):如果你想要完全控制权,以及用于浏览器自动化的住宅 IP。许多网站会屏蔽数据中心 IP,因此本地浏览通常效果更好。
- 混合方案:将 Gateway 放在便宜的 VPS 上,并在需要浏览器/UI 自动化时,将你的 Mac 作为节点连接。参见 节点 和 远程 Gateway。
只有在确实需要 macOS 专属功能(如 iMessage),或希望与日常使用的 Mac 严格隔离时,才使用 macOS 虚拟机。
macOS 虚拟机选项¶
在 Apple Silicon Mac 上运行本地虚拟机(Lume)¶
使用 Lume 在你现有的 Apple Silicon Mac 上运行一个沙盒化的 macOS 虚拟机,并在其中运行 OpenClaw。这样可以获得:
- 完全独立的 macOS 环境(你的主机保持干净)
- 通过
imsg支持 iMessage;默认的本地路径在 Linux/Windows 上不可用 - 通过克隆虚拟机即时重置
- 无需额外硬件或云成本
托管 Mac 提供商(云)¶
如果你希望在云端使用 macOS,托管的 Mac 提供商同样适用:
- MacStadium(托管 Mac)
- 其他托管 Mac 厂商也可行;请遵循他们的虚拟机和 SSH 文档
一旦你可以通过 SSH 访问 macOS 虚拟机,请继续下面的 安装 OpenClaw。
快速路径(Lume,有经验的用户)¶
- 安装 Lume。
- 运行
lume create openclaw --os macos --ipsw latest - 完成设置助理,启用远程登录(SSH)。
- 运行
lume run openclaw --no-display - SSH 登录,安装 OpenClaw,配置频道。
- 完成。
你需要什么(Lume)¶
- Apple Silicon Mac(M1/M2/M3/M4)
- 主机上运行 macOS Sequoia 或更高版本
- 每个虚拟机约 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 中:
验证:
文档:Lume 安装
2) 创建 macOS 虚拟机¶
这会下载 macOS 并创建虚拟机。VNC 窗口会自动打开。
Note
下载所需时间取决于你的网络连接。
3) 完成设置助理¶
在 VNC 窗口中:
- 选择语言和地区。
- 跳过 Apple ID(如果你之后想要使用 iMessage,也可以登录)。
- 创建用户账户(记住用户名和密码)。
- 跳过所有可选功能。
设置完成后:
- 启用 SSH:系统设置 -> 通用 -> 共享,打开“远程登录”。
- 为了无头模式使用虚拟机,启用自动登录:系统设置 -> 用户与群组,选择“自动以以下身份登录”,然后选择虚拟机用户。
4) 获取虚拟机的 IP 地址¶
查找 IP 地址(通常是 192.168.64.x)。
5) SSH 登录虚拟机¶
将 youruser 替换为你创建的账户,将 IP 替换为你虚拟机的 IP。
6) 安装 OpenClaw¶
全新的 macOS 虚拟机没有 Node.js 或 npm。在虚拟机内部运行 安装脚本。它会在需要时安装受支持的 Node 运行时,安装 OpenClaw,并启动引导流程:
按照引导提示设置你的模型提供商(Anthropic、OpenAI 等)。
快速启动会将 Gateway 保留在此终端的前台运行,但虚拟机之后将以无头模式运行,因此 Gateway 需要作为后台服务运行。按 Ctrl+C 停止前台 Gateway,然后安装服务并验证它正在运行:
如果虚拟机中已安装 Node 24.16+ 或 26.1+,则可以直接安装该包。请在 npm 12 或 npm 11.16+ 上使用以下命令。在 npm 11.15 及更早版本上,请省略 --allow-scripts=openclaw。
7) 配置频道¶
将 Telegram 令牌保存在 Gateway 环境中,而不是复制到 openclaw.json 中。将 TELEGRAM_BOT_TOKEN=<bot-token> 添加到 ~/.openclaw/.env,然后在当前 shell 中加载它并添加频道:
受管理的 Gateway 会在重启后读取相同的状态目录 .env。对于 WhatsApp,请先配置你的允许列表,然后扫描登录二维码:
openclaw config set channels.whatsapp.dmPolicy allowlist
openclaw config set channels.whatsapp.allowFrom '["+15551234567"]' --strict-json
openclaw channels login --channel whatsapp
8) 以无头模式运行虚拟机¶
停止虚拟机并在没有显示器的情况下重新启动:
虚拟机在后台运行;OpenClaw 的守护进程会保持 gateway 运行。要检查状态:
附赠:iMessage 集成¶
这是在 macOS 上运行的杀手级功能。将 iMessage 与 imsg 结合使用,为 OpenClaw 添加“信息”功能。
在虚拟机内部:
- 登录“信息”。
- 安装
imsg。 - 为运行 OpenClaw/
imsg的进程授予“完全磁盘访问权限”和“自动化”权限。 - 使用
imsg rpc --help验证 RPC 支持。
添加到你的 OpenClaw 配置中:
{
channels: {
imessage: {
enabled: true,
cliPath: "imsg",
dbPath: "~/Library/Messages/chat.db",
},
},
}
重新启动 gateway。你的代理现在可以发送和接收 iMessage。完整设置详情:iMessage 频道。
保存黄金镜像¶
在进一步自定义之前,为你的干净状态创建快照:
随时重置:
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display
持续运行¶
通过以下方式保持 VM 运行:
- 保持 Mac 连接电源
- 在“系统设置 -> 节能”中禁用睡眠
- 如有需要,使用
caffeinate
如需真正的始终在线,可考虑专用的 Mac mini 或小型 VPS。参见 VPS 托管。
故障排除¶
| 问题 | 解决方案 |
|---|---|
| 无法通过 SSH 连接到 VM | 检查 VM 的“系统设置”中是否已启用“远程登录” |
| VM IP 未显示 | 等待 VM 完全启动,然后再次运行 lume get openclaw |
| 找不到 Lume 命令 | 将 ~/.local/bin 添加到 PATH |
| WhatsApp 二维码无法扫描 | 运行 openclaw channels login 时,确保已登录到 VM(而非宿主机) |
相关文档¶
- VPS 托管
- 节点
- Gateway 远程
- iMessage 频道
- Lume 快速入门
- Lume CLI 参考
- 无人值守 VM 设置(高级)
- Docker 沙箱(替代隔离方案)
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw