搞崩了也不怕:OpenClaw 备份与恢复完全指南

折腾 OpenClaw ，最重要三个技能：备份、重装、迁移。

不管你是刚玩两天的新手，还是已经把 AI 养出性格的老玩家，迟早会遇到配置炸了、换机器、或者单纯手贱改坏了想回退的场景。这篇文章把备份这件事讲透——小白用鼠标就能搞定，高手用 Git 一劳永逸。

先搞清楚： OpenClaw 的文件在哪

OpenClaw 把所有数据存在一个文件夹里，位置跟你的系统有关：

 | Linux                                                    ~/.openclaw/ | macOS                                                ~/.openclaw/ | Windows                                            C:\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 停了，防止备份到一半文件被修改。

第二步：找到 .openclaw 文件夹，整个复制

Windows ： 1. 打开「文件资源管理器」 2. 地址栏输入 %USERPROFILE% 回车 3. 找到 .openclaw 文件夹（可能需要先显示隐藏文件） 4. 右键 → 复制 5. 粘贴到桌面（或 U 盘、移动硬盘）

macOS ： 1. 打开 Finder 2. 按 Cmd + Shift + G，输入 ~/.openclaw 回车 3. 现在你看到 .openclaw 文件夹了 4. 把它拖到桌面（或外接硬盘）——按住 Option 拖是复制

Linux ： 1. 打开文件管理器（ Nautilus / Dolphin / Thunar ） 2. 按 Ctrl + L，输入 ~/.openclaw 回车 3. 复制整个文件夹到你想放的地方

第三步：压缩一下（可选但推荐）

文件夹复制完后，右键压缩成 zip ，方便存到网盘或者发给自己：

💡 只想保底？ 如果你只是怕改坏人设，不需要完整备份，只复制 workspace 子文件夹就够了。这里面是 Agent 的性格和记忆，是你花最多时间调教出来的。

恢复（在新电脑上）

第一步：装好 OpenClaw ，但先别启动

第二步：把备份粘贴回去

Windows ： 1. 打开文件资源管理器，地址栏输入 %USERPROFILE% 回车 2. 如果已经有 .openclaw 文件夹，先删掉或改名（比如改成 .openclaw-old） 3. 把备份的 .openclaw 文件夹粘贴到这里

macOS ： 1. Finder 里 Cmd + Shift + G，输入 ~ 回车 2. 把备份的 .openclaw 拖进来 3. 如果提示文件夹已存在，选「替换」

Linux ： 1. 打开文件管理器，进主目录 2. 粘贴 .openclaw 文件夹 3. 覆盖已有文件

第三步：运行修复工具

这步需要打开终端了（只有这一步需要）：

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 里记一份任务清单。

三种方案，选适合你的

总结

花五分钟做个备份，省五小时重建的痛苦。你的 Agent 的性格和记忆，值得被好好保护。