English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

托管与部署

macOS 虚拟机

推荐默认方案（大多数用户）

  • 小型 Linux VPS，用于始终在线的 Gateway 网关并保持低成本。参见 VPS 托管。
  • 如果你想完全掌控，并为浏览器自动化使用住宅 IP，请选择专用硬件（Mac mini 或 Linux 机器）。许多网站会屏蔽数据中心 IP，因此本地浏览通常效果更好。
  • 混合方案： 将 Gateway 网关放在便宜的 VPS 上，并在需要浏览器/UI 自动化时把你的 Mac 作为节点连接。参见 节点 和 Gateway 网关远程。

当你明确需要仅 macOS 支持的能力（iMessage/BlueBubbles），或想与你日常使用的 Mac 严格隔离时，使用 macOS VM。

macOS VM 选项

你的 Apple Silicon Mac 上的本地 VM（Lume）

使用 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 Mac（M1/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 安装

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 [email protected]

将 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（扫描二维码）：

openclaw channels login

8) 无头运行 VM

停止 VM 并以无显示模式重新启动：

lume stop openclaw
lume run openclaw --no-display

VM 会在后台运行。OpenClaw 的守护进程会保持 Gateway 网关运行。

检查状态：

ssh [email protected] "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 渠道

保存黄金镜像

在进一步自定义之前，快照你的干净状态：

lume stop openclaw
lume clone openclaw openclaw-golden

随时重置：

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

24/7 运行

通过以下方式保持 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（而不是宿主机）

相关文档