OpenClaw Docker升级需替换镜像并重建容器：先查运行状态与镜像信息，再拉取指定版本新镜像，验证完整性后停用并删除旧容器，最后用命令行、Compose或覆盖式方式启动新容器，并通过日志、健康检查及页面版本号验证服务可用性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw Docker部署更新版本需替换镜像并重建容器，避免直接修改运行中容器导致配置丢失或服务中断。
确认当前运行状态与镜像信息
执行 docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}" | grep openclaw 查看正在运行的OpenClaw容器名称、所用镜像及状态。若无输出，说明容器未运行，需先确认部署目录或 compose 文件位置。
记录下当前镜像名（如 openclaw/openclaw:0.3.1）和容器名（如 openclaw-web），后续操作将依赖这两项。
拉取新版本镜像
访问 OpenClaw 官方 GitHub 或 Docker Hub 页面，确认最新稳定版标签（例如 v0.4.0 或 latest）。不要盲目使用 latest，生产环境应锁定语义化版本号。
执行 docker pull openclaw/openclaw:v0.4.0 下载新镜像。网络较慢时可加 -q 参数静默拉取。
【必须验证镜像完整性】 拉取完成后运行 docker images openclaw/openclaw | grep v0.4.0，确保 SIZE 不为 “
OpenClaw 跨平台配置备份与网关监控。自动备份 openclaw.json，每分钟检测 gateway 状态，宕机时自动恢复。支持 Linux/macOS/Windows。触发：配置备份、gateway 监控、自动恢复、看门狗、watchdog。
停用并移除旧容器
第一步：停止容器 → docker stop openclaw-web
第二步：删除容器 → docker rm openclaw-web
⚠️ 注意：此操作不删除挂载卷（volume）或绑定宿主机的 -v 目录，但会清除容器元数据。若容器使用 --rm 启动过，请跳过 docker rm，因容器已自动消失。
启动新版本容器
方法一：命令行方式（适用于简单部署）
执行完整启动命令，确保复用原有端口映射、环境变量和卷挂载：docker run -d --name openclaw-web -p 3000:3000 -v /opt/openclaw/data:/app/data -e OPENCLAW_ENV=prod openclaw/openclaw:v0.4.0
方法二：Docker Compose 方式（推荐，尤其含多服务依赖）
进入部署目录，编辑 docker-compose.yml，将 image: 行改为 openclaw/openclaw:v0.4.0；保存后执行：docker compose down && docker compose up -d
方法三：覆盖式重建（保留原命令结构）
若原启动命令较长且已记录，可用 docker run 命令末尾替换镜像标签，并添加 --restart unless-stopped 确保异常退出后自启。
验证服务可用性
执行 docker logs --tail 20 openclaw-web 查看最后20行日志，确认无 FATAL、Connection refused 或 Migration failed 类错误。
curl -I http://localhost:3000/health → 返回 HTTP 200 即表示基础服务已就绪。
打开浏览器访问 http://:3000，加载页面后检查右下角版本号是否显示为 v0.4.0。
