租赁云 Mac 上的 OpenClaw 升级与回滚（2026 手册）
在港日韩新美的 7×24 租赁 Apple Silicon 云 Mac 上，OpenClaw 升级不是「浏览器里点更新」。你负责 launchd、可选 Docker Compose、~/.openclaw 状态与包装脚本。本文给出可重复的升级路径与快速回滚。配合 Docker 与原生 npm、环境变量与 API 密钥、launchd 定时任务。
为何必须写清回滚
- 上游可能重命名子命令或变更默认网关端口。
- 同一主机混用 Docker 与 npm 易产生「幽灵二进制」。
黄金法则：升级前务必打带时间戳的 tar 包备份
~/.openclaw，并记录上次稳定的 openclaw --version。备份清单
| 项 | 原因 |
|---|---|
~/.openclaw 整树 | 配置、缓存、.env |
| LaunchAgent plist | PATH、环境变量、工作目录 |
| Compose 与镜像 digest | 可复现回滚 |
tar czf ~/openclaw-backup-$(date +%Y%m%d-%H%M).tgz ~/.openclaw
npm 全局 vs Docker
| 模式 | 升级 | 回滚 |
|---|---|---|
| npm | 重装目标版本全局包 | 装回旧 semver + 恢复目录 |
| Docker | docker compose pull 后 up | compose 里固定旧 tag/digest |
升级顺序
- 停止 LaunchAgent 或
docker compose down。 - 备份
~/.openclaw与自定义 plist。 - 执行 npm 或镜像升级；绿之前勿删备份。
launchctl重载或compose up -d。
健康检查：openclaw --version、网关端口、一次最小工具调用（验证密钥解析，见环境变量文）。
回滚
- 再次停服务。
- 从 tar 恢复
~/.openclaw（先解压到临时目录核对）。 - npm/Docker 固定到上一良好版本。
- 重载服务并重复健康检查。
若仍失败：对比恢复的
.env 与 plist 中 EnvironmentVariables 是否重复键冲突。结论：把云 Mac 上的 OpenClaw 当生产守护进程：备份 → 升级 → 验证 → 季度演练回滚。节点价格 · SSH 帮助