[OpenClaw]-2-备份与还原详解

引言

我们在使用OpenClaw的过程中，不免会因为一些错误配置，导致OpenClaw的启动失败，俗称“虾被养死了”，为了确保我们的数据安全，避免因为重复配置浪费我们宝贵的时间，这篇文章主要讲解如何备份和还原OpenClaw的工作目录以及配置数据。

文章目录

0×1.基于Linux系统的OpenClaw备份与还原实例

我为你设计一个完整、可复现的 OpenClaw 备份 + 验证 + 还原实例，全程基于 Linux环境，每一步都有明确的操作和预期结果，能直观看到「备份→删除数据→还原」的完整流程：

1.记录备份前的OpenClaw信息，方便还原时验证

					
					# 查看OpenClaw版本信息
					 987@hk987.xyz:~$ openclaw --version
					OpenClaw 2026.3.13 (61d171a)

					# 记录下OpenClaw配置信息
					 987@hk987.xyz:~$ cat ~/.openclaw/openclaw.json

					# 记录下OpenClaw状态信息
					 987@hk987.xyz:~$ openclaw status
					 987@hk987.xyz:~$ openclaw gateway status

2.创建全量备份

					
					# 创建备份用文件夹（需要空间足够）
					 987@hk987.xyz:~$ mkdir openclaw-bk-20260323

					 # 停止网关服务
					 987@hk987.xyz:~$ openclaw gateway stop
					Stopped systemd service: openclaw-gateway.service

					# 确保服务的状态已经dead
					 987@hk987.xyz:~$ systemctl --user status openclaw-gateway.service
					     Active: inactive (dead)

					# 创建全量备份，指定目录
					openclaw backup create --output ~/openclaw-bk-20260323

					# 验证备份完整性
					 987@hk987.xyz:~$ ls  ~/openclaw-bk-20260323
					2026-03-23T07-28-59.075Z-openclaw-backup.tar.gz

					 987@hk987.xyz:~$ openclaw backup verify ~/openclaw-bk-20260323/2026-03-23T07-28-59.075Z-openclaw-backup.tar.gz
					# 完整性验证预期输出
					Backup archive OK: /home/jarvis/openclaw-bk-20260323/2026-03-23T07-28-59.075Z-openclaw-backup.tar.gz
					Archive root: 2026-03-23T07-28-59.075Z-openclaw-backup
					Created at: 2026-03-23T07:28:59.075Z
					Runtime version: 2026.3.13
					Assets verified: 1
					Archive entries scanned: 73

3.破坏性测试，模拟 “数据丢失”

					
					# 1. 移动备份原有数据，原数据文件夹将被重命名，导致OpenClaw找不到
					 987@hk987.xyz:~$ mv ~/.openclaw ~/.openclaw.bak

					# 2. 验证数据已删除（此时 OpenClaw 应无配置/会话）
					 987@hk987.xyz:~$ openclaw status

4.用备份文件恢复

					
					# 1. 解压备份文件到用户根目录（还原操作）
					 987@hk987.xyz:~$ cd ~
					 987@hk987.xyz:~$ tar -vxzf ~/openclaw-bk-20260323/2026-03-23T07-28-59.075Z-openclaw-backup.tar.gz -C ~

					# 2.将解压出来的文件夹中的.openclaw目录，复制到用户家目录
					# 请根据你解压出来的目录结构，找到其中的.openclaw目录所在位置
					 987@hk987.xyz:~$ cp -r 2026-03-23T08-16-57.499Z-openclaw-backup/payload/posix/home/jarvis/.openclaw/ ~
					# 3. 启动网关
					 987@hk987.xyz:~$ openclaw gateway start

					# 4. 修复文件权限（可选，如果网关无法启动，尝试修复权限）
					 987@hk987.xyz:~$ sudo chown -R $USER:$USER ~/.openclaw
					 987@hk987.xyz:~$ chmod -R 700 ~/.openclaw

5.验证备份恢复完整性

					
					# 验证版本，状态，会话（网页版对话记录）
					 987@hk987.xyz:~$ openclaw -v
					 987@hk987.xyz:~$ openclaw status
					 987@hk987.xyz:~$ openclaw gateway status
					 .....

总结：实际上对openclaw的数据目录做全量备份，等同于，使用tar -vcpzf对.openclaw目录进行打包，当遇到不可逆的错误时，再将备份的数据覆盖回去恢复即可。

0×2.基于Windows系统的OpenClaw备份与还原实例

Windows的备份还原操作思路和Linux是一样的，首先同样的，先停止服务（如果是在powershell中启动的，关闭窗口即可，或者在任务管理器进程里面搜索openclaw-gateway，结束掉进程。

1.使用官方命令，做全量备份，备份数据文件夹

					
					# 我用的是超级管理员用户登录的系统，所以这里的输出路径直接放到了Administrator的家目录下
					# 请根据你们自己的用户名修改输出路径
					C:\Users\Administrator> openclaw backup create --output C:\Users\Administrator\

2.破坏性试验，删除OpenClaw数据目录

					
					C:\Users\Administrator> Remove-Item .\.openclaw\ -Recurse -Force

3.通过备份文件恢复

					
					# 解压打包的备份文件到当前用户的家目录
					C:\Users\Administrator> tar -vxzf 2026-03-23T09-15-42.533Z-openclaw-backup.tar.gz -C C:\Users\Administrator\

					# 将解压后的.openclaw文件夹复制到当前用户家目录中
					C:\Users\Administrator> Copy-Item 2026-03-23T09-15-42.533Z-openclaw-backup\payload\windows\C\Users\Administrator\.openclaw\ $env:USERPROFILE\ -Recurse

这样就行了，所有的会话记录，token都能恢复到备份时的样子。