以下是详细的升级指南，请根据你的情况进行操作

openclaw 中文openclaw 2026-04-09 3

备份！

在进行任何升级操作之前,强烈建议你备份以下内容：

以下是详细的升级指南，请根据你的情况进行操作-第1张图片-OpenClaw下载中文-AI中文智能体

如果你是通过 git clone 方式安装的，这是最直接的方法。

拉取最新代码：

国内用户（如果使用gitee镜像）：

git pull origin main  # 或 master，取决于仓库分支名

国际用户（GitHub）：

git pull upstream main  # 假设你已将原仓库添加为 upstream
# 或者
git pull origin main

更新Python依赖：项目可能会添加新的依赖库。
```
pip install -r requirements.txt --upgrade
```
如果你使用了虚拟环境（如 venv 或 conda），请先激活环境。

更新前端依赖（如果项目有Web界面）：如果项目有 webui/ 或 frontend/ 目录且包含 package.json。

cd webui  # 进入前端目录
npm install  # 或 yarn install, pnpm install
npm run build  # 如果需要重新构建
cd ..

重启服务：完全停止你正在运行的OpenClaw进程，然后按照启动命令重新启动。

# 如果你之前用命令行启动
python main.py
# 或者
python -m openclaw
# 或者通过启动脚本
./start.sh

如果你是通过 docker-compose.yml 文件部署的，升级通常非常简单。

拉取最新的镜像：
```
docker-compose pull
```
这条命令会从Docker仓库拉取 docker-compose.yml 中定义的服务的最新镜像。
重启容器：
```
docker-compose up -d
```
-d 表示在后台运行，Docker Compose会自动用新镜像重新创建容器，并保留你在Compose文件中定义的卷（数据）和配置。

注意：请确保你的 docker-compose.yml 文件中的镜像标签（latest）或版本号是指向你希望升级到的版本，有时项目方会发布新的 docker-compose.yml 文件，你可能也需要更新它。

OpenClaw的性能很大程度上依赖于其AI模型,即使主程序不升级，定期更新模型也能带来提升。

使用 Ollama（如果项目通过Ollama管理模型）：

# 拉取指定模型的最新版本
ollama pull qwen2.5:14b
# 或者拉取所有已有模型的最新版
ollama pull $(ollama list | awk 'NR>1 {print $1}')

手动下载模型：如果项目直接使用Hugging Face或ModelScope的模型文件，你可能需要重新运行下载脚本或手动替换模型目录中的文件，请参考项目最新的文档说明。

有些项目会提供方便的升级脚本。

运行脚本：

chmod +x update.sh  # 如果需要，添加执行权限
./update.sh

通过系统包管理器：如果项目被打包为系统的软件包（如 .deb, .rpm, 或通过 winget, scoop 安装），则使用对应的命令升级。
- Ubuntu/Debian: sudo apt update && sudo apt upgrade openclaw
- Windows Scoop: scoop update openclaw

检查版本号：
- 运行 python -c "import openclaw; print(openclaw.__version__)"（如果适用）。
- 或者在Web界面的“或“设置”页面查看。
测试核心功能：进行一次简单的对话或任务处理，确保所有功能正常工作。
查看日志：启动后观察终端或日志文件，确保没有新的报错。

阅读Release Notes：在升级前，最好去项目的GitHub Releases页面查看新版本的更新内容、修复的Bug和可能的破坏性变更。
配置文件不兼容：新版本可能修改了配置项的结构，如果你的旧 config.json 直接复制过去导致启动失败，可能需要参考新版本的 config.example.json 进行手动调整。
模型兼容性：极端情况下，新版本的主程序可能需要特定版本或格式的模型，旧模型可能不兼容，务必按照项目官方文档的指导更新模型。

总结一下升级路径：