OpenClaw 更新器

通过自动化的预更新安全检查与回滚能力，安全地更新 OpenClaw。

更新前检查清单

运行 openclaw update 前，请始终先执行预更新脚本：

bash scripts/pre-update.sh

（可选）指定预检阶段要执行的备份脚本：

BACKUP_SCRIPT=~/repo/scripts/backup-openclaw.sh bash scripts/pre-update.sh

该脚本将执行以下操作：

1. 查找 ~/.openclaw/ 目录下所有名为 workspace* 的目录
2. 对所有未提交的更改执行 Git 提交（若目录尚未初始化 Git，则自动初始化）
3. 将 openclaw.json 备份至 /tmp/openclaw.json.bak
4. 如已提供备份脚本，则运行该脚本
5. 将当前版本号保存至 /tmp/openclaw-prev-version.txt

Telegram 通知配置

更新脚本通过 Telegram Bot API 发送成功或失败通知（绕过 OpenClaw 网关，因此即使更新导致网关中断，通知仍可正常发送）。

创建文件 ~/.openclaw/.telegram-notify.env：

TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=

chmod 600 ~/.openclaw/.telegram-notify.env

此处使用的 Bot Token 与 OpenClaw Telegram 频道所用的相同。Chat ID 可通过 openclaw directory 命令获取。

更新（含通知）

执行完整更新流程（含自动预检 + Telegram 通知）：

bash scripts/update.sh

该命令将依次执行：预检 → 更新 → 等待网关就绪 → 通过 Telegram 发送通知。

更新（手动）

在预检通过后，可手动执行更新：

openclaw update

更新后验证

更新完成后，请执行以下命令进行验证：

openclaw status
openclaw gateway status

请确认以下各项均符合预期：

• 显示的版本号为新发布的版本
• 网关处于运行状态
• 所有 Agent 均可正常响应

回滚

若更新引发异常，请运行：

bash scripts/rollback.sh

该脚本将执行以下操作：

1. 从 /tmp/openclaw-prev-version.txt 中读取保存的上一版本号
2. 通过 npm install -g openclaw@ 安装该版本
3. （可选）从备份中恢复 openclaw.json
4. 重启网关

手动回滚

若回滚脚本不可用，请按以下步骤操作：

# 安装指定版本
npm install -g openclaw@

# 恢复配置文件
cp /tmp/openclaw.json.bak ~/.openclaw/openclaw.json

# 重启服务
openclaw gateway restart

从完整备份中恢复

若配置文件与工作区均损坏，请执行以下操作：

# 查找最新备份文件
ls -t ~/repo/backups/openclaw-*.tar.gz | head -1

# 恢复备份（将覆盖 ~/.openclaw/ 目录）
tar xzf ~/repo/backups/openclaw-.tar.gz -C ~/