正文内容
周末半夜两点,你的OpenClaw突然不说话了。飞书群里@它没反应,定时任务也不跑了。登录服务器一看,硬盘报错,系统只读。
最让人抓狂的不是服务器坏了,是重新配置一遍要花多久。
当初配这个环境花了多少时间?API密钥、飞书回调地址、企业微信的Token、那几个好不容易调通的技能——哪一步你还能记得清?
到底要备份什么
- 配置层:
openclaw.json、环境变量、API密钥 - 技能层:安装的各种技能包,包括你手动调整过的自定义技能
- 会话层:聊天的上下文记忆、渠道登录状态、飞书/企业微信的认证凭证
有个开发者硬盘坏了之后才发现,花了两周调试的GLM-4.7-Flash对接设置全部归零——温度参数、自定义提示词、飞书通道配置,一个都没留下。
备份命令
官方迁移指南里写的很清楚:复制两个东西就够了——状态目录和工作区。
状态目录(默认~/.openclaw/)存的是你的钥匙:openclaw.json配置文件、API密钥、OAuth令牌、渠道登录态。你飞书群里的机器人为什么不用重新扫码就能说话?秘密就在这里。
工作区(默认~/.openclaw/workspace/)存的是你的脑子:MEMORY.md里的长期记忆、自定义技能文件、执行记录。
在旧机器上先停服务:
openclaw gateway stop
打包带走:
cd ~ tar -czf openclaw-state.tgz .openclaw tar -czf openclaw-workspace.tgz .openclaw/workspace
把这两个压缩包传到新机器。有人在论坛上分享过一次迁移经历,用了scp传了3分钟,解压后直接能用,飞书没掉线。
新机器恢复
新机器上先装好OpenClaw(版本必须一样,否则配置不兼容),然后把备份文件传到用户根目录,解压覆盖:
tar -xzf openclaw-state.tgz -C ~/ tar -xzf openclaw-workspace.tgz -C ~/
最关键的一步是运行openclaw doctor。这个命令会自动修复路径差异、权限问题、配置兼容性。很多人迁移完服务起不来,就是因为跳过了这一步。
然后启动服务:
openclaw gateway start openclaw status
如果渠道(飞书/企业微信)没有自动重连,去后台更新一下回调URL的白名单IP。
企业微信迁移的特殊处理
如果你用的是企业微信机器人,多一步操作。在旧机器上先导出环境变量:
env | grep -i "WECHAT\|CLAWDBOT\|API_KEY" > clawdbot-env-export.txt
在新机器上配置完成后,去企业微信管理后台,把回调URL的白名单IP更新成新服务器的IP。
有位用户忘了这步,新机器跑起来半天没反应,排查了半天才发现是回调地址没更新。API回调找不到新服务器,消息自然收不到。
常见翻车点
权限问题:跨系统迁移后(比如从Mac迁到Linux),文件所有者不对,OpenClaw读不了密钥。解决方法:
chown -R $USER:$USER ~/.openclaw
版本不一致:新机器装的是最新版,旧机器是老版,配置文件不兼容。迁移前先查旧版本:
openclaw --version
只备份配置文件:光备份openclaw.json没用。会话状态和API密钥存在别的地方,单独备份配置文件等于白忙。
备份策略
别等到服务器炸了才想备份。
腾讯云官方文档推荐了一套备份方案:每天凌晨自动打包,保留最近7天,同步到对象存储。写个脚本扔进crontab:
0 3 * * * /opt/scripts/openclaw-backup.sh
有人把这套流程跑通了,在 养龙虾 专题里分享了脚本。他说换服务器的时候,从备份到恢复,全程15分钟。上一次他重装配置,花了整整一个周末。
你选哪个?