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

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



可以。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 和配置文件的人。

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

  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 确认输出版本号
# 创建配置目录 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

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 参数。

如果你想通过域名 + 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 本地部署的主要限制之一。

症状:docker logs openclaw 显示 KilledOOMKilled。原因是 Docker Desktop 分配的内存太少。

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

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。

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

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

  • 低功耗 — Apple Silicon Mac Mini 待机仅 5W,24 小时运行一年电费不到 100 元人民币
  • 零噪音 — 放在书桌上、电视柜后面都行,完全安静
  • 性能强劲 — M2/M4 芯片性能远超同价位 Linux 服务器,16GB 内存运行 Docker 绰绰有余
  • 数据本地化 — 所有数据存储在你自己的设备上,不经过第三方服务器
  • 初始成本高 — 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,用来跑 OpenClaw 是不错的选择。但如果需要专门购买,从纯经济角度看,云端方案更划算。

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

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

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

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

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

小讯
上一篇 2026-04-24 14:38
下一篇 2026-04-24 14:36

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/275281.html