OpenClaw 服务器配置迁移指南
想把服务器上的 OpenClaw 配置迁移到本地？本文提供 3 种方案，含详细步骤和避坑指南，10 分钟搞定迁移！
来源：微信公众号
链接：https://mp.weixin.qq.com/s/R7SaiYcvUN7jqCSTiXh8uA
发布时间：2026-03-19
整理时间：2026-03-20
概述
相信很多 OpenClaw 用户都有这样的需求：将服务器上的 OpenClaw 配置迁移到本地电脑。
但是直接操作会遇到这些问题：
- ❌ 直接复制文件，中文文件名乱码
- ❌ 配置不生效，技能丢失
- ❌ 记忆文件损坏
本文提供完整的迁移方案，包含详细步骤和避坑指南。
迁移前准备
迁移前，确保你知道以下信息：
- 服务器 IP 地址
- 登录用户名和密码
- OpenClaw 安装路径（通常是
~/.openclaw）
3 种迁移方案
方案 A：ZIP 备份 + WinSCP（Windows 用户推荐）⭐
推荐指数：⭐⭐⭐⭐⭐
适用场景：Windows 用户，最简单！
步骤 1：在服务器上创建 ZIP 备份包
cd /home/admin
# 创建 ZIP 备份包（兼容 Windows）
zip -r openclaw_full_backup_$(date +%Y%m%d_%H%M%S).zip \
.openclaw/config.json \
.openclaw/workspace/ \
.openclaw/skills/ \
.openclaw/extensions/ \
-x "*.git*" \
-x "*node_modules*" \
-x "*__pycache__*" \
-x "*.log"执行后输出：
=== ZIP 备份完成 ===
-rw-rw-r-- 1 admin admin 80M Mar 19 19:55 openclaw_full_backup_20260319_191309.zip说明：
- ✅ ZIP 格式：Windows 原生支持，不会乱码
- ✅ 排除文件：排除不必要的文件，减小体积
- ✅ 时间戳：文件名包含时间，方便管理
⚠️ 重要提示：一定要用 ZIP 格式，tar.gz 在 Windows 上解压会乱码！
步骤 2：下载并安装 WinSCP
下载地址：https://winscp.net/eng/download.php
打开 WinSCP，填写：
- 文件协议：SFTP
- 主机名：你的服务器 IP（例如：47.103.209.105）
- 端口号：22
- 用户名：root（或 admin）
- 密码：你的服务器密码
点击"登录"，首次连接会提示"主机密钥未知"，点击"是"。
💡 WinSCP 是 Windows 上最好的 SFTP 客户端，免费且开源。
步骤 3：下载备份包到本地
- 登录服务器后，找到刚才创建的 ZIP 文件
- 拖拽到本地电脑的 Downloads 文件夹
步骤 4：解压备份包
⚠️ 重要：一定要用 Windows 自带解压功能！
❌ 错误操作：
- 不要用 WinRAR（可能乱码）
- 不要用 7-Zip（可能乱码）
- 不要用第三方解压工具
✅ 正确操作：
- 右键点击 ZIP 文件
- 选择"全部解压缩"
- 使用 Windows 自带解压功能
步骤 5：复制到 OpenClaw 目录
- 找到解压后的文件，应该看到
.openclaw文件夹 - 在文件资源管理器地址栏输入：
%USERPROFILE%\.openclaw - 按 Enter 键
- 如果
.openclaw不存在，直接创建一个 - 复制解压后的文件到该目录
步骤 6：验证迁移
打开 OpenClaw，测试：
- ✅ 能正常对话
- ✅ 中文文件名正常显示
- ✅ 能识别图片
- ✅ 技能列表完整
方案 B：SCP 下载（Mac/Linux 用户推荐）⭐
推荐指数：⭐⭐⭐⭐
适用场景：Mac/Linux 用户
步骤 1：在服务器上创建 ZIP 备份包
cd /home/admin
# 创建 ZIP 备份包
zip -r openclaw_full_backup_$(date +%Y%m%d_%H%M%S).zip \
.openclaw/config.json \
.openclaw/workspace/ \
.openclaw/skills/ \
.openclaw/extensions/ \
-x "*.git*" \
-x "*node_modules*" \
-x "*__pycache__*" \
-x "*.log"步骤 2：使用 scp 下载到本地
在本地电脑终端执行：
# 下载备份包
scp user@server:/home/admin/openclaw_full_backup_*.zip ~/Downloads/
# 示例
scp admin@47.103.209.105:/home/admin/openclaw_full_backup_20260319_191309.zip ~/Downloads/输入服务器密码后开始下载。
步骤 3：解压并复制
cd ~/Downloads
# 解压
unzip openclaw_full_backup_*.zip
# 复制文件
cp -r .openclaw/config.json ~/.openclaw/
cp -r .openclaw/workspace/* ~/.openclaw/workspace/
cp -r .openclaw/skills/* ~/.openclaw/skills/
cp -r .openclaw/extensions/* ~/.openclaw/extensions/步骤 4：重启验证
# 重启 Gateway
openclaw gateway restart
# 验证
openclaw status方案 C：rsync 同步（高级用户）⭐
推荐指数：⭐⭐⭐
适用场景：Linux/Mac 高级用户，需要频繁同步
一步同步
rsync -avz user@server:~/.openclaw/ ~/.openclaw_local/参数说明：
-a：归档模式，保留权限-v：详细输出-z：压缩传输
常见问题解答
Q1: 中文文件名乱码
原因：使用了不兼容的解压工具
解决：
- 删除解压的文件
- 用 Windows 自带解压功能重新解压
- 右键 → "全部解压缩"
Q2: 配置不生效
原因：OpenClaw 正在运行，文件被锁定
解决：
- 关闭 OpenClaw
- 重新复制文件
- 重启 OpenClaw
Q3: API Key 错误
原因：API Key 与当前环境不匹配
解决：
- 编辑
config.json - 更新 API Key
- 保存后重启
Q4: 技能丢失
原因：skills 文件夹未正确复制
解决：
# 重新同步技能
clawhub syncQ5: 记忆文件损坏
原因：复制过程中断
解决：
- 重新下载备份包
- 重新复制 memory 文件夹
- 验证文件完整性
迁移后检查清单
迁移完成后，逐项检查：
- [ ] OpenClaw 能正常启动
- [ ] 能正常对话
- [ ] 中文文件名正常显示
- [ ] 技能列表完整
- [ ] 记忆文件正常
- [ ] 工作空间文件完整
最佳实践
1. 定期备份
# 添加到 crontab，每周日 2:00 备份
0 2 * * 0 cd /home/admin && zip -r openclaw_backup_$(date +\%Y\%m\%d).zip .openclaw/2. 版本管理
使用 Git 管理工作空间：
cd ~/.openclaw/workspace
git init
git add .
git commit -m "初始提交"3. 云同步
使用网盘同步配置（注意不要同步 node_modules 和大文件）。
4. 配置变更日志
在 workspace 创建 CHANGELOG.md：
# 配置变更日志
## 2026-03-19
- 迁移到本地电脑
- 更新 API Key
- 添加新技能🎓 总结
迁移步骤回顾
Windows 用户：
- 服务器创建 ZIP 备份
- WinSCP 下载到本地
- Windows 自带解压
- 复制到
.openclaw目录 - 重启验证
Mac/Linux 用户：
- 服务器创建 ZIP 备份
- scp 下载到本地
- unzip 解压
- 复制文件
- 重启验证
本文基于实际迁移经验编写，测试环境：Windows 10 + OpenClaw 2026.3.13
迁移成功了吗？欢迎在评论区分享你的经验！