Mac 安装 OpenClaw 完整教程

Mac 能运行 OpenClaw 吗？

可以。OpenClaw 通过 Docker 容器运行，而 Docker Desktop 完美支持 macOS — 包括 Intel 芯片和 Apple Silicon（M1/M2/M3/M4）。无论你用的是 MacBook Air、MacBook Pro 还是 Mac Mini，都可以在上面部署 OpenClaw。

你有两种方式在 Mac 上使用 OpenClaw：

• 方法一：Docker Desktop 本地部署 — 在你的 Mac 上直接运行 OpenClaw 容器。需要安装 Docker Desktop，手动编写配置文件。适合有技术背景、想完全掌控数据的用户。
• 方法二：OpenClaw Launch 云端托管（推荐） — 不需要在 Mac 上安装任何东西。通过浏览器可视化配置，10 秒部署到云端。适合大多数用户，尤其是不想折腾 Docker 和配置文件的人。

方法一：用 Docker Desktop 在 Mac 上本地部署

这是"硬核"方式：在你的 Mac 上安装 Docker Desktop，拉取 OpenClaw 镜像，手写 JSON 配置文件，然后启动容器。完全免费（除了 AI 模型 API 费用），但需要一定的终端操作经验。

Mac 系统要求

部署步骤

Step 1 详细：安装 Docker Desktop

1. 打开 Docker Desktop 官网，点击 "Download for Mac"
2. 如果你是 Apple Silicon Mac（M1/M2/M3/M4），选择 "Apple Chip"；Intel Mac 选择 "Intel Chip"
3. 下载 .dmg 文件后双击打开，将 Docker 图标拖入 Applications 文件夹
4. 从 Launchpad 或 Applications 中启动 Docker Desktop
5. 首次启动需要授权系统权限，按提示输入 Mac 密码
6. 等待状态栏出现鲸鱼图标且不再显示动画，表示 Docker 已就绪
7. 打开终端，执行 docker --version 确认输出版本号

Step 3 详细：配置文件示例

# 创建配置目录
mkdir -p ~/.openclaw/credentials
chmod 777 ~/.openclaw
chmod 777 ~/.openclaw/credentials

# 创建配置文件
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "models": {
    "providers": {
      "openrouter": {
        "apiKey": "sk-or-v1-你的OpenRouter密钥"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Telegram Bot Token",
      "dmPolicy": "pairing"
    }
  },
  "plugins": {
    "entries": {
      "telegram": { "enabled": true }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4.6"
      }
    }
  },
  "gateway": {
    "auth": {
      "token": "$(uuidgen | tr '[:upper:]' '[:lower:]')"
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}
EOF

Step 4 详细：启动容器命令

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/home/node/.openclaw \
  --memory=2g \
  --memory-swap=3g \
  --restart unless-stopped \
  ghcr.io/openclaw/openclaw:latest \
  node openclaw.mjs gateway --allow-unconfigured

Apple Silicon Mac 上 Docker Desktop 内置了 Rosetta 2 翻译层，能透明运行 x86_64 镜像。OpenClaw 官方镜像支持多架构（amd64 + arm64），所以无论 Intel 还是 M 系列芯片，都无需添加 --platform 参数。

Step 5 可选：用 Caddy 配置 HTTPS

如果你想通过域名 + HTTPS 从外部访问你 Mac 上的 OpenClaw（例如 Telegram Webhook 需要 HTTPS），可以安装 Caddy 反向代理：

# 用 Homebrew 安装 Caddy
brew install caddy

# 创建 Caddyfile
cat > ~/Caddyfile << 'EOF'
your-domain.com {
    reverse_proxy localhost:18789
}
EOF

# 启动 Caddy
caddy run --config ~/Caddyfile

注意：要从外网访问 Mac 上的服务，你需要公网 IP 或使用内网穿透工具（如 Cloudflare Tunnel、ngrok、frp）。大多数家庭网络没有公网 IP，这是 Mac 本地部署的主要限制之一。

Mac 部署常见问题

Docker Desktop 内存不足

症状：docker logs openclaw 显示 Killed 或 OOMKilled。原因是 Docker Desktop 分配的内存太少。

解决方法：打开 Docker Desktop → Settings → Resources → Memory，调高到至少 4GB（如果 Mac 总内存允许）。同时确保容器启动时使用了 --memory=2g --memory-swap=3g 参数。

Apple Silicon（ARM）兼容性

M1/M2/M3/M4 Mac 使用 ARM 架构，和传统 Linux 服务器（x86_64）不同。但这通常不是问题 — Docker Desktop 内置 Rosetta 2 翻译层，可以运行 x86_64 镜像。OpenClaw 官方镜像同时提供 amd64 和 arm64 版本，Docker 会自动选择最佳匹配。

如果遇到 WARNING: The requested image's platform (linux/amd64) does not match the detected host platform 警告，通常可以忽略 — 只要容器正常启动并运行即可。

文件权限问题

macOS 和 Docker 容器内部的用户 ID 可能不匹配。容器以 node 用户（uid 1000）运行，而 Mac 上的用户通常是 uid 501。解决方法是给配置目录宽松权限：

chmod 777 ~/.openclaw
chmod 777 ~/.openclaw/credentials

端口冲突

如果 18789 端口被其他应用占用，修改端口映射即可。例如映射到 28789：

docker run -d --name openclaw -p 28789:18789 ...

然后通过 http://localhost:28789 访问 Web UI。

Docker Desktop 自动启动

如果希望 Mac 重启后 Docker Desktop 自动启动：Docker Desktop → Settings → General → 勾选 "Start Docker Desktop when you sign in to your computer"。配合容器的 --restart unless-stopped 参数，OpenClaw 会在 Mac 重启后自动恢复运行。

Mac Mini 作为 24/7 AI 服务器

Mac Mini 在中文社区中非常流行，被很多人当作家用小服务器使用。体积小巧（约 20cm 见方）、功耗极低（待机 5W，负载 15-30W）、噪音几乎为零 — 确实是理想的"桌面服务器"。

Mac Mini 运行 OpenClaw 的优势

• 低功耗 — Apple Silicon Mac Mini 待机仅 5W，24 小时运行一年电费不到 100 元人民币
• 零噪音 — 放在书桌上、电视柜后面都行，完全安静
• 性能强劲 — M2/M4 芯片性能远超同价位 Linux 服务器，16GB 内存运行 Docker 绰绰有余
• 数据本地化 — 所有数据存储在你自己的设备上，不经过第三方服务器

Mac Mini 运行 OpenClaw 的劣势

• 初始成本高 — Mac Mini M2 起价 $499（国行 ¥3999），M4 版本 $599 起。专门为一个 AI 机器人买台电脑，性价比不高
• 需要公网 IP 或内网穿透 — Telegram/Discord Webhook 需要外网能访问到你的 Mac Mini。大多数家庭宽带没有公网 IP，需要额外配置 Cloudflare Tunnel、frp 等内网穿透方案
• 停电 / 断网风险 — 家庭网络不如数据中心稳定。停电、路由器重启、ISP 维护都会导致 AI 机器人离线
• 维护成本 — macOS 更新、Docker Desktop 更新、证书续期、网络变更都需要你手动处理
• 无冗余 — 硬件故障意味着服务完全停止，没有自动故障转移

Mac Mini vs 云端：成本对比

结论：如果你已经有一台闲置的 Mac Mini，用来跑 OpenClaw 是不错的选择。但如果需要专门购买，从纯经济角度看，云端方案更划算。

方法二：OpenClaw Launch 云端托管（推荐）

如果你不想在 Mac 上安装 Docker，或者不想处理配置文件、端口映射、HTTPS 这些技术细节，OpenClaw Launch 是最简单的选择。

为什么推荐 OpenClaw Launch？

• 无需 Mac — 完全在云端运行，任何设备的浏览器都能管理。你的 Mac 可以关机、外出、休眠，AI 机器人照常在线
• 可视化配置 — 不用写一行 JSON，所有选项都是点选式。模型选择、渠道配置、Skills启用一目了然
• 10 秒部署 — 注册账号、配置参数、点击部署，整个过程不超过一分钟。对比 Docker 部署的 30-60 分钟
• $3/月起 — 远低于 Mac Mini 的一次性投入。支持支付宝和微信支付，国内用户无障碍
• 24/7 在线 — 专业数据中心保障，99.9% 可用性。不受停电、断网、Mac 休眠影响
• 自动更新和监控 — OpenClaw 新版本发布后自动更新，内置健康检查和告警，出问题自动通知

OpenClaw Launch 快速开始

1. 访问 openclawlaunch.com，注册账号（支持 Google、GitHub 或邮箱注册）
2. 在可视化编辑器中选择 AI 模型（推荐 Claude、GPT-4o 或 DeepSeek）
3. 配置聊天渠道（Telegram、Discord 等，填入 Bot Token 即可）
4. 点击"部署"，10 秒后你的 AI 智能体就上线了
5. 在 Telegram 或 Discord 中给你的机器人发消息测试

Mac 本地部署 vs OpenClaw Launch 完整对比

常见问题

总结：Mac 用户如何选择？

已有闲置 Mac Mini + 有技术经验 → 用 Docker Desktop 本地部署，充分利用现有硬件。

想快速上手 / 没有技术背景 / 不想买硬件 → 选择 OpenClaw Launch，$3/月，1 分钟部署完成。

专门想买 Mac Mini 做 AI 服务器 → 建议先试用 OpenClaw Launch。如果确定长期需要，再考虑购买硬件。从成本角度看，云端方案在前 10 年内都更便宜。