本页内容
本页内容
托管
macOS 虚拟机
推荐默认方案(大多数用户)
- 小型 Linux VPS,用于始终在线的 Gateway 且成本较低。请参阅 VPS 托管。
- 如果您想要完全控制,则需要 专用硬件(Mac mini 或 Linux 盒子),而 住宅 IP 用于浏览器自动化。许多网站都会屏蔽数据中心 IP,因此本地浏览通常效果更好。
- Hybrid:将网关保留在便宜的 VPS 上,并在需要 browser/UI 自动化时将 Mac 作为 node 连接。请参阅 Nodes 和 Gateway Remote。
仅当您特别需要 macOS-only 功能(例如 iMessage)或希望与日常 Mac 严格隔离时,才使用 macOS VM。
macOS VM 选项
在你的 Apple Silicon Mac 上本地运行 VM(Lume)
使用 Lume 在现有 Apple Silicon Mac 上的沙盒 macOS VM 中运行 OpenClaw。这给你:
- 完整且隔离的 macOS 环境(你的宿主机保持干净)
- 通过
imsg支持 iMessage;默认的本地路径在 Linux/Windows 上不可行 - 克隆虚拟机即时重置
- 无需额外硬件或云成本
托管 Mac 提供商(云端)
如果你想在云端使用 macOS,托管 Mac 提供商也可以:
- MacStadium(托管 Mac)
- 其他托管 Mac 厂商也可以;请遵循它们的 VM + SSH 文档
一旦您拥有 SSH 对 macOS VM 的访问权限,请继续执行下面的 Install OpenClaw。
快速路径(Lume,有经验的用户)
- 安装 Lume。
lume create openclaw --os macos --ipsw latest- 完成设置助理,启用远程登录(SSH)。
lume run openclaw --no-display- SSH 进入,安装 OpenClaw,配置频道。
- 完成。
你需要准备什么(Lume)
- Apple 硅 Mac (M1/M2/M3/M4)
- 宿主机上运行 macOS Sequoia 或更高版本
- ~60 GB 每个 VM 的可用磁盘空间
- 约 20 分钟
1) 安装 Lume
如果 ~/.local/bin 不在你的 PATH 中:
验证:
2) 创建 macOS VM
这将下载 macOS 并创建 VM。 VNC 窗口会自动打开。
3) 完成设置助手
在 VNC 窗口中:
- 选择语言和地区。
- 跳过 Apple ID(如果之后想使用 iMessage,也可以登录)。
- 创建一个用户账户(记住用户名和密码)。
- 跳过所有可选功能。
设置完成后:
- 启用 SSH:System Settings -> General -> Sharing,开启“Remote Login”。
- 对于无头 VM 使用,启用自动登录:系统设置 -> 用户和组,选择“自动登录为:”,然后选择 VM 用户。
4)获取 VM 的 IP 地址
查找 IP 地址(通常是 192.168.64.x)。
5)通过 SSH 连接到 VM
将 youruser 替换为你创建的账户,并将 IP 替换为你的 VM 的 IP。
6) 安装 OpenClaw
新鲜的 macOS VM 没有 Node.js 或 npm。在 VM 内,运行 安装程序脚本。它会在需要时安装受支持的 Node 运行时、安装 OpenClaw 并开始载入:
按照引导提示设置你的模型提供商(Anthropic、OpenAI 等)。
Quick start 将网关保留在该终端的前台,但 VM 稍后将无头运行,因此网关需要作为后台服务运行。按 Ctrl+C 停止前台网关,然后安装该服务并验证其是否正在运行:
如果VM已经有Node 24.16+或26.1+,则可以直接安装该软件包。在 npm 12 或 npm 11.16+ 上使用以下命令。在 npm 11.15 及更早版本上,省略 --allow-scripts=openclaw。
7) 配置 channels
将 Telegram 令牌保留在网关环境中,而不是将其复制到 openclaw.json 中。将TELEGRAM_BOT_TOKEN=<bot-token>添加到~/.openclaw/.env,然后在当前shell中加载并添加通道:
受管网关在重新启动后读取相同的状态目录 .env。对于 WhatsApp,配置您的白名单,然后扫描登录 QR 代码:
8) 无头运行 VM
停止 VM 并在不显示界面的情况下重新启动:
VM 在后台运行;OpenClaw 的守护进程会保持网关持续运行。要检查状态:
Bonus: iMessage 集成
这是在 macOS 上运行的杀手级功能。使用 iMessage 和 imsg 将 Messages 添加到 OpenClaw。
在 VM 内:
- 登录 Messages。
- 安装
imsg。 - 为运行 OpenClaw/
imsg. 的进程授予完全磁盘访问和自动化权限 - 使用
imsg rpc --help验证 RPC 支持。
在你的 OpenClaw 配置中添加:
重新启动网关。您的客服人员现在可以发送和接收 iMessage。完整设置详细信息:i消息通道。
保存金镜像
在进一步自定义之前,先快照你的干净状态:
随时重置:
24/7 运行
通过以下方式保持 VM 运行:
- 让你的 Mac 一直插着电
- 在系统设置 -> 节能中禁用睡眠
- 如有需要,使用
caffeinate
如果需要真正的始终在线,建议使用专用 Mac mini 或小型 VPS。参见 VPS 托管。
故障排查
| 问题 | 解决方案 |
|---|---|
| 无法 SSH 连接到 VM | 检查 VM 的系统设置中是否已启用“远程登录” |
| 未显示 VM IP | 等待 VM 完全启动后,再次运行 lume get openclaw |
| 找不到 Lume 命令 | 将 ~/.local/bin 添加到你的 PATH |
| WhatsApp QR 未扫描 | 检查运行 openclaw channels login 时是否登录到 VM(不是主机) |