以下是详细的升级步骤和注意事项

openclaw openclaw官方 2026-04-09 2

升级前的重要准备

备份配置和数据：这是最关键的一步！
- 备份您的 config 目录（通常包含 config.yaml 和 .env 等文件）。
- 备份您的数据库（如果您使用了数据库，如 claw_db.sqlite3 或 chroma 向量数据库目录）。
- 备份任何自定义的提示词、工具配置或工作流文件。
查看发布说明：

访问 OpenClaw 的 GitHub 仓库 Releases 页面，查看新版本的更新内容、新特性、破坏性变更和升级指南,这能帮你避免升级后出现意外问题。

假设您最初是通过 Git 克隆的方式安装的。

进入项目目录：
```
cd /path/to/your/openclaw
```
停止当前运行的 OpenClaw 服务：
- 如果是在前台运行，使用 Ctrl+C 终止。
- 如果是在后台运行（例如用 systemd 或 screen）,找到并终止相关进程。
拉取最新代码：
```
git pull origin main
```
- 注意：main 分支通常是开发版（最新功能，可能不稳定），如果你想升级到最新的稳定版，请先查看 GitHub 仓库的 Releases 或 Branches，切换到最新的稳定分支，
```
git checkout stable  # 假设存在名为 stable 的分支
git pull origin stable
```
更新 Python 依赖：
```
pip install -r requirements.txt --upgrade
```
强烈建议在 Python 虚拟环境（venv）中进行操作,以避免污染系统环境。
处理数据库迁移（如果适用）：
- 如果新版本包含了数据库结构的变更，通常会有迁移脚本或说明，请仔细阅读该版本的发布说明或 README.md。
- 有时可能需要运行：
```
alembic upgrade head
```
  或者重新初始化数据库（注意：这会清空原有数据！务必先备份！）。

重启 OpenClaw：

# 根据您的启动方式，
python main.py
# 或
uvicorn app:app --host 0.0.0.0 --port 8000 --reload

这是最简单和干净的升级方式。

拉取最新的镜像：

docker pull xing61/openclaw:latest  # 拉取最新开发版
# 或指定稳定版本标签
docker pull xing61/openclaw:v1.0.0

停止并删除旧容器：
```
docker stop openclaw
docker rm openclaw
```
重新运行新容器：
- 使用与之前相同的 docker run 命令,但镜像版本已更新。
- 确保你的数据卷（-v 参数）映射正确，这样配置和数据就能保留。
```
docker run -d \
--name openclaw \
-p 8000:8000 \
-v /path/to/your/config:/app/config \
-v /path/to/your/data:/app/data \
xing61/openclaw:latest
```

如果你想体验最新的、可能不稳定的功能：

回退：如果新版本问题严重，你可以使用 Git 回退到上一个稳定版本：

git log --oneline  # 查看提交历史，找到之前的稳定版本提交哈希
git checkout <旧版本的提交哈希>
pip install -r requirements.txt  # 安装对应版本的依赖

并从备份中恢复你的配置和数据。

总结建议：对于大多数用户，通过 Git 拉取稳定分支代码并更新依赖 是最直接的方法，追求稳定性和易维护性，强烈推荐使用 Docker 方式进行部署和升级。

本文地址： https://lx-openclaw.com.cn/post/920.html