搞崩了也不怕: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 停了，防止备份到一半文件被修改。

•如果你有终端（ Linux/macOS ）：输入 openclaw gateway stop 回车

•如果你用 Windows ：打开命令提示符，输入 openclaw gateway stop 回车

•不知道终端是啥？直接关掉 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 ，方便存到网盘或者发给自己：

•Windows ：右键文件夹 → 「发送到」→ 「压缩(zipped)文件夹」

•macOS ：右键文件夹 → 「压缩」

•Linux ：右键文件夹 → 「压缩」→ 选 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 里记一份任务清单。

三种方案，选适合你的

方式	要不要敲命令	自动化	能回退到历史版本	适合谁
鼠标复制粘贴	❌	❌	❌	刚入门，先保命
压缩包 + 网盘	❌	❌	❌	偶尔手动备份
Git + 私有仓库	✅	✅	✅	想要一劳永逸

总结

1.OpenClaw 的一切都在 .openclaw 文件夹里，备份它就等于备份了你的 AI

2.小白用鼠标就能备份——复制文件夹、粘贴、压缩，三步搞定

3.恢复后跑三行命令：doctor → secrets migrate → gateway restart

4.想自动化？ Git + 私有仓库 + 定时任务