保持 OpenClaw 更新是确保安全性和获取新功能的关键。本文覆盖完整的版本管理流程。
查看当前版本
bash
openclaw --version
# 输出示例：openclaw/1.4.2 darwin-arm64 node-v24.0.0
# 或查看详细状态
openclaw status一键更新（推荐）
bash
# 更新到最新稳定版
npm update -g openclaw
# 更新后重启 Gateway 服务
openclaw gateway restart
# 验证新版本
openclaw --version
openclaw doctor # 检查配置兼容性或使用 OpenClaw 内置命令：
bash
openclaw update # 检查并更新到最新版
openclaw update --check # 只检查，不更新查看更新日志
更新前先看看有什么变化：
bash
# 方法 1：命令行查看
openclaw changelog
# 方法 2：浏览器查看 GitHub Releases
# https://github.com/openclaw/openclaw/releases建议重点关注标注 BREAKING CHANGE 的版本，这类更新需要手动调整配置。
更新前备份（重要）
bash
# 备份整个 OpenClaw 配置目录
cp -r ~/.openclaw ~/.openclaw.backup.$(date +%Y%m%d)
# 确认备份成功
ls ~/.openclaw.backup.*备份内容包括：
openclaw.json：主配置文件（频道、模型设置）workspace-content/：Agent 工作区（SOUL.md、MEMORY.md、技能等）tokens/：OAuth Token（Telegram/Discord/Gmail 等授权）logs/：历史日志
重大版本迁移注意事项
配置文件结构变化
部分大版本更新会调整 openclaw.json 的结构。更新后如果启动失败，运行：
bash
openclaw doctor
# 自动检测配置问题并提供修复建议
openclaw migrate
# 自动迁移旧版本配置到新格式频道 Token 重新授权
如果更新后某个频道（如 Telegram、Discord）连接失败，可能需要重新授权：
bash
# 重新配置 Telegram
openclaw configure --section channels.telegram
# 重新配置 Discord
openclaw configure --section channels.discordWorkspace 兼容性
SOUL.md、MEMORY.md、AGENTS.md 等工作区文件通常不受版本影响， OpenClaw 对这些用户自定义文件保持向后兼容。
更新后验证清单
bash
# 1. 检查 Gateway 正常运行
openclaw gateway status
# 2. 诊断潜在问题
openclaw doctor
# 3. 测试 Telegram 频道
# 给 Bot 发一条消息，确认有回复
# 4. 检查 Dashboard 可访问
openclaw dashboard # 自动打开浏览器
# 5. 确认 AI 模型配置正常
openclaw configure --list回滚到旧版本
如果新版本有问题，回滚步骤：
bash
# 方法 1：安装指定版本
npm install -g openclaw@1.3.5 # 替换为目标版本号
# 查看所有可用版本
npm view openclaw versions --json
# 方法 2：从备份恢复配置
cp -r ~/.openclaw.backup.20260316 ~/.openclaw
# 重启服务
openclaw gateway restart订阅版本更新通知
GitHub Watch
- 访问 https://github.com/openclaw/openclaw
- 点击右上角 Watch → Custom → 勾选 Releases
- 有新版本发布时自动收到邮件通知
用 OpenClaw 自己监控更新（自动化）
bash
# 添加 Cron 任务，每天检查更新
openclaw cron add --schedule "0 10 * * 1" --task "检查 OpenClaw 是否有新版本（npm view openclaw version），
如果比当前版本新，发 Telegram 通知告诉我有新版本，
附上 GitHub Release 链接"更新频率建议
| 更新类型 | 频率建议 | 处理方式 |
|---|---|---|
| 安全补丁（patch） | 立即更新 | npm update -g openclaw |
| 功能更新（minor） | 1-2 周内更新 | 看 changelog 后更新 |
| 重大版本（major） | 谨慎评估后更新 | 备份 → 看迁移指南 → 更新 |
来源：OpenClaw 官方文档 - docs.openclaw.ai/install/updating