# 1. 執(zhí)行全局卸載
npm uninstall -g openclaw
# 原理：npm uninstall -g 會從全局 node_modules 目錄中刪除 openclaw 包及其鏈接
# 2. 驗證卸載（若提示 "command not found" 則成功）
openclaw --version
# 原理：如果卸載成功，系統(tǒng)將找不到 openclaw 命令，這是最直接的驗證方式

# 1. 安裝指定版本（關鍵：@版本號不可省略）
npm install -g openclaw@2026.2.3
# 原理：@2026.2.3 告訴 npm 精確安裝這個版本，而不是默認的最新版
# 2. 國內(nèi)用戶推薦加淘寶鏡像加速（二選一）
npm install -g openclaw@2026.2.3 --registry=https://registry.npmmirror.com
# 原理：npm 默認從國外官方源下載，國內(nèi)網(wǎng)絡可能很慢或超時。淘寶鏡像是官方源的完整拷貝，速度更快
# 3. 驗證版本（輸出應為 "2026.2.3"）
openclaw --version
# 原理：確認安裝的版本號，避免裝錯

# 1. 在用戶目錄下創(chuàng)建一個專門的 npm 全局目錄
mkdir ~/.npm-global
# 2. 配置 npm 使用這個新目錄
npm config set prefix '~/.npm-global'
# 原理：告訴 npm 以后全局包都裝在這里，不需要系統(tǒng)權限
# 3. 將這個目錄添加到系統(tǒng) PATH 中（這樣系統(tǒng)才能找到命令）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
# 原理：~/.bashrc 是終端啟動時自動加載的配置文件，把新目錄加進去
# 4. 重新加載配置（讓當前終端立即生效）
source ~/.bashrc
# 5. 現(xiàn)在可以愉快地安裝了（不需要 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 系統(tǒng)的底層包管理工具，-r 表示 remove（移除）
# 3. 或卸載 snap 包（若通過 snap 安裝）
sudo snap remove openclaw
# 原理：snap 是另一種包格式，需要用 snap 命令卸載

# 1. 創(chuàng)建臨時目錄并進入（保持文件整潔，方便后續(xù)清理）
mkdir -p ~/openclaw-downgrade && cd ~/openclaw-downgrade
# 原理：-p 表示如果目錄已存在也不報錯，&& 表示前一條命令成功后再執(zhí)行后一條
# 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 的默認狀態(tài)
# 2. 驗證模型列表（確保常用模型可用）
openclaw model list
# 原理：檢查模型列表是否正常加載

# 刪除舊配置目錄，讓程序重新生成默認配置
rm -rf ~/.config/OpenClaw
# 原理：~/.config/OpenClaw 是 OpenClaw 存儲用戶配置的地方，刪除后重啟會自動重建

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