伯衡君的 OpenClaw 备份与迁移完全指南

开篇寄语

各位朋友，大家好，我是伯衡君。相信在使用 OpenClaw 的过程中，你一定积累了不少配置、扩展技能、定时任务等宝贵数据。这些内容就像我们的数字资产一样，重要性不言而喻。但是，如果有一天你需要换电脑，或者需要重装系统，这些数据该如何保留呢？今天，伯衡君就手把手教大家如何安全、高效地备份和迁移 OpenClaw 数据。全文都是实战经验，建议先收藏再看！

关于 OpenClaw 的备份和迁移，其实在官方文档中也有提及，但操作步骤比较分散。伯衡君结合了自己的实际操作经验，以及社区常见的疑问，特意整理了这份完整指南。

好了，废话不多说，让我们开始吧！

体验地址

想要体验 OpenClaw 的强大功能？立即访问官网：

• OpenClaw 官网：https://openclaw.ai

项目地址

• GitHub 项目地址：https://github.com/openclaw/openclaw

如果你觉得好用，别忘了给项目点个星星哦！

内容详情

下面，伯衡君将分为六个步骤，详细讲解备份和迁移的全流程。以下主要是 Linux 电脑备份教程，有图形界面的 Windows 和 MacOS 可以通过找到对应的文件夹，自己控制要保存什么内容，当然，下面的内容也可以进行参考。

一、备份前准备

在开始备份之前，我们需要做好环境检查，确保万无一失。

1.1 环境检查

首先，确认你的 OpenClaw 版本和当前状态：

# 确认OpenClaw版本
openclaw --version

# 查看当前状态目录
echo $OPENCLAW_STATE_DIR  # 默认 ~/.openclaw

# 检查存储空间（确保有2倍以上余量）
df -h ~/.openclaw

伯衡君小贴士：备份前一定要检查存储空间，否则备份到一半空间不足就很尴尬了。

1.2 清理敏感临时文件（推荐）

为了避免泄露敏感信息，建议在备份前清理以下内容：

# 清理日志中的敏感操作记录
rm -rf ~/.openclaw/logs/*.log

# 清理临时执行审批记录
rm -f ~/.openclaw/exec-approvals.json

# 确认没有残留的调试token
grep -r "token=" ~/.openclaw/openclaw.json || echo "无残留token"

二、创建备份（旧电脑）

环境检查完毕后，我们开始在旧电脑上创建备份。

2.1 完整备份（含工作区）

这是最全面的备份方式，会包含你的所有数据：

# 创建带时间戳的完整备份
openclaw backup create \
  --output ~/OpenClaw-Backups \
  --verify

输出示例：

✅ Backup created: ~/OpenClaw-Backups/2026-04-23T23-50-00.000Z-openclaw-backup.tar.gz
✅ Archive verified successfully

2.2 仅配置备份（适用于快速迁移）

如果你只需要迁移配置，不需要工作区文件，可以用这个方式，速度更快：

# 仅备份配置文件（不含工作区，速度快）
openclaw backup create \
  --only-config \
  --output ~/OpenClaw-Backups \
  --verify

2.3 备份内容清单

下面这些是备份文件中包含的内容，伯衡君已经帮你整理好了：

安全提示：credentials 目录包含你的第三方认证信息，一定要妥善保管！

三、安全传输（关键步骤）

备份创建好了，怎么安全地传到新电脑？这步非常重要！

3.1 推荐的传输方式

伯衡君对比了几种常见的传输方式：

3.2 加密传输命令

为了确保数据安全，强烈建议加密传输！

方式A：GPG加密（推荐）

# 接收方生成密钥（只需要执行一次）
gpg --gen-key

# 发送方加密
gpg -e -r "[email protected]" \
  ~/OpenClaw-Backups/2026-04-23T*.tar.gz

方式B：AES-256加密

openssl enc -aes-256-cbc -salt \
  -in backup.tar.gz \
  -out backup.tar.gz.enc \
  -pbkdf2 -iter 100000
# （需安全传递密码）

3.3 禁止的传输方式

这些方式千万不要用！

• ❌ 直接发送未加密的备份文件
• ❌ 通过微信/QQ传输（自动云端备份风险）
• ❌ 放在公开的下载链接

四、新电脑部署

备份传到新电脑后，接下来就是部署环节。

4.1 安装 OpenClaw

# 方式A：npm全局安装（推荐）
npm install -g openclaw

# 方式B：standalone二进制
# 从 https://github.com/openclaw/openclaw/releases 下载

4.2 初始化基础配置

# 首次运行（但不执行onboard）
openclaw configure
# 选择：仅配置频道，不执行完整onboard

4.3 恢复备份

这是最关键的一步，按顺序来：

# 步骤1：传输加密文件到新电脑并解密

# 步骤2：解压备份
tar -xzf ~/Downloads/2026-04-23T*-openclaw-backup.tar.gz \
  -C ~/

# 步骤3：验证文件权限
chmod 700 ~/.openclaw
chmod 600 ~/.openclaw/openclaw.json
chmod 700 ~/.openclaw/credentials
chmod -R 600 ~/.openclaw/credentials/*

# 步骤4：验证配置有效性
openclaw config validate

4.4 关键配置检查清单

恢复完成后，记得检查以下项目：

• [ ] openclaw.json 中 API Key 有效
• [ ] credentials/ 目录权限正确
• [ ] 频道配置（WhatsApp/Telegram/Discord）已恢复
• [ ] 扩展技能可用：openclaw extensions list
• [ ] 定时任务：openclaw cron list
• [ ] 设备配对：openclaw devices list

五、迁移后的安全加固

数据迁移完了，别忘了做安全加固！

5.1 立即执行

# 重新生成gateway认证token
openclaw config unset gateway.token
openclaw config set gateway.token  # 生成新token

# 吊销旧设备会话
openclaw sessions revoke --all

# 检查未授权的活跃会话
openclaw sessions list

5.2 可选：定期备份脚本

为了避免以后手动备份，伯衡君推荐设置自动备份：

# 创建 ~/.local/bin/oclaw-backup.sh
#!/bin/bash
BACKUP_DIR="$HOME/OpenClaw-AutoBackups"
mkdir -p "$BACKUP_DIR"
openclaw backup create \
  --output "$BACKUP_DIR" \
  --no-include-workspace \
  --verify

# 保留最近7个备份
cd "$BACKUP_DIR"
ls -t | tail -n +8 | xargs -r rm

# 添加crontab：每天3点自动备份
# 0 3 * * * ~/.local/bin/oclaw-backup.sh

六、故障排查

常见问题及解决方案，收藏备用：

篇后寄语

好了，今天的教程就到这里。

通过这篇指南，伯衡君相信你已经掌握了 OpenClaw 备份和迁移的全部技巧。数据无价，定期备份是个好习惯，建议大家都设置一下自动备份，防患于未然。

如果你在操作过程中遇到任何问题，欢迎在评论区留言，伯衡君会尽力帮你解答！

觉得有用的话，点个在看，分享给更多朋友吧！