核心原则（所有平台通用）

1. 备份重要数据：在进行任何覆盖安装之前，强烈建议备份你的 OpenClaw 配置文件、项目文件或任何自定义设置，通常位置在：
   • Windows：C:\Users\<你的用户名>\.openclaw\ 或安装目录下的 config 文件夹。
   • macOS/Linux：~/.openclaw/ 或 ~/.config/OpenClaw/。
2. 关闭程序：确保 OpenClaw 完全退出，最好在任务管理器（Windows）或活动监视器（macOS）中确认没有相关进程在运行。

各平台覆盖安装步骤

对于 Windows

1. 下载最新安装包：从 OpenClaw 的官方 GitHub Releases 页面下载最新的 .exe 或 .msi 安装程序。
2. 运行安装程序：直接双击运行下载好的安装程序。
3. 选择安装路径：
   • 如果安装程序提示“是否覆盖现有版本”，选择 “是”。
   • 关键步骤：将安装路径指向你旧版 OpenClaw 所在的目录（C:\Program Files\OpenClaw），这样安装程序会自动替换旧文件，但通常会保留用户数据（存储在用户目录或安装目录的 userdata 子文件夹中）。
4. 按照向导完成：后续步骤点击“下一步”即可，直到安装完成。
5. 验证：启动 OpenClaw，检查版本号是否已更新，同时你的设置和项目是否还在。

对于 macOS

1. 下载最新应用：从官方源下载最新的 .dmg 文件或 .pkg 安装包。
2. 方法一（.dmg 文件）：
   • 打开 .dmg 文件。
   • 将里面的 OpenClaw.app 直接拖拽到“应用程序”文件夹中。
   • 系统会提示“是否替换”已存在的版本，点击 “替换”，这会覆盖应用程序本身，但用户配置（在 ~/Library/Application Support/OpenClaw/ 中）通常保持不变。
3. 方法二（.pkg 安装程序）：
   • 运行 .pkg 文件，按照向导步骤进行，安装程序通常会处理覆盖安装。
4. 验证：从“应用程序”文件夹启动 OpenClaw，检查更新和配置。

对于 Linux（通过包管理器或手动）

使用包管理器（推荐）

• 如果通过 APT (Debian/Ubuntu) 安装：

  sudo apt update
  sudo apt install --only-upgrade openclaw

• 如果通过 YUM/DNF (Fedora/RHEL) 安装：

  sudo dnf upgrade openclaw

• 如果通过 AUR (Arch Linux) 安装：

  yay -S openclaw  # 或使用 pamac、paru 等，会提示升级

  包管理器会自动处理覆盖升级,并保留配置文件（通常位于 ~/.config/ 下）。

手动安装（例如下载了 AppImage 或 tar 包）

1. 下载最新版本：从 Releases 页面下载 Linux 版本（如 .AppImage 或 .tar.gz）。
2. 替换可执行文件：
   • 对于 AppImage：直接下载新的 .AppImage 文件，替换掉旧的同名文件（或放到相同路径），确保赋予它执行权限：

     chmod +x OpenClaw-*.AppImage

   • 对于 tar.gz：解压新版本到旧版本的目录，选择覆盖所有文件，用户数据通常独立存储，不受影响。
3. 验证：通过终端或启动器运行新版本。

覆盖安装后可能出现的问题及解决方法

1. 配置不兼容：如果新旧版本差异较大，可能出现配置文件错误。
   • 解决方法：尝试用新版本创建一个新的配置文件，然后将旧配置中的关键项手动迁移过去，或者，OpenClaw 有时会自动将旧配置迁移到新格式。
2. 插件/扩展失效：某些插件可能需要针对新版本重新安装或更新。
   • 解决方法：检查插件管理器，更新或重新安装必要的插件。
3. 程序无法启动：
   • 解决方法：这可能是覆盖过程中文件损坏，尝试完全卸载（在控制面板或使用 sudo apt remove openclaw 等），然后重新安装全新版本，安装前务必已备份好用户数据。

如果覆盖安装无效，进行“清洁安装”

如果覆盖后问题依旧,可以考虑彻底卸载后重装：

1. 备份所有用户数据（~/.openclaw、~/.config/OpenClaw、项目文件等）。
2. 彻底卸载 OpenClaw（包括删除残留的配置文件夹）。
3. 重新启动计算机。
4. 安装最新版本的 OpenClaw。
5. 将备份的用户数据有选择性地复制回新位置。

• 覆盖安装的本质：用新文件替换旧的可执行文件和库文件，保留独立的用户数据。
• 最佳实践：始终先备份，优先使用系统原生的包管理器进行升级，这是最安全的方式。
• 官方渠道：务必从 OpenClaw 的官方 GitHub 仓库 或其指定的网站下载，确保安全。

希望这个详细的指南能帮助你顺利完成 OpenClaw 的覆盖安装！

标签： 核心原则 平台通用