OpenClaw升级需优先强制备份~/.openclaw目录，再通过内置update命令安全升级；若CLI异常，可用官方脚本或Git手动同步；恢复时须按故障模块精准还原，避免全量覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在运行OpenClaw并计划升级至新版本，但担心配置丢失、技能失效或记忆数据清零，则需采用兼顾稳定性与数据完整性的更新路径。以下是确保版本升级不回退、配置全程保留的实操策略：
一、升级前强制原子化备份
所有升级操作均以~/.openclaw/目录为核心资产载体，该目录集中存储用户级配置、认证凭据、技能模块、任务数据库及记忆快照。未执行完整备份即启动升级，将导致数据不可逆损毁。
1、停止Gateway服务以冻结运行态： openclaw gateway stop
2、生成带毫秒级时间戳的完整副本： cp -r ~/.openclaw ~/.openclaw.backup-$(date +%Y%m%d-%H%M%S)
3、校验关键子项是否存在： ls -la ~/.openclaw.backup-$(date +%Y%m%d-%H%M%S)/{openclaw.json,skills/,db/tasks.db,workspace/memory/}
二、内置update命令标准升级（推荐）
该方式由CLI原生实现，自动拉取stable渠道最新代码包，校验依赖树一致性，并在升级完成后自动重启Gateway；整个过程严格隔离用户数据区，不修改~/.openclaw/内任何文件。
1、确认当前版本与可更新状态： openclaw --version && openclaw status
2、触发安全更新流程： openclaw update
3、等待终端输出Update completed及新版本号（如v2026.4.1），随后执行健康检查： openclaw health
三、官方安装脚本就地覆盖升级
当内置CLI因权限异常、网络拦截或二进制损坏无法响应时，此方式绕过本地CLI，直接调用远程诊断脚本识别安装类型、校验路径权限、执行增量文件覆盖，兼容pip、npm、git及云主机一键部署等多种安装形态。
1、执行无交互式脚本升级： curl -fsSL https://openclaw.bot/install.sh | bash -s -- --no-onboard
2、若为git源码安装，显式声明安装方法避免误判： curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git --no-onboard
3、升级完成后立即运行环境自检： openclaw doctor
四、Git源码目录手动同步更新
适用于深度定制用户或开发者，通过原仓库pull最新commit、重新构建二进制可执行文件完成升级。该方式完全规避全局包管理器干扰，所有用户配置、技能、记忆数据均保留在原始~/.openclaw/路径中，不受源码更新影响。
1、进入OpenClaw源码根目录： cd ~/openclaw
2、拉取最新稳定分支变更： git pull origin main
3、执行本地构建指令（根据README选择对应命令）： pnpm build && pnpm package
4、替换旧版二进制并验证路径： sudo cp dist/openclaw /usr/local/bin/openclaw && openclaw --version
五、按故障现象精准恢复子模块
全量恢复可能覆盖近期有效修改，因此必须依据具体异常定位受损单元，仅还原对应子目录，避免“一刀切”式覆盖引发新问题。恢复操作须在Gateway已停止状态下进行。
1、若openclaw.json解析失败或字段缺失： cp ~/openclaw-backup/20260415/openclaw.json ~/.openclaw/
2、若记忆历史清空但技能与配置正常： cp -r ~/openclaw-backup/20260415/workspace/memory/ ~/.openclaw/workspace/
3、若全部Skills报not found错误： rm -rf ~/.openclaw/skills/ && cp -r ~/openclaw-backup/20260415/skills/ ~/.openclaw/
