OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

托管与部署

macOS 虚拟机

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

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

只有当你明确需要 iMessage 等仅限 macOS 的功能，或希望与日常使用的 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 文档操作

获得 macOS 虚拟机的 SSH 访问权限后，请继续执行下方的安装 OpenClaw。

快速路径（Lume，适合有经验的用户）

  1. 安装 Lume。
  2. lume create openclaw --os macos --ipsw latest
  3. 完成 Setup Assistant，启用 Remote Login（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

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）完成 Setup Assistant

在 VNC 窗口中：

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

设置完成后：

  1. 启用 SSH：System Settings -> General -> Sharing，然后启用 "Remote Login"。
  2. 若要无界面运行虚拟机，请启用自动登录：System Settings -> Users & Groups，选择 "Automatically log in as:"，然后选择虚拟机用户。

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@latestopenclaw onboard --install-daemon

按照新手引导提示设置你的模型提供商（Anthropic、OpenAI 等）。

7）配置渠道

编辑配置文件：

bash
nano ~/.openclaw/openclaw.json

添加你的渠道：

json5
{  channels: {    telegram: {      botToken: "YOUR_BOT_TOKEN",    },    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551234567"],    },  },}

然后登录 WhatsApp（扫描二维码）：

bash
openclaw channels login

8）无界面运行虚拟机

停止虚拟机，然后以无显示模式重新启动：

bash
lume stop openclawlume run openclaw --no-display

虚拟机会在后台运行；OpenClaw 的守护进程会保持 Gateway 网关运行。检查状态：

bash
ssh youruser@192.168.64.X "openclaw status"

额外功能：iMessage 集成

这是在 macOS 上运行的一大优势。将 iMessage 与 imsg 配合使用，即可将 Messages 添加到 OpenClaw。

在虚拟机内：

  1. 登录 Messages。
  2. 安装 imsg。
  3. 为运行 OpenClaw/imsg 的进程授予 Full Disk Access 和 Automation 权限。
  4. 使用 imsg rpc --help 验证 RPC 支持。

添加到你的 OpenClaw 配置中：

json5
{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",    },  },}

重启 Gateway 网关。你的智能体现在可以发送和接收 iMessage。完整设置说明：iMessage 渠道。

保存黄金镜像

进一步自定义之前，为干净状态创建快照：

bash
lume stop openclawlume clone openclaw openclaw-golden

随时重置：

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

全天候运行

通过以下方式保持虚拟机运行：

  • 保持 Mac 接通电源
  • 在 System Settings -> Energy Saver 中禁用睡眠
  • 必要时使用 caffeinate

如需真正始终在线，请考虑使用专用 Mac mini 或小型 VPS。参阅 VPS 托管。

故障排查

问题 解决方案
无法通过 SSH 登录虚拟机 检查虚拟机的 System Settings 中是否已启用 "Remote Login"
未显示虚拟机 IP 等待虚拟机完全启动，然后再次运行 lume get openclaw
找不到 Lume 命令 将 ~/.local/bin 添加到你的 PATH
WhatsApp 二维码无法扫描 运行 openclaw channels login 时，确保你登录的是虚拟机而不是宿主机

相关文档

Was this useful?
On this page

On this page