
49.9尝鲜200元的arkclaw套餐,马上一个月到期了。感觉大模型一般,不准备续费了,养了一个月,直接放弃是不可能的,本文详细介绍了如何将 OpenClaw/龙虾完整地从云主机迁移到本地,保留所有配置、技能、记忆和定时任务。

📋 迁移概览
OpenClaw 的设计是全数据在本地,所以迁移起来非常简单,只需要备份 -> 传输 -> 恢复三步即可。整个过程大概需要 5-10 分钟,取决于你的工作区大小。
1️⃣ 第一步:在旧主机备份数据
首先,我们需要停止服务并备份整个工作区:
# 1. 停止 OpenClaw 服务
openclaw gateway stop
# 2. 进入用户目录
cd ~
# 3. 压缩备份整个工作区
tar -czf openclaw-workspace-$(date +%Y%m%d).tar.gz .openclaw/
# 4.(可选)如果配置在 ~/.config/openclaw,也一并备份
# tar -czf openclaw-config-$(date +%Y%m%d).tar.gz ~/.config/openclaw/
# 5. 检查备份大小
ls -lh *.tar.gz
备份完成后,你会得到一个类似 openclaw-workspace-20260406.tar.gz 的压缩包。
2️⃣ 第二步:传输备份到新主机
推荐使用 rsync 进行传输,它支持断点续传,比 scp 更稳定:
# 如果你需要指定非默认SSH端口(示例端口 9822)
rsync -avz -P -e "ssh -p 9822" openclaw-workspace-20260406.tar.gz username@new-host-ip:~/
如果习惯用 scp:
scp -P 9822 openclaw-workspace-20260406.tar.gz username@new-host-ip:~/
3️⃣ 第三步:在新主机安装 OpenClaw
先在新主机安装基础环境:
# 1. 检查 Node.js 版本(需要 ≥ 22)
node --version
# 如果版本不够,先升级 Node.js
# 2. 安装 OpenClaw
npm install -g openclaw@latest
# 3. 创建工作区目录
mkdir -p ~/.openclaw
4️⃣ 第四步:恢复备份
在新主机解压备份:
# 1. 进入用户目录
cd ~
# 2. 解压工作区备份
tar -xzf openclaw-workspace-20260406.tar.gz
# 3.(可选)如果有配置备份也解压
# tar -xzf openclaw-config-20260406.tar.gz
# 4. 如果传输用户不同,修复权限(可选)
# chown -R $(whoami):$(whoami) ~/.openclaw
5️⃣ 第五步:安装服务并启动
因为路径变了,需要重新安装系统服务:
# 1. 重新安装系统服务
openclaw onboard --install-daemon
# 2. 启动服务
openclaw gateway start
# 3. 检查状态
openclaw status
6️⃣ 第六步:验证迁移
启动完成后,做一个完整检查:
# 1. 深度检查状态
openclaw status --deep
# 2. 安全检查
openclaw security audit
# 3. 检查定时任务
openclaw cron list
# 如果发现任务没启用,批量启用:
openclaw cron enable --all
# 如果任务不执行,重新同步:
openclaw cron resync
# 4. 测试发送消息(可选)
openclaw message send --to "你的open_id" --message "🎉 OpenClaw 迁移成功!"
⚠️ 需要注意的特殊事项
1. 飞书授权
如果飞书使用 OAuth 授权,迁移后可能需要重新授权:
- 在新主机上,系统会自动发起授权流程
- 按照飞书提示扫码授权即可,非常简单
2. API 密钥和配置
~/.openclaw/包含了所有配置和技能openclaw.json中的配置会完整保留- 如果你有自定义的绝对路径依赖,记得检查更新
3. 定时任务(cron)
openclaw onboard --install-daemon会重新注册系统服务- 原有的 cron 任务定义会完整保留
- 如果发现任务不执行,运行
openclaw cron resync即可
4. 网络配置
- 如果使用了自定义域名、SSL 证书,需要在新主机上重新配置
- Tailscale、内网穿透等网络配置也需要重新设置
🗑️ 迁移完成后的清理(旧主机)
确认新主机一切正常后,可以清理旧主机:
# 停止服务
openclaw gateway stop
# 禁用服务
openclaw gateway uninstall-service
#(可选)删除安装
# npm uninstall -g openclaw
# rm -rf ~/.openclaw # 确保已经备份!
✅ 迁移成功检查清单
| 检查项 | 状态 | 备注 |
|---|---|---|
openclaw status 显示 Gateway running |
☐ | |
| 所有频道状态显示 OK | ☐ | 飞书应该显示 OK |
| 能正常接收和发送消息 | ☐ | |
| 定时任务都在列表中并且启用 | ☐ | openclaw cron list 查看 |
| 技能都能正常加载 | ☐ | |
| 记忆文件完整(MEMORY.md、每日日志) | ☐ |
💡 常见问题
Q: 迁移后飞书收不到消息怎么办?
A: 检查飞书配置,通常需要重新扫码授权,系统会自动提示。
Q: cron 定时任务不执行怎么办?
A: 运行 openclaw cron resync 重新同步即可。
Q: 工作区很大,传输中断了怎么办?
A: 使用 rsync,再次执行相同命令会自动断点续传,非常方便。
🎉 完成
恭喜!你的 OpenClaw 已经完整迁移到新主机。所有配置、技能、记忆、定时任务都应该正常工作了。
OpenClaw — 你的个人AI助手,掌控数据,保护隐私。
本文更新于 2026-04-06 | 适用 OpenClaw 版本 2026.3.2+
夜雨聆风