迁移指南

将 OpenClaw 迁移到新机器

本指南将 OpenClaw 网关移动到新机器，而无需重新进行新手引导。

当您复制 状态目录（默认为 ~/.openclaw/）和您的 工作空间 时，您将保留：

停止网关并备份
在旧机器上，停止网关以防止文件在复制过程中发生变化，然后存档：
Terminal window
```
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
```
如果您使用多个配置文件（例如 ~/.openclaw-work），请分别存档每个配置文件。
在新机器上安装 OpenClaw
在新机器上安装 CLI（如果需要，也包括 Node）。如果新手引导创建了一个新的 ~/.openclaw/，这没有问题——您接下来会覆盖它。
复制状态目录和工作空间
通过 scp、rsync -a 或外部驱动器传输存档，然后解压：
Terminal window
```
cd ~
tar -xzf openclaw-state.tgz
```
确保包含隐藏目录，并且文件所有权与将运行网关的用户相匹配。
运行 Doctor 并验证
在新机器上，运行 Doctor 以应用配置迁移并修复服务：
Terminal window
```
openclaw doctor
openclaw gateway restart
openclaw status
```

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

如果旧网关使用了 --profile 或 OPENCLAW_STATE_DIR 而新网关没有使用，渠道将显示为已登出状态，且会话将为空。请使用您迁移时使用的相同配置文件或状态目录启动网关，然后重新运行 openclaw doctor。

仅复制 openclaw.

仅复制配置文件是不够的。凭证位于 credentials/ 下，而代理状态位于 agents/ 下。请始终迁移整个状态目录。

权限和所有权

如果您以 root 用户身份复制或切换了用户，网关可能无法读取凭证。请确保状态目录和工作区归运行网关的用户所有。

远程模式

如果您的 UI 指向远程网关，则远程主机拥有会话和工作区。请迁移网关主机本身，而不是您的本地笔记本电脑。请参阅常见问题。

备份中的机密信息

状态目录包含 API 密钥、OAuth 令牌和渠道凭据。请加密存储备份，避免使用不安全的传输渠道，并在怀疑泄露时轮换密钥。

在新机器上，确认：