Files
openclaw/docs/zh-CN/install/macos-vm.md
2026-03-16 07:03:19 +00:00

7.2 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你希望 OpenClaw 与你的主 macOS 环境隔离
你希望在沙箱中集成 iMessageBlueBubbles
你希望拥有一个可重置且可克隆的 macOS 环境
你希望比较本地与托管 macOS VM 选项
在沙箱化的 macOS VM本地或托管中运行 OpenClaw适用于你需要隔离或 iMessage 的场景 macOS VM
generated_at model provider source_hash source_path workflow
2026-03-16T06:23:59Z gpt-5.4 openai 4d1c85a5e4945f9f0796038cd5960edecb71ec4dffb6f9686be50adb75180716 install/macos-vm.md 15

在 macOS VM 上运行 OpenClaw沙箱隔离

推荐默认方案(适用于大多数用户)

  • 小型 Linux VPS:适合始终在线的 Gateway 网关,且成本较低。参见 VPS hosting
  • 专用硬件Mac mini 或 Linux 主机):如果你希望完全控制,并为浏览器自动化获得一个住宅 IP。许多网站会屏蔽数据中心 IP因此本地浏览通常效果更好。
  • 混合方案: 将 Gateway 网关放在便宜的 VPS 上,当你需要浏览器/UI 自动化时,再将你的 Mac 作为一个 node 连接进来。参见 NodesGateway remote

当你明确需要 macOS 独有能力iMessage/BlueBubbles或希望与你的日常 Mac 严格隔离时,再使用 macOS VM。

macOS VM 选项

在你的 Apple Silicon Mac 上运行本地 VMLume

使用 Lume 在你现有的 Apple Silicon Mac 上的沙箱化 macOS VM 中运行 OpenClaw。

这样你将获得:

  • 完全隔离的 macOS 环境(你的宿主机保持干净)
  • 通过 BlueBubbles 获得 iMessage 支持(在 Linux/Windows 上无法实现)
  • 通过克隆 VM 实现即时重置
  • 无需额外硬件或云成本

托管 Mac 提供商(云端)

如果你希望在云中使用 macOS托管 Mac 提供商同样可行:

  • MacStadium(托管 Mac
  • 其他托管 Mac 供应商也可以;请遵循它们的 VM + SSH 文档

一旦你获得了对 macOS VM 的 SSH 访问权限,就继续执行下面的第 6 步。


快速路径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 MacM1/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 Installation


2创建 macOS VM

lume create openclaw --os macos --ipsw latest

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

注意:下载可能需要一些时间,具体取决于你的网络连接。


3完成设置助理

在 VNC 窗口中:

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

设置完成后,启用 SSH

  1. 打开“系统设置”→“通用”→“共享”
  2. 启用“远程登录”

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": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    },
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

然后登录 WhatsApp扫描 QR 码):

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 上运行的杀手级特性。使用 BlueBubbles 将 iMessage 添加到 OpenClaw。

在 VM 内:

  1. 从 bluebubbles.app 下载 BlueBubbles
  2. 使用你的 Apple ID 登录
  3. 启用 Web API 并设置一个密码
  4. 将 BlueBubbles webhook 指向你的 gateway示例https://your-gateway-host:3000/bluebubbles-webhook?password=<password>

添加到你的 OpenClaw 配置中:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

重启 Gateway 网关。现在你的智能体就可以发送和接收 iMessage 了。

完整设置细节: BlueBubbles channel


保存黄金镜像

在进一步自定义之前,为你的干净状态创建快照:

lume stop openclaw
lume clone openclaw openclaw-golden

随时重置:

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

7×24 运行

通过以下方式保持 VM 持续运行:

  • 让你的 Mac 保持通电
  • 在“系统设置”→“节能”中禁用睡眠
  • 如有需要,使用 caffeinate

如果你需要真正始终在线,请考虑使用专用 Mac mini 或小型 VPS。参见 VPS hosting


故障排除

问题 解决方案
无法通过 SSH 连接到 VM 检查 VM 的“系统设置”中是否已启用“远程登录”
未显示 VM IP 等待 VM 完全启动后,再次运行 lume get openclaw
找不到 lume 命令 ~/.local/bin 添加到你的 PATH
无法扫描 WhatsApp QR 码 运行 openclaw channels login 时,确保你登录的是 VM 而不是宿主机

相关文档