在 macOS 虚拟机上运行 OpenClaw(沙箱化)
推荐默认方案(大多数用户)
- 小型 Linux VPS 用于始终在线的网关(Gateway),且成本低。参见 VPS 托管。
- 专用硬件(Mac mini 或 Linux 主机),如果你需要完全控制和住宅 IP 用于浏览器自动化。许多网站会阻止数据中心 IP,因此本地浏览通常效果更好。
- 混合方案: 将网关部署在便宜的 VPS 上,需要浏览器/UI 自动化时将你的 Mac 作为节点连接。参见 节点 和 网关远程。
当你特别需要仅 macOS 的功能(iMessage/BlueBubbles)或想要与日常使用的 Mac 严格隔离时,使用 macOS 虚拟机。
macOS 虚拟机选项
在你的 Apple Silicon Mac 上运行本地虚拟机(Lume)
使用 Lume 在现有的 Apple Silicon Mac 上以沙箱化的 macOS 虚拟机运行 OpenClaw。
这为你提供:
- 隔离的完整 macOS 环境(你的主机保持干净)
- 通过 BlueBubbles 支持 iMessage(在 Linux/Windows 上不可能实现)
- 通过克隆虚拟机即时重置
- 无额外硬件或云费用
托管 Mac 提供商(云端)
如果你想要云端的 macOS,托管 Mac 提供商也可以:
- MacStadium(托管 Mac)
- 其他托管 Mac 供应商也可以;按照他们的虚拟机 + SSH 文档操作
一旦你有了 macOS 虚拟机的 SSH 访问权限,请继续下面的步骤 6。
快速路径(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
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"如果 ~/.local/bin 不在你的 PATH 中:
bash
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc验证:
bash
lume --version文档:Lume 安装
2) 创建 macOS 虚拟机
bash
lume create openclaw --os macos --ipsw latest这会下载 macOS 并创建虚拟机。VNC 窗口会自动打开。
注意:下载时间取决于你的网络连接速度。
3) 完成设置助手
在 VNC 窗口中:
- 选择语言和地区
- 跳过 Apple ID(如果之后想用 iMessage 可以登录)
- 创建用户账户(记住用户名和密码)
- 跳过所有可选功能
设置完成后,启用 SSH:
- 打开系统设置 → 通用 → 共享
- 启用"远程登录"
4) 获取虚拟机的 IP 地址
bash
lume get openclaw查找 IP 地址(通常是 192.168.64.x)。
5) SSH 进入虚拟机
bash
ssh youruser@192.168.64.X将 youruser 替换为你创建的账户,IP 替换为你虚拟机的 IP。
6) 安装 OpenClaw
在虚拟机内:
bash
npm install -g openclaw@latest
openclaw onboard --install-daemon按照引导提示设置你的模型提供商(Anthropic、OpenAI 等)。
7) 配置通道
编辑配置文件:
bash
nano ~/.openclaw/openclaw.json添加你的通道(Channel):
json
{
"channels": {
"whatsapp": {
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
},
"telegram": {
"botToken": "YOUR_BOT_TOKEN"
}
}
}然后登录 WhatsApp(扫描二维码):
bash
openclaw channels login8) 以无头模式运行虚拟机
停止虚拟机并以无显示模式重启:
bash
lume stop openclaw
lume run openclaw --no-display虚拟机在后台运行。OpenClaw 的守护进程保持网关运行。
检查状态:
bash
ssh youruser@192.168.64.X "openclaw status"附加功能:iMessage 集成
这是在 macOS 上运行的杀手级功能。使用 BlueBubbles 将 iMessage 添加到 OpenClaw。
在虚拟机内:
- 从 bluebubbles.app 下载 BlueBubbles
- 使用你的 Apple ID 登录
- 启用 Web API 并设置密码
- 将 BlueBubbles Webhook 指向你的网关(示例:
https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)
添加到你的 OpenClaw 配置:
json
{
"channels": {
"bluebubbles": {
"serverUrl": "http://localhost:1234",
"password": "your-api-password",
"webhookPath": "/bluebubbles-webhook"
}
}
}重启网关。现在你的智能体可以发送和接收 iMessage 了。
完整设置详情:BlueBubbles 通道
保存黄金镜像
在进一步自定义之前,快照你的干净状态:
bash
lume stop openclaw
lume clone openclaw openclaw-golden随时重置:
bash
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display24/7 运行
保持虚拟机运行的方法:
- 保持你的 Mac 插着电源
- 在系统设置 → 节能中禁用睡眠
- 如有需要使用
caffeinate
要实现真正的始终在线,考虑专用 Mac mini 或小型 VPS。参见 VPS 托管。
故障排除
| 问题 | 解决方案 |
|---|---|
| 无法 SSH 进入虚拟机 | 检查虚拟机系统设置中是否启用了"远程登录" |
| 虚拟机 IP 未显示 | 等待虚拟机完全启动,再次运行 lume get openclaw |
| 找不到 Lume 命令 | 将 ~/.local/bin 添加到你的 PATH |
| WhatsApp 二维码扫描失败 | 确保你在虚拟机内(而非主机)运行 openclaw channels login |