搞崩了也不怕：OpenClaw 备份与恢复完全指南
折腾 OpenClaw ，最重要三个技能：备份、重装、迁移。
不管你是刚玩两天的新手，还是已经把 AI 养出性格的老玩家，迟早会遇到配置炸了、换机器、或者单纯手贱改坏了想回退的场景。这篇文章把备份这件事讲透——小白用鼠标就能搞定，高手用 Git 一劳永逸。
先搞清楚： OpenClaw 的文件在哪
OpenClaw 把所有数据存在一个文件夹里，位置跟你的系统有关：
| Linux
~/.openclaw/| macOS~/.openclaw/| WindowsC:\Users\你的用户名\.openclaw\
~符号代表当前用户的主目录（ Linux/macOS 下可以用它代替/home/你的用户名或/Users/你的用户名）。macOS 提示：
.openclaw是隐藏文件夹。在 Finder 里按Cmd + Shift + .可以显示隐藏文件。Windows 提示：
.openclaw默认隐藏。在文件资源管理器「查看」选项卡里勾选「隐藏的项目」就能看到。
这个文件夹里有什么？简单说：
.openclaw/──openclaw.json←主配置（你改过的设置）──workspace/←Agent的大脑（人设、记忆、技能）──SOUL.md←性格和说话方式──MEMORY.md←长期记忆──skills/←装的技能──agents/←运行状态和会话记录──credentials/←飞书、WhatsApp等渠道登录态──skills/←全局共享技能──extensions/←已安装插件一句话： 备份这个文件夹 = 备份你的 AI 的一切。
小白版：鼠标操作，不敲命令
备份
第一步：关掉 OpenClaw
先把 OpenClaw 停了，防止备份到一半文件被修改。
•如果你有终端（ Linux/macOS ）： 输入 openclaw gateway stop 回车•**如果你用 Windows **： 打开命令提示符，输入 openclaw gateway stop 回车•不知道终端是啥？ 直接关掉 OpenClaw 的后台程序也行，或者跳过这步碰运气（大多数情况下没事，但稳妥起见还是关一下）
第二步：找到 .openclaw 文件夹，整个复制
**Windows **：
- 打开「文件资源管理器」
- 地址栏输入
%USERPROFILE%回车 - 找到
.openclaw文件夹（可能需要先显示隐藏文件） - 右键 → 复制
- 粘贴到桌面（或 U 盘、移动硬盘）
**macOS **：
- 打开 Finder
- 按
Cmd + Shift + G，输入~/.openclaw回车 - 现在你看到 .openclaw 文件夹了
- 把它拖到桌面（或外接硬盘）——按住 Option 拖是复制
**Linux **：
- 打开文件管理器（ Nautilus / Dolphin / Thunar ）
- 按
Ctrl + L，输入~/.openclaw回车 - 复制整个文件夹到你想放的地方
第三步：压缩一下（可选但推荐）
文件夹复制完后，右键压缩成 zip ，方便存到网盘或者发给自己：
•**Windows **： 右键文件夹 → 「发送到」→ 「压缩(zipped)文件夹」•**macOS **： 右键文件夹 → 「压缩」•**Linux **： 右键文件夹 → 「压缩」→ 选 zip
💡 只想保底？ 如果你只是怕改坏人设，不需要完整备份，只复制
workspace子文件夹就够了。这里面是 Agent 的性格和记忆，是你花最多时间调教出来的。
恢复（在新电脑上）
第一步：装好 OpenClaw ，但先别启动
第二步：把备份粘贴回去
**Windows **：
- 打开文件资源管理器，地址栏输入
%USERPROFILE%回车 - 如果已经有
.openclaw文件夹，先删掉或改名（比如改成.openclaw-old） - 把备份的
.openclaw文件夹粘贴到这里
**macOS **：
- Finder 里
Cmd + Shift + G，输入~回车 - 把备份的
.openclaw拖进来 - 如果提示文件夹已存在，选「替换」
**Linux **：
- 打开文件管理器，进主目录
- 粘贴
.openclaw文件夹 - 覆盖已有文件
第三步：运行修复工具
这步需要打开终端了（只有这一步需要）：
**Windows **： 按 Win + R，输入 cmd 回车
**macOS **： 打开「终端」应用
**Linux **： 打开终端
然后依次输入这三行命令（每输一行按一次回车）：
openclawdoctor--deep--repair openclawsecretsmigrate openclawgatewayrestart 这三行命令做了什么：
- 第一行：自动修复路径和兼容性问题
- 第二行：重新加密你的 API 密钥（换电脑后必须做）
- 第三行：启动 OpenClaw
第四步：验证
打开浏览器访问 http://127.0.0.1:18789，看看历史会话和技能列表是不是都在。然后用你绑定的聊天软件给 Agent 发条消息，能正常回复就说明恢复成功了。
进阶版： Git 备份到云端（适合愿意用命令行的人）
手动复制有个问题：你得记得去做。 Git 备份的好处是能自动化，而且有版本历史——改坏了可以回到任意时间点。
初始化
cd~/.openclaw/ gitinit 创建一个 .gitignore 文件，排除不该提交的东西：
cat>.gitignore<<'EOF'agents/*/sessions/exec-approvals.sock*.socksecrets.jsoncredentials/extensions/*/node_modules/extensions/*/package-lock.jsonsandboxes/mpm/plugins/EOF gitadd. gitcommit-m"初始备份：OpenClaw 完整配置"推到 GitHub 或 Gitee
gitremoteaddorigingit@github.com:你的用户名/openclaw-backup.git gitpush-uoriginmain ⚠️ 仓库一定要设成私有！ 里面有你的 SOUL.md 、 USER.md 、 MEMORY.md ，都是个人数据。
日常备份
改了配置或者 Agent 学了新东西之后：
cd~/.openclaw/ openclawgatewaystop gitadd-A gitcommit-m"备份：$(date+%Y-%m-%d)" gitpush openclawgatewaystart 自动化：每天凌晨自动备份
crontab-e 添加这行：
03***cd~/.openclaw/&&gitadd-A&&gitcommit-m"auto backup $(date+\%Y-\%m-\%d)"2>/dev/null&&gitpushoriginmain2>/dev/null Windows 用户可以用「任务计划程序」创建一个定时任务，执行同样的 git 命令。
实战踩坑：这些坑我替你踩过了
坑一：别漏掉 workspace 以外的目录
~/.openclaw/ 下除了 workspace/，还可能有 workspace-creator/ 之类的额外工作区（多 Agent 架构产生的）。备份前扫一眼目录，别漏了。
坑二：恢复后的启动顺序有讲究
❌ 错误顺序：复制文件 → 直接启动 → Agent 不回复
✅ 正确顺序：复制文件 → openclaw doctor --deep --repair → openclaw secrets migrate → 启动
原因：新电脑的加密环境不同，直接启动会导致 API Key 读取失败。
坑三：记忆文件和会话记录可能不同步
MEMORY.md 和 memory/ 目录下的日志更新频率不同。恢复后检查一下最近几天的日志是不是最新的，必要时手动整理一次。
坑四：定时任务不会跟着备份走
系统的 crontab （ Linux/macOS ）或任务计划（ Windows ）不在备份范围内。恢复后需要手动重建。建议在 TOOLS.md 里记一份任务清单。
三种方案，选适合你的
鼠标复制粘贴 ❌ ❌ ❌ 刚入门，先保命
压缩包 + 网盘 ❌ ❌ ❌ 偶尔手动备份
Git + 私有仓库 ✅ ✅ ✅ 想要一劳永逸
总结
1.OpenClaw 的一切都在 .openclaw 文件夹里，备份它就等于备份了你的 AI2.小白用鼠标就能备份——复制文件夹、粘贴、压缩，三步搞定3.恢复后跑三行命令：doctor → secrets migrate → gateway restart4.想自动化？ Git + 私有仓库 + 定时任务5.备份前扫一眼目录，别漏掉 workspace 以外的文件夹
花五分钟做个备份，省五小时重建的痛苦。你的 Agent 的性格和记忆，值得被好好保护。