1.更新 Homebrew 本身和所有公式

覆盖安装的关键在于确保新版本能顺利替换旧版本，同时处理好依赖和配置文件。

以下是针对不同安装方法的覆盖安装步骤：

使用包管理器（推荐，最干净）

如果你的系统有对应的包管理器支持（如 macOS 的 Homebrew，或某些 Linux 发行版的社区仓库），这是最安全、最简单的方法。

对于 macOS (使用 Homebrew)：

# 2. 升级 openclaw
brew upgrade openclaw
# 如果出现冲突或链接问题，可以尝试重新安装
brew reinstall openclaw

对于 Linux (如 Arch Linux 的 AUR)：

如果你是通过 AUR 助手（如 yay 或 paru）安装的：

# 使用 yay 为例
yay -S openclaw
# 助手会提示检测到旧版本，并直接进行升级。

从源码编译安装（适用于所有平台）

这是最通用的方法，但步骤稍多,假设你已经在本地克隆并编译过旧版本。

1. 备份你的配置文件（非常重要！） OpenClaw 的配置文件通常位于：

   • ~/.config/openclaw/config.toml (Linux/macOS)
   • %APPDATA%\openclaw\config.toml (Windows) 复制这个文件到安全的地方。

2. 获取最新的源代码

   # 进入你之前存放 openclaw 源码的目录
   cd /path/to/openclaw-source
   # 拉取最新的代码
   git fetch origin
   git pull origin main  # 或你所在的分支名，如 master
   # 如果你想安装一个特定的发布版本，可以切换到对应的标签
   # git checkout v1.2.3

3. 清理旧的构建文件（关键步骤，避免冲突）

   # 通常使用 cargo clean（如果是 Rust 项目）
   cargo clean
   # 或者如果项目有 Makefile，可以尝试
   # make clean

4. 重新编译并安装

   # 使用 Rust 的包管理器 Cargo 重新构建和安装
   cargo install --path . --force

   --force 参数会强制覆盖之前通过 cargo install 安装的同名二进制文件。

5. 恢复你的配置文件 将第一步备份的 config.toml 文件复制回原来的位置，然后检查新版本是否有配置项的变化,可能需要你手动调整。

直接下载预编译的二进制文件

如果项目在 GitHub Releases 页面提供预编译的二进制文件。

1. 备份配置文件（同上）。
2. 前往项目的 GitHub Releases 页面。
3. 下载最新版本对应你系统的压缩包（如 openclaw-x86_64-unknown-linux-gnu.tar.gz）。
4. 解压后，你会得到一个可执行文件（openclaw）。
5. 将这个文件复制到你的系统可执行路径下（如 /usr/local/bin、~/.local/bin），直接覆盖旧文件。

   # 复制到用户本地 bin 目录
   cp ./openclaw ~/.local/bin/
   # 如果目标文件已存在，cp 命令会直接覆盖它。

6. 恢复你的配置文件。

覆盖安装后的注意事项

1. 检查版本：运行 openclaw --version 确认新版本已生效。
2. 测试功能：运行一些基本命令,确保核心功能正常。
3. 查阅更新日志：去 GitHub Releases 页面查看新版本的更新日志，了解是否有破坏性变更、新功能或配置语法改变,你可能需要根据日志调整你的配置文件。

如果遇到问题（故障排查）

• 命令未找到：检查你的 PATH 环境变量是否包含了你安装二进制文件的目录。
• 运行时错误/依赖缺失：
  • 对于源码安装：确保你的编译环境（如 Rust 工具链）是最新的。
  • 对于二进制安装：确保系统动态库满足要求。
• 配置错误：新版本可能修改了配置结构，暂时将配置文件移走，让程序生成一个默认配置,然后与你备份的配置进行对比合并。

总结建议：

• 首选包管理器（如果可用）,它能自动处理依赖和版本。
• 次选预编译二进制,步骤简单直接。
• 最后选源码编译,适合开发者或没有其他选择的情况。

无论用哪种方法，备份配置文件都是覆盖安装前必不可少的一步。

标签： Homebrew 公式