将OpenClaw 迁移到新机器

本指南将 OpenClaw Gateway 从一台机器迁移到另一台机?而无需重新完成入门配置*?

迁移在概念上很简单：

  • 复制**状态目?*（$OPENCLAW_STATE_DIR，默认：~/.openclaw/）——这包括配置、认证、会话和频道状态?
  • 复制你的**工作?*（默?~/.openclaw/workspace/）——这包括你的代理文件（内存、提示词等）?

但有一些常见的陷阱涉及profiles?权限*?部分复制*?

开始之前（你要迁移什么）

1) 确定你的状态目?

大多数安装使用默认设置：

  • 状态目录：~/.openclaw/

但如果你使用以下选项，它可能不同?

  • --profile <name>（通常变为 ~/.openclaw-<profile>/?
  • OPENCLAW_STATE_DIR=/some/path

如果你不确定，请?*?*机器上运行：

openclaw status

在输出中查找 OPENCLAW_STATE_DIR / profile 的提及。如果你运行多个 gateway，请为每?profile 重复此操作?

2) 确定你的工作?

常见的默认设置：

  • ~/.openclaw/workspace/（推荐的工作区）
  • 你创建的自定义文件夹

你的工作区是 MEMORY.md、USER.md ?memory/*.md 等文件所在的地方?

3) 了解你将保留什?

如果你复?两?（状态目录和工作区），你将保留：

  • Gateway 配置（openclaw.json?
  • Auth profiles / API keys / OAuth tokens
  • 会话历史 + 代理状?
  • 频道状态（例如 WhatsApp 登录/会话?
  • 你的工作区文件（内存、技能笔记等?

如果?*?复制工作区（例如通过 Git），你将**不保??

  • 会话
  • 凭证
  • 频道登录

这些存在?$OPENCLAW_STATE_DIR 下?

迁移步骤（推荐）

?0 ??备份（旧机器?

?*?*机器上，先停?gateway，这样文件在复制过程中不会更改：

openclaw gateway stop

（可选但推荐）归档状态目录和工作区：

# 如果你使?profile 或自定义位置，请调整路径
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace

如果你有多个 profiles/状态目录（例如 ~/.openclaw-main、~/.openclaw-work），请分别归档每个?

?1 ??在新机器上安?OpenClaw

?*?*机器上，安装 CLI（以?Node 如果需要）?

在这个阶段，如果 onboarding 创建了新?~/.openclaw/ 也没关系——你将在下一步覆盖它?

?2 ??将状态目?+ 工作区复制到新机?

复制**两?*?

  • $OPENCLAW_STATE_DIR（默?~/.openclaw/?
  • 你的工作区（默认 ~/.openclaw/workspace/?

常见方法?

  • scp 压缩包并解压
  • 通过 SSH rsync -a
  • 外部驱动?

复制后，确保?

  • 包含了隐藏目录（例如 .openclaw/?
  • 文件所有权对于运行 gateway 的用户是正确?

?3 ??运行 Doctor（迁?+ 服务修复?

?*?*机器上：

openclaw doctor

Doctor ?安全无聊”的命令。它会修复服务、应用配置迁移，并警告不匹配?

然后?

openclaw gateway restart
openclaw status

常见陷阱（以及如何避免）

陷阱：profile / 状态目录不匹配

如果你用 profile（或 OPENCLAW_STATE_DIR）运行旧 gateway，而新 gateway 使用不同的一个，你会看到如下症状?

  • 配置更改不生?
  • 频道丢失/已登?
  • 空会话历?

修复：使用你迁移?相同* profile/状态目录运?gateway/服务，然后重新运行：

openclaw doctor

陷阱：只复制 openclaw.json

openclaw.json 不够。许?providers 将状态存储在?

  • $OPENCLAW_STATE_DIR/credentials/
  • $OPENCLAW_STATE_DIR/agents/<agentId>/...

始终迁移整个 $OPENCLAW_STATE_DIR 文件夹?

陷阱：权?所有权

如果你以 root 身份复制或更改了用户，gateway 可能无法读取凭证/会话?

修复：确保状态目?+ 工作区由运行 gateway 的用户拥有?

陷阱：在远程/本地模式之间迁移

  • 如果你的 UI（WebUI/TUI）指?远程* gateway，远程主机拥有会话存?+ 工作区?
  • 迁移你的笔记本电脑不会移动远?gateway 的状态?

如果你在远程模式，请迁移gateway 主机?

陷阱：备份中?secrets

$OPENCLAW_STATE_DIR 包含 secrets（API keys、OAuth tokens、WhatsApp 凭证）。像对待生产 secrets 一样对待备份：

  • 加密存储
  • 避免通过不安全渠道共?
  • 如果你怀疑泄露，请更换密?

验证清单

在新机器上，确认?

  • openclaw status 显示 gateway 正在运行
  • 你的频道仍然连接（例?WhatsApp 不需要重新配对）
  • 仪表板打开并显示现有会?
  • 你的工作区文件（内存、配置）存在

相关内容