OpenClaw跨系统迁移我踩了这4个坑

最近把OpenClaw从Mac迁移到Ubuntu系统，本以为照着官方文档走一遍就行。官方迁移文档核心就四步：停止网关备份、新机器安装、复制状态目录、运行 doctor 验证。
看起来很简单？我照着走完，发现——根本不能用~

🚨 踩坑一：openclaw.json 路径要改
openclaw.json 里有很多路径配置，macOS 和 Linux 的用户目录路径不一样
🍎 macOS：/Users/<用户名>/.openclaw/...
🐧 Linux：/home/<用户名>/.openclaw/...
解决方法：打开 ~/.openclaw/openclaw.json，全局搜索旧路径，替换成新路径

🚨 踩坑二：session文件里的内容路径也要改，问题根因和第一个问题一样
在 ~/.openclaw/agents/你的agentId/sessions/sessions.json 文件里，记录了每个会话的状态，里面也硬编码了很多路径
这些路径不改，会话历史就加载不出来，之前的对话记录也有问题
解决方法：找到所有 sessions.json 文件，把旧路径替换成新路径

🚨 踩坑三：设备重新配对
迁移后执行 openclaw logs 等命令时发现报错：pairing required
解决方法：
1️⃣ 查看设备列表：openclaw devices list
2️⃣ 找到 pending 状态的记录，复制 requestId
3️⃣ 批准配对：openclaw devices approve

🚨 踩坑四：systemd 服务安装失败
执行 openclaw gateway install 安装系统服务时报错：
gateway install failed: error: systemctl --user unavailable: failed to connect to bus: no medium found
网上提供的很多方案都没有效果
✅ 解决方法：手动创建系统服务文件
推荐路径（二选一）：
📁 /home/<用户名>/.config/systemd/user/（优先尝试）
📁 /etc/systemd/system/（上面不行就用这个）
创建 openclaw-gateway.service 文件。
启动服务：systemctl restart openclaw-gateway
配置开机自启：systemctl enable openclaw-gateway

以上内容均为个人踩坑经历，仅供参考，欢迎大家指正交流