OpenClaw Docker升级与配置持久化指南-觅影博客网

前言

今天来讲讲如何让 OpenClaw Docker 版本保持最新，以及怎么让配置持久化！

之前一直用 Docker 跑 OpenClaw，但是有个问题一直困扰着：重启容器后配置会丢失！

经过研究，终于找到了解决方案～

一、问题背景

1.1 当前环境

OpenClaw运行在Docker容器内
容器用户为node（非root）
/home/yunjian目录在overlay文件系统上

1.2 遇到的问题

容器重启后apt安装的工具（如ffmpeg）会丢失
npm安装的工具也可能丢失
每次重启都要重新配置

二、解决方案

2.1 持久化配置

官方提供了OPENCLAW_HOME_VOLUME环境变量，可以将/home/yunjian持久化到命名Docker卷。

# 在宿主机执行
export OPENCLAW_HOME_VOLUME="openclaw_home"
./scripts/docker/setup.sh

setup脚本会自动创建docker-compose.extra.yml，并用以下命令启动：

docker compose -f docker-compose.yml -f docker-compose.extra.yml up -d

2.2 安装额外工具

如果需要在镜像中安装额外工具（如ffmpeg），可以使用：

export OPENCLAW_DOCKER_APT_PACKAGES="ffmpeg"
./scripts/docker/setup.sh

三、升级方法

3.1 推荐方式：openclaw update

不需要重新运行setup脚本！ 一次安装成功后，直接用命令升级：

# 进入容器
docker exec -it openclaw bash

# 更新到最新版本
openclaw update

# 切换到beta频道
openclaw update --channel beta

# 指定版本
openclaw update --tag 2026.4.2

3.2 升级后检查

升级完成后一定要执行以下步骤：

# 1. 运行doctor检查
openclaw doctor

# 2. 重启网关
openclaw gateway restart

# 3. 检查健康状态
openclaw health

# 4. 验证版本
openclaw --version

3.3 回滚方法

如果升级出问题，可以回滚到指定版本：

# 指定版本回滚
npm i -g openclaw@<version>

# 例如回滚到2026.4.1
npm i -g [email protected]

# 然后执行
openclaw doctor
openclaw gateway restart

四、完整启动脚本

这里提供一个完整的启动脚本：

#!/bin/bash
# OpenClaw Docker 启动脚本

OPENCLAW_DIR="/path/to/openclaw"
VOLUME_NAME="openclaw_home"

cd "$OPENCLAW_DIR"

# 停止现有容器
docker compose down

# 设置环境变量
export OPENCLAW_HOME_VOLUME="$VOLUME_NAME"
export OPENCLAW_DOCKER_APT_PACKAGES="ffmpeg"

# 重新构建并启动
./scripts/docker/setup.sh

# 验证ffmpeg
docker compose exec openclaw-gateway ffmpeg -version

五、关键环境变量

变量	说明
`OPENCLAW_HOME_VOLUME`	持久化/home/yunjian到Docker卷
`OPENCLAW_EXTRA_MOUNTS`	额外绑定挂载
`OPENCLAW_DOCKER_APT_PACKAGES`	镜像构建时安装apt包
`OPENCLAW_IMAGE`	使用远程镜像