跳转至

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,有经验的用户)

  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 或更高版本
  • 每个虚拟机约 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 虚拟机

lume create openclaw --os macos --ipsw latest

这会下载 macOS 并创建虚拟机。VNC 窗口会自动打开。

Note

下载所需时间取决于你的网络连接。

3) 完成设置助理

在 VNC 窗口中:

  1. 选择语言和地区。
  2. 跳过 Apple ID(如果你之后想要使用 iMessage,也可以登录)。
  3. 创建用户账户(记住用户名和密码)。
  4. 跳过所有可选功能。

设置完成后:

  1. 启用 SSH:系统设置 -> 通用 -> 共享,打开“远程登录”。
  2. 为了无头模式使用虚拟机,启用自动登录:系统设置 -> 用户与群组,选择“自动以以下身份登录”,然后选择虚拟机用户。

4) 获取虚拟机的 IP 地址

lume get openclaw

查找 IP 地址(通常是 192.168.64.x)。

5) SSH 登录虚拟机

ssh youruser@192.168.64.X

将 youruser 替换为你创建的账户,将 IP 替换为你虚拟机的 IP。

6) 安装 OpenClaw

全新的 macOS 虚拟机没有 Node.js 或 npm。在虚拟机内部运行 安装脚本。它会在需要时安装受支持的 Node 运行时,安装 OpenClaw,并启动引导流程:

curl -fsSL https://openclaw.ai/install.sh | bash

按照引导提示设置你的模型提供商(Anthropic、OpenAI 等)。

快速启动会将 Gateway 保留在此终端的前台运行,但虚拟机之后将以无头模式运行,因此 Gateway 需要作为后台服务运行。按 Ctrl+C 停止前台 Gateway,然后安装服务并验证它正在运行:

openclaw gateway install
openclaw gateway status

如果虚拟机中已安装 Node 24.16+ 或 26.1+,则可以直接安装该包。请在 npm 12 或 npm 11.16+ 上使用以下命令。在 npm 11.15 及更早版本上,请省略 --allow-scripts=openclaw。

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

7) 配置频道

将 Telegram 令牌保存在 Gateway 环境中,而不是复制到 openclaw.json 中。将 TELEGRAM_BOT_TOKEN=<bot-token> 添加到 ~/.openclaw/.env,然后在当前 shell 中加载它并添加频道:

export TELEGRAM_BOT_TOKEN="<bot-token>"
openclaw channels add --channel telegram --use-env

受管理的 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) 以无头模式运行虚拟机

停止虚拟机并在没有显示器的情况下重新启动:

lume stop openclaw
lume run openclaw --no-display

虚拟机在后台运行;OpenClaw 的守护进程会保持 gateway 运行。要检查状态:

ssh youruser@192.168.64.X "openclaw status"

附赠:iMessage 集成

这是在 macOS 上运行的杀手级功能。将 iMessage 与 imsg 结合使用,为 OpenClaw 添加“信息”功能。

在虚拟机内部:

  1. 登录“信息”。
  2. 安装 imsg。
  3. 为运行 OpenClaw/imsg 的进程授予“完全磁盘访问权限”和“自动化”权限。
  4. 使用 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

持续运行

通过以下方式保持 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(而非宿主机)

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw