跳转到主要内容

​
将 OpenClaw 迁移到新机器

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

​
迁移内容

当您复制 状态目录（默认为 ~/.openclaw/）和您的 工作空间 时，您将保留：
  • 配置 — openclaw.json 和所有网关设置
  • 认证 — API 密钥、OAuth 令牌、凭证配置文件
  • 会话 — 对话历史和代理状态
  • 通道状态 — WhatsApp 登录、Telegram 会话等。
  • 工作空间文件 — MEMORY.md、USER.md、技能和提示词
在旧机器上运行 openclaw status 以确认您的状态目录路径。 自定义配置文件使用 ~/.openclaw-<profile>/ 或通过 OPENCLAW_STATE_DIR 设置的路径。

​
迁移步骤

1

停止网关并备份

在 旧 机器上，停止网关以防止文件在复制过程中发生变化，然后存档：
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
如果您使用多个配置文件（例如 ~/.openclaw-work），请分别存档每个配置文件。
2

在新机器上安装 OpenClaw

在新机器上 安装 CLI（如果需要，还包括 Node）。如果新手引导 创建了新的 ~/.openclaw/ 也没关系——您接下来将覆盖它。
3

复制状态目录和工作空间

通过 scp、rsync -a 或外部驱动器传输存档，然后解压：
cd ~
tar -xzf openclaw-state.tgz
确保包含隐藏目录，并且文件所有权与将运行网关的用户相匹配。
4

运行 Doctor 并验证

在新机器上，运行 Doctor 以应用配置迁移并修复服务：
openclaw doctor
openclaw gateway restart
openclaw status

​
常见误区

如果旧网关使用了 --profile 或 OPENCLAW_STATE_DIR 而新网关没有使用， 渠道将显示为已登出状态，且会话将为空。请使用您迁移时使用的 相同 配置文件或状态目录启动网关，然后重新运行 openclaw doctor。
仅复制配置文件是不够的。凭据位于 credentials/ 下，而代理状态位于 agents/ 下。请始终迁移 整个 状态目录。
如果您以 root 用户身份复制文件或切换了用户，网关可能无法读取凭据。请确保 状态目录和工作区归运行网关的用户所有。
如果您的 UI 指向 远程 网关，则远程主机拥有会话和工作区。请迁移 网关主机本身，而不是您的本地笔记本电脑。请参阅 常见问题。
状态目录包含 API 密钥、OAuth 令牌和渠道凭据。 请加密存储备份，避免使用不安全的传输渠道，并在怀疑泄露时轮换密钥。

​
验证清单

在新机器上，确认：
  • openclaw status 显示网关正在运行
  • 渠道仍保持连接状态（无需重新配对）
  • 仪表板可以打开并显示现有会话
  • 工作区文件（记忆、配置）存在
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026