如何安全卸载并重装 OpenClaw

在损坏的状态上直接重装通常只会让情况更糟。请按完整流程操作：备份、卸载、验证、重装、配置。

为什么重装之前要先彻底卸载

在部分卸载的基础上重装，往往会继承同样的问题：

• 损坏的配置会被继承 —— 旧配置已损坏或格式错误，重装会再次读取。
• 新旧版本冲突 —— 旧版本留下的二进制文件或缓存包可能与新安装冲突。
• 过期的 token 仍然存在 —— 旧的 API key 和 session 文件可能与服务端不同步。
• 混合状态难以诊断 —— 当新旧文件共存时，错误变得模棱两可。

第一步：备份重要设置

在删除任何内容之前，导出或复制你想保留的配置、项目文件或凭据。检查 ~/.openclaw 和 Application Support 中值得保存的用户数据。

第二步：按完整卸载指南操作

使用对应平台的卸载指南移除所有内容：

或者用快速路径：

openclaw uninstall --all --yes
npm rm -g openclaw

第三步：验证干净状态

确认没有 OpenClaw 的二进制文件、配置目录、服务或 PATH 条目残留：

which openclaw                    # 应该没有返回
ls ~/.openclaw 2>/dev/null        # 应该没有返回
npm ls -g openclaw                # 应该显示为空

Mac 上还需检查：

launchctl list | grep -i openclaw

Linux 上：

systemctl --user list-units | grep openclaw

Windows（PowerShell）：

where.exe openclaw
Get-ScheduledTask | Where-Object { $_.TaskName -like '*OpenClaw*' }

第四步：从官方来源全新安装

从官网或包管理器下载安装 OpenClaw。不要复用旧的安装程序或缓存下载：

npm install -g openclaw@latest

第五步：从零开始配置

全新设置 OpenClaw。只恢复你明确备份过的设置。避免把整个旧配置目录复制回来 —— 从干净状态开始，按需添加。

重装后验证

重装完成后，逐项确认：

• 版本检查 —— 运行 openclaw --version，确认是预期的新版本。
• 干净配置 —— 确认配置目录是新创建的，不是从旧安装继承的。
• 无残留冲突 —— 没有重复的二进制文件、冲突的 PATH 条目或混合版本的库。
• 全新 token —— 重新认证并生成新的 API key，不要复用旧凭据。

常见问题

可以直接在现有安装上重装吗？

可以，但不推荐。先彻底卸载再全新安装是最安全的方式。

重装能修复我的问题吗？

取决于问题类型。配置、token 或文件问题 —— 大概率可以。服务端问题 —— 不行。

重装后应该复用旧配置吗？

尽量从头开始。只恢复你确定正确的特定设置。

重装后仍然不行怎么办？

可能有更深层的残留（环境变量、系统服务、缓存状态）。可以考虑进阶清理包或远程协助。

• 返回卸载总览
• 检查残留文件
• 获取进阶清理包
• 预约远程协助