以下是详细的更新方法和步骤,请根据你的安装方式选择:

通过 Git 更新(推荐,如果你是开发者或通过 Git 克隆的)
这是最常见的更新方式,能平滑地获取最新代码。
-
打开终端(或命令提示符/ PowerShell):导航到 OpenClaw 的项目根目录。
cd /path/to/your/openclaw-folder
-
确保所有本地修改已提交或备份:
- 如果你没有修改过核心文件,直接进行下一步。
- 如果你修改了
custom_library.py等配置文件,请先备份这些文件,你也可以使用git stash命令临时保存你的修改。 - 运行
git status查看当前状态。
-
从远程仓库拉取最新代码:
git pull origin main
- 如果默认分支是
master,则运行git pull origin master。 - 这个命令会下载远程仓库的最新更改并合并到你的本地分支。
- 如果默认分支是
-
更新 Python 依赖库: 拉取代码后,新版本可能增加了新的第三方库,你需要更新虚拟环境中的包。
# 激活你的虚拟环境(如果你在使用的话) # source venv/bin/activate (Linux/macOS) # 或: venv\Scripts\activate (Windows) pip install -r requirements.txt
-
恢复你的配置: 将第 2 步备份的配置文件(如
custom_library.py)复制回原位置,覆盖新下载的默认文件。 -
验证更新: 重启 OpenClaw,检查新功能是否生效,或者查看
README.md了解版本变更。
直接下载新版覆盖(适用于直接下载ZIP包的用户)
如果当初你是直接从 GitHub 的 Releases 页面或 Code 页面下载的 ZIP 压缩包,请按以下步骤操作:
-
备份!备份!备份!
- 备份你所有修改过的文件,尤其是
custom_library.py、配置文件(如config.ini,settings.py)、你编写的爬虫脚本以及你爬取的数据文件。
- 备份你所有修改过的文件,尤其是
-
下载最新版本:
- 访问 OpenClaw 的 GitHub 仓库主页。
- 找到并点击
Code绿色按钮,选择Download ZIP,或者到Releases页面下载最新的发行版 ZIP 包。
-
解压并覆盖:
- 将新下载的 ZIP 包解压到一个新的临时文件夹。
- 不要直接解压到旧目录覆盖!
- 将临时文件夹里的所有新文件,复制到你原有的 OpenClaw 目录中,选择覆盖。
- 关键步骤:将你第一步备份的个人配置文件,重新复制回对应位置。
-
更新依赖库:
- 同样,在项目根目录下运行:
pip install -r requirements.txt
- 建议使用
--upgrade参数以确保升级:pip install --upgrade -r requirements.txt
- 同样,在项目根目录下运行:
重要注意事项
- 阅读更新日志:在更新前,强烈建议去 GitHub 的
Releases页面或查看CHANGELOG.md(如果有)文件,了解新版本有哪些变化、修复了哪些 Bug、是否有不兼容的改动,这能帮你判断是否值得更新以及更新时需要注意什么。 - 虚拟环境:始终建议在 Python 虚拟环境中运行 OpenClaw,这样可以避免项目间的依赖冲突。
- 数据库变更:如果新版本更新了数据模型(用于去重的数据库结构),更新后首次运行时可能需要执行额外的数据库迁移步骤,请仔细阅读新版本的说明。
总结步骤流程图
开始更新
↓
1. 备份个人配置与数据
↓
2. 通过 `git pull` 或 下载新ZIP包 获取新代码
↓
3. 覆盖文件(注意保留备份的配置)
↓
4. 更新依赖:`pip install -r requirements.txt`
↓
5. 阅读更新说明,处理可能的数据库迁移
↓
6. 运行测试,验证更新成功
最安全的方式:如果你对代码做了大量自定义修改,建议在更新前,先将整个项目文件夹复制一份作为备份,然后在副本上进行更新操作,测试无误后再替换。