将 OpenClaw 迁移到新机器

本指南帮你将 OpenClaw Gateway 迁移到新机器，无需重新进行引导配置。

迁移内容

复制状态目录（默认 ~/.openclaw/）和工作区后，你将保留：

• 配置 — openclaw.json 及所有 Gateway 设置
• 认证 — API 密钥、OAuth token、凭据配置文件
• 会话 — 对话历史和 agent 状态
• 频道状态 — WhatsApp 登录、Telegram 会话等
• 工作区文件 — MEMORY.md、USER.md、技能和提示词

在旧机器上运行 openclaw status 确认你的状态目录路径。 自定义配置文件使用 ~/.openclaw-<profile>/ 或通过 OPENCLAW_STATE_DIR 设置的路径。

迁移步骤

第一步：停止 Gateway 并备份

在旧机器上，先停止 Gateway（避免文件在复制过程中发生变化），然后打包：

openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw

如果你使用了多个配置文件（如 ~/.openclaw-work），请分别打包每个。

第二步：在新机器上安装 OpenClaw

在新机器上安装 CLI（以及 Node.js，如果需要）。 就算引导程序创建了新的 ~/.openclaw/，也没关系——你接下来会覆盖它。

第三步：复制状态目录和工作区

通过 scp、rsync -a 或外部硬盘传输压缩包，然后解压：

cd ~
tar -xzf openclaw-state.tgz

确保隐藏目录被包含在内，文件所有权与运行 Gateway 的用户一致。

第四步：运行 doctor 并验证

在新机器上运行 Doctor 应用配置迁移并修复服务：

openclaw doctor
openclaw gateway restart
openclaw status

常见陷阱

配置文件或状态目录不匹配

如果旧 Gateway 使用了 --profile 或 OPENCLAW_STATE_DIR，而新机器没有， 频道会显示已登出，会话会是空的。 用你迁移的相同配置文件或状态目录启动 Gateway，然后重新运行 openclaw doctor。

只复制了 openclaw.json

仅配置文件是不够的。凭据保存在 credentials/ 下，agent 状态保存在 agents/ 下。 务必迁移整个状态目录。

权限和所有权

如果你以 root 身份复制或切换了用户，Gateway 可能无法读取凭据。 确保状态目录和工作区由运行 Gateway 的用户所有。

远端模式

如果你的 UI 指向远端 Gateway，远端主机拥有会话和工作区。 迁移 Gateway 主机本身，而不是你的本地笔记本。参见 FAQ。

备份中的机密

状态目录包含 API 密钥、OAuth token 和频道凭据。 请对备份进行加密存储，避免使用不安全的传输渠道；如果怀疑有泄露，请轮换密钥。

验证清单

在新机器上确认：

• [ ] openclaw status 显示 Gateway 正在运行
• [ ] 频道仍然连接（无需重新配对）
• [ ] Dashboard 打开后显示已有的会话
• [ ] 工作区文件（记忆、配置）已存在