OpenClaw 的升级方法取决于您使用的具体版本和安装方式,以下是常见的升级方法:

Docker 容器部署的升级
官方镜像升级
docker rm openclaw # 拉取最新镜像 docker pull [镜像仓库]/openclaw:latest # 重新运行容器(保留数据卷) docker run -d [原有参数] [镜像仓库]/openclaw:latest
Docker Compose 升级
# 进入项目目录 cd /path/to/openclaw # 拉取最新镜像 docker-compose pull # 重启服务 docker-compose up -d # 清理旧镜像 docker image prune
源码部署升级
Git 方式(推荐)
# 备份配置文件和数据库 cp config.yaml config.yaml.backup # 拉取最新代码 git pull origin main # 更新依赖 pip install -r requirements.txt --upgrade # 执行数据库迁移(如果有) python manage.py migrate # 重启服务 systemctl restart openclaw
下载 Release 包
# 备份当前版本 mv openclaw openclaw_backup_$(date +%Y%m%d) # 下载最新 Release wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw.tar.gz # 解压 tar -zxvf openclaw.tar.gz # 恢复配置文件 cp openclaw_backup_*/config.yaml ./openclaw/ # 重启服务
包管理器安装升级
APT(Debian/Ubuntu)
# 更新软件源 sudo apt update # 升级 OpenClaw sudo apt upgrade openclaw # 重启服务 sudo systemctl restart openclaw
YUM(CentOS/RHEL)
# 更新 sudo yum update openclaw # 重启服务 sudo systemctl restart openclaw
升级前注意事项
重要准备步骤
# 1. 查看当前版本 openclaw --version # 2. 备份数据 # 数据库备份 mysqldump -u root -p openclaw > openclaw_backup.sql # 配置文件备份 cp -r /etc/openclaw /backup/openclaw_config # 3. 查看更新日志 # 访问 GitHub Releases 页面查看变更内容
升级后验证
# 检查服务状态 systemctl status openclaw # 检查版本 openclaw --version # 测试功能 curl http://localhost:8080/health
回滚方法
如果升级出现问题,可以回滚到旧版本:
# Docker 回滚 docker run -d [原有参数] [镜像仓库]/openclaw:previous-tag # 源码回滚 git checkout v1.2.3 # 指定旧版本标签 # 恢复备份 mysql -u root -p openclaw < openclaw_backup.sql cp /backup/openclaw_config/* /etc/openclaw/
自动升级脚本示例
创建 upgrade_openclaw.sh:
#!/bin/bash set -e echo "开始升级 OpenClaw..." BACKUP_DIR="/backup/openclaw_$(date +%Y%m%d_%H%M%S)" mkdir -p $BACKUP_DIR # 备份 cp /etc/openclaw/config.yaml $BACKUP_DIR/ mysqldump -u root -p$DB_PASSWORD openclaw > $BACKUP_DIR/openclaw.sql # 升级 cd /opt/openclaw git fetch --all git checkout tags/$(git describe --tags `git rev-list --tags --max-count=1`) pip install -r requirements.txt --upgrade # 重启 systemctl restart openclaw echo "升级完成!"
故障排除
如果升级失败,请检查:
- 版本兼容性:检查新版是否兼容当前系统环境
- 依赖冲突:
pip check或npm audit(根据语言) - 配置文件:新版本可能修改了配置格式
- 数据库迁移:确保迁移脚本正确执行
建议:
- 在生产环境升级前,先在测试环境验证
- 关注官方文档的升级指南
- 加入社区获取最新升级信息
具体升级步骤可能因版本而异,请参考您使用的 OpenClaw 版本的官方文档。
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。