必须先备份~/.openclaw/目录，执行tar -zcvf ~/desktop/openclaw_backup_$(date +%y%m%d).tar.gz ~/.openclaw/；未备份则所有恢复无效，后续操作需先彻底清理残留再解压覆盖或符号链接还原。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署后因网关卡死、重装或迁移导致配置丢失，想快速找回原有模型设置、已装技能、会话记忆和自定义渠道对接，必须依赖备份文件而非重新配对。
确认核心数据是否已备份
所有配置、记忆、技能都存在 【~/.openclaw/】 目录下，若你从未执行过备份，现在立刻停止后续操作——先用命令打包该目录：
tar -zcvf ~/Desktop/openclaw_backup_$(date +%Y%m%d).tar.gz ~/.openclaw/
这一步不可跳过。没有这个压缩包，后面所有恢复步骤都无效。
恢复前彻底清理残留
若之前安装在C盘，现要迁移到D盘或重装，必须清空旧环境，否则新旧配置冲突会导致gateway启动失败或token反复报错：
第一步：卸载全局包
npm uninstall -g openclaw
第二步：强制删除全局模块残留
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
第三步：删除用户数据目录（⚠️此操作不可逆）
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
第四步：手动删掉桌面、开始菜单里的快捷方式，以及 C:\Program Files\OpenClaw 文件夹（如有）。
解压备份并覆盖还原
方法一：直接覆盖（适用于同版本恢复）
把备份的 openclaw_backup_20260310.tar.gz 解压到任意位置 → 找到解压出的 .openclaw 文件夹 → 将其完整复制粘贴到 【%USERPROFILE%】 目录下（即 C:\Users\你的用户名\），系统会提示“是否替换”，选“全部替换”。
方法二：路径映射还原（适用于迁移到D盘）
把备份解压后得到的 .openclaw 文件夹，整体移动到 D:\OpenClaw\data\；然后在 PowerShell 中执行：
cmd /c mklink /J "%USERPROFILE%\.openclaw" "D:\OpenClaw\data\.openclaw"
这一步建立的是符号链接，OpenClaw 启动时仍读取 %USERPROFILE%\.openclaw，但实际访问的是 D 盘路径。不这样做，程序会初始化全新空白配置。
重启并验证恢复效果
双击 Openclaw Windows 一键启动.exe → 等待 Gateway 就绪（约1–2分钟）→ 打开主界面 → 点击左下角「设置」→ 查看「模型配置」是否保留原LM Studio地址、「已安装技能」列表是否完整、「会话历史」能否翻阅上周任务记录。
若 workspace/ 和 state/ 子目录存在且非空，说明记忆与上下文学习记录已成功恢复；extensions/ 里有飞书或微信插件文件，则渠道对接也完好。
