Ubuntu系统OpenClaw版本降级的实例操作

# 1. 执行全局卸载
npm uninstall -g openclaw
# 原理：npm uninstall -g 会从全局 node_modules 目录中删除 openclaw 包及其链接
# 2. 验证卸载（若提示 "command not found" 则成功）
openclaw --version
# 原理：如果卸载成功，系统将找不到 openclaw 命令，这是最直接的验证方式

# 1. 安装指定版本（关键：@版本号不可省略）
npm install -g openclaw@2026.2.3
# 原理：@2026.2.3 告诉 npm 精确安装这个版本，而不是默认的最新版
# 2. 国内用户推荐加淘宝镜像加速（二选一）
npm install -g openclaw@2026.2.3 --registry=https://registry.npmmirror.com
# 原理：npm 默认从国外官方源下载，国内网络可能很慢或超时。淘宝镜像是官方源的完整拷贝，速度更快
# 3. 验证版本（输出应为 "2026.2.3"）
openclaw --version
# 原理：确认安装的版本号，避免装错

# 1. 在用户目录下创建一个专门的 npm 全局目录
mkdir ~/.npm-global
# 2. 配置 npm 使用这个新目录
npm config set prefix '~/.npm-global'
# 原理：告诉 npm 以后全局包都装在这里，不需要系统权限
# 3. 将这个目录添加到系统 PATH 中（这样系统才能找到命令）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
# 原理：~/.bashrc 是终端启动时自动加载的配置文件，把新目录加进去
# 4. 重新加载配置（让当前终端立即生效）
source ~/.bashrc
# 5. 现在可以愉快地安装了（不需要 sudo）
npm install -g openclaw@2026.2.3 --registry=https://registry.npmmirror.com

sudo chown -R $USER:$GROUP ~/.npm
# 原理：将 ~/.npm 目录的所有权还给当前用户，解决缓存目录权限问题

# 1. 强制关闭 OpenClaw 进程（防止文件被占用导致卸载失败）
killall OpenClaw || pkill OpenClaw
# 原理：如果程序正在运行，部分文件可能被锁定，卸载会报错。|| 表示如果 killall 失败，就用 pkill 重试
# 2. 卸载 deb 包（若通过 deb 安装）
sudo dpkg -r openclaw
# 原理：dpkg 是 Debian 系统的底层包管理工具，-r 表示 remove（移除）
# 3. 或卸载 snap 包（若通过 snap 安装）
sudo snap remove openclaw
# 原理：snap 是另一种包格式，需要用 snap 命令卸载

# 1. 创建临时目录并进入（保持文件整洁，方便后续清理）
mkdir -p ~/openclaw-downgrade && cd ~/openclaw-downgrade
# 原理：-p 表示如果目录已存在也不报错，&& 表示前一条命令成功后再执行后一条
# 2. 下载 deb 包
wget https://openclaw-official.oss-cn-beijing.aliyuncs.com/releases/2026.2.3/openclaw_2026.2.3_amd64.deb
# 原理：wget 是命令行下载工具，这里直接从官方阿里云 OSS 下载目标版本
# 备用方案：如果 wget 失败，直接把这个链接复制到浏览器下载，然后手动放到 ~/openclaw-downgrade 目录
# 3. 安装降级包
sudo dpkg -i openclaw_2026.2.3_amd64.deb
# 原理：-i 表示 install（安装）
# 4. 修复依赖（如果安装报错 "dependency problems"）
sudo apt install -f -y
# 原理：dpkg 不会自动解决依赖问题。apt install -f 会自动下载并安装缺失的依赖，-y 表示自动确认

# 1. 重置配置（清除高版本的不兼容配置）
openclaw config reset
# 原理：将所有配置恢复到 2026.2.3 的默认状态
# 2. 验证模型列表（确保常用模型可用）
openclaw model list
# 原理：检查模型列表是否正常加载

# 删除旧配置目录，让程序重新生成默认配置
rm -rf ~/.config/OpenClaw
# 原理：~/.config/OpenClaw 是 OpenClaw 存储用户配置的地方，删除后重启会自动重建

# 刷新官方模型列表
openclaw model refresh
# 原理：从服务器重新拉取最新的模型列表信息