OpenClaw环境迁移指南:换服务器不丢技能

正文内容

周末半夜两点,你的OpenClaw突然不说话了。飞书群里@它没反应,定时任务也不跑了。登录服务器一看,硬盘报错,系统只读。

最让人抓狂的不是服务器坏了,是重新配置一遍要花多久。

当初配这个环境花了多少时间?API密钥、飞书回调地址、企业微信的Token、那几个好不容易调通的技能——哪一步你还能记得清?

到底要备份什么

OpenClaw的环境由三层组成

  • 配置层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分钟。上一次他重装配置,花了整整一个周末。

你选哪个?

文章评分

这篇文章对您有帮助吗?

分享到

微信
朋友圈
QQ
QQ空间
微博
抖音
小红书
复制
二维码

实用功能

夜间模式
小字
大字
收藏
目录
笔记
朗读
相关
搜索
我的笔记
文章内搜索
相关文章推荐
正在加载相关文章...

反馈建议

您需要登录后才能填写意见反馈信息

分享二维码

使用手机扫描二维码

操作成功