在开始任何更新操作之前,请务必备份你当前的 config.toml 配置文件以及任何你自定义过的脚本或数据!

直接下载最新版本覆盖(最推荐,适合大部分用户)
这是最简单直接的方法,尤其适用于 Windows 用户或通过下载 zip 包安装的用户。
- 访问项目页面:再次前往 OpenClaw 的官方发布页面(通常是 GitHub 的 Releases 页面)。
- 下载最新版本:找到最新的版本(如
v0.9.0),下载对应的压缩包(通常是openclaw-windows-amd64.zip或类似名称)。 - 备份配置:
- 找到你当前 OpenClaw 所在的文件夹。
- 将其中的
config.toml文件复制到安全的地方。
- 解压更新:
- 将下载的新版压缩包解压到一个新文件夹中,或者直接解压覆盖到旧的程序文件夹(确保已备份
config.toml!)。 - 如果选择覆盖,旧的可执行文件和相关库文件会被替换。
- 将下载的新版压缩包解压到一个新文件夹中,或者直接解压覆盖到旧的程序文件夹(确保已备份
- 恢复配置:将你备份的
config.toml文件复制回新的程序文件夹。 - 测试运行:双击新的
openclaw.exe(Windows)或在终端中运行./openclaw(Linux/macOS),检查程序是否正常启动,你的配置是否生效。
使用 Git 进行更新(适合开发者或从源码克隆的用户)
如果你最初是通过 git clone 命令获取的 OpenClaw,可以使用 Git 命令来更新。
- 打开终端(命令行)。
- 进入目录:使用
cd命令切换到你的 OpenClaw 源码目录。cd /path/to/your/openclaw
- 拉取最新代码:
git pull origin main
(如果默认分支不是
main,请替换为master或正确的分支名) - 重新构建(如果需要):如果项目有更新依赖或代码结构变化,可能需要重新构建。
- Go 语言项目可以这样构建:
go build -o openclaw
- 或者根据项目 README 的说明进行构建。
- Go 语言项目可以这样构建:
- 备份并替换配置文件:同样,将新版中的
config.example.toml等示例配置与你的旧config.toml进行比较,手动合并重要变更,或直接使用备份的旧配置。
使用包管理器(视情况而定)
- Linux:OpenClaw 被收录在你所用发行版的软件仓库(如 AUR for Arch),你可以使用相应的包管理器更新(如
yay -S openclaw),但开源小众工具通常不在此列。 - macOS:如果通过 Homebrew 安装,则可以使用
brew upgrade openclaw,但这需要维护者提供了相应的 Formula。
通用重要步骤
- 查看更新日志:在更新前,务必去官方 Release 页面查看新版本的更新日志(Changelog),了解:
- 新增了哪些功能。
- 修复了哪些 Bug。
- 配置文件的格式是否有破坏性变更(这是导致更新后无法启动的最常见原因),如果有,你需要按照说明手动调整你的
config.toml。
- 处理依赖变更:新版本有时会要求更新第三方依赖(如浏览器驱动、特定库),请按照新版 README 或 Release Note 的说明进行操作。
- 验证更新:更新完成后,运行
openclaw --version或启动程序,确认显示的版本号已变为最新。
总结建议: 对于绝大多数用户,方法一(下载覆盖) 是最安全、最清晰的选择,关键在于 备份配置 和 阅读更新日志,如果遇到问题,项目 GitHub 的 Issues 页面通常是寻求帮助的最佳场所。
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。