OpenClaw（龙虾）完整迁移指南：从旧电脑无缝部署到新机器，保留记忆与技能

2026-03-12 11:31 浏览: 次

1. OpenClaw“龙虾”迁移核心价值与迁移范围

OpenClaw（社区昵称“龙虾”）是本地优先、可执行任务的AI智能体，用户“养龙虾”的过程本质是积累专属配置、技能、记忆与会话历史的过程。迁移到新电脑的核心目标，是在保留**完整运行环境、自定义技能、长期记忆、模型配置与认证凭证**的前提下，实现从旧机器到新机器的无缝切换，无需重新初始化、重新训练或重新安装插件。本文针对个人电脑（Windows/macOS/Linux）与服务器部署场景，提供标准化迁移流程，覆盖备份、环境准备、恢复、权限修复与验证全链路，解决“配置丢失、技能失效、记忆清空、登录失效”等常见迁移痛点，适用于升级硬件、更换系统、服务器迁移等高价值场景。天下数据提供一站式迁移支持，可快速完成环境适配与问题排查，保障迁移后稳定运行。

2. 迁移前准备：明确核心目录与停止服务

迁移前必须明确两个核心目录，并停止OpenClaw服务，避免文件被占用导致备份不完整。

① 状态目录（OPENCLAW_STATE_DIR）：默认路径为~/.openclaw/（Windows为C:\Users\<用户名>\.openclaw\，macOS为/Users/<用户名>/.openclaw/），存储核心配置（openclaw.json）、认证凭证（API Key、令牌）、会话历史、渠道状态（如Telegram/飞书登录信息）。② 工作区目录（workspace）：默认路径为~/.openclaw/workspace/，存储记忆（MEMORY.md）、用户偏好（USER.md）、技能文件、项目数据与执行记录。

操作步骤：在旧机器执行命令停止Gateway服务，确保无运行进程。

Windows：以管理员身份打开PowerShell，执行：pkill -f openclaw 或任务管理器结束openclaw进程
macOS/Linux：终端执行：openclaw gateway stop && pkill -f openclaw

若不确定状态目录路径，在旧机器执行openclaw status，查看输出中的OPENCLAW_STATE_DIR字段。

3. 第一步：旧机器完整备份（核心数据归档）

备份是迁移成功的基础，需完整打包状态目录与工作区，避免遗漏关键数据。推荐使用tar命令打包，兼顾完整性与兼容性，也可使用官方备份工具或一键脚本。

操作命令（macOS/Linux通用，以默认路径为例）：

打包状态目录：cd ~ && tar -czf openclaw-state-$(date +%Y%m%d).tgz .openclaw
打包工作区目录：cd ~ && tar -czf openclaw-workspace-$(date +%Y%m%d).tgz .openclaw/workspace
Windows：打开PowerShell，执行：Compress-Archive -Path C:\Users\<用户名>\.openclaw -DestinationPath C:\Backup\openclaw-state.zip

备份建议：① 打包后验证完整性，macOS/Linux可执行tar -tvf 归档文件查看内容；② 将归档文件保存至U盘、移动硬盘或云盘，避免丢失；③ 若使用自定义状态目录（如~/.openclaw-main），需替换对应路径。

4. 第二步：新机器环境准备（安装与版本对齐）

新机器需安装与旧机器一致的OpenClaw版本与Node.js环境，避免配置不兼容。

1. 环境依赖安装： - Windows：下载Node.js 22.x LTS版本（官网https://nodejs.org/），安装时勾选“Add to PATH”； - macOS：执行brew install node@22； - Linux：执行curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs。

2. 安装OpenClaw： - 全局安装：npm install -g openclaw（若旧机器指定版本，需加@版本号，如openclaw@3.8.0）； - 验证安装：执行openclaw --version，确保与旧机器版本一致； - 初始化（可选）：若新机器未初始化过OpenClaw，执行openclaw init，按提示完成基础初始化（后续会被备份覆盖）。

关键注意：版本必须对齐，避免因版本差异导致配置解析失败或功能异常。

5. 第三步：传输备份文件并解压（覆盖核心数据）

将旧机器的备份文件传输至新机器，推荐通过U盘、移动硬盘、SCP命令（服务器场景）或云盘传输，确保文件完整。

解压操作（覆盖默认目录）： - macOS/Linux：将备份文件放入用户根目录，执行： tar -xzf openclaw-state-20260311.tgz -C ~/ tar -xzf openclaw-workspace-20260311.tgz -C ~/ - Windows：将zip文件解压至C:\Users\<用户名>\，覆盖原有.openclaw文件夹（解压前建议备份原目录）。

关键检查：解压后确认~/.openclaw（Windows对应目录）下存在config.json、credentials、workspace等核心子目录，避免遗漏。

6. 第四步：权限修复与Doctor修复（解决运行异常）

跨系统迁移或不同用户部署时，易出现权限不足或配置不匹配问题，需执行官方Doctor命令修复。

1. 权限修复（macOS/Linux优先）： - 赋予状态目录读写权限：sudo chown -R $USER:$USER ~/.openclaw - 赋予执行权限：chmod -R 755 ~/.openclaw

2. 执行Doctor修复（核心步骤）：在新机器终端执行：openclaw doctor 该命令会自动修复配置兼容问题、权限异常、渠道状态异常，生成修复报告，确保服务可正常启动。

Windows用户：以管理员身份运行PowerShell，执行相同命令，避免权限不足。

7. 第五步：启动服务与验证迁移效果（确认无缝运行）

启动OpenClaw服务，逐项验证核心功能，确保迁移无遗漏。

1. 启动服务： - macOS/Linux：openclaw gateway start - Windows：PowerShell执行：openclaw gateway start

2. 验证清单（逐项确认）：

服务状态：执行openclaw status，显示“Gateway is running”
配置生效：打开openclaw.json，确认模型配置、API Key、插件路径与旧机器一致
技能与记忆：打开工作区，确认MEMORY.md、USER.md、技能文件完整存在，可正常调用已安装技能
渠道登录：检查Telegram/飞书/企业微信等渠道是否已登录，无需重新扫码或授权
会话历史：打开OpenClaw面板，确认过往会话记录完整可查

若出现异常，重新执行openclaw doctor修复，或核对备份文件完整性。

8. 特殊场景迁移：服务器与多实例适配

1. 服务器迁移（天下数据服务器场景）： - 旧服务器：停止服务→打包备份→通过SCP传输至新服务器（scp 备份文件 root@新服务器IP:/root/）； - 新服务器：解压备份→修复权限→执行doctor→启动服务； - 天下数据用户：可联系客服获取服务器专属迁移脚本，适配云环境与网络配置，快速完成迁移。

2. 多实例迁移：若旧机器有多个OpenClaw实例（如~/.openclaw-main、~/.openclaw-work），需分别打包每个实例的状态目录与工作区，新机器对应解压至同名目录，执行对应实例的doctor与启动命令（openclaw --profile main gateway start）。

9. 迁移避坑指南：6大常见问题规避

1. 仅备份配置文件：必须同时备份状态目录（含凭证）与工作区（含记忆），仅备份config.json会导致登录失效、记忆丢失。 2. 版本不一致：新机器必须安装与旧机器完全相同的OpenClaw版本，避免配置解析失败。 3. 权限不足：跨系统迁移后必须执行chown修复权限，否则服务无法启动。 4. 忘记停止服务：备份前未停止OpenClaw，会导致文件被占用，备份不完整。 5. 自定义路径未替换：若使用自定义状态目录/工作区，需替换命令中的默认路径，避免备份到错误位置。 6. 忽略Doctor修复：未执行doctor直接启动，易出现渠道异常、配置不兼容问题。

10. 总结：规范迁移实现“龙虾”无缝换主机

OpenClaw（龙虾）的迁移核心是“完整备份、环境对齐、精准恢复、修复适配”，通过规范的5步流程，可在保留所有记忆、技能与配置的前提下，实现从旧电脑到新机器的无缝切换。无论是个人电脑升级、更换操作系统，还是服务器迁移，遵循本文流程均可避免数据丢失与功能异常。天下数据深耕OpenClaw企业级部署与迁移服务，提供定制化迁移方案、环境适配支持与7×24小时技术运维，帮助用户快速完成迁移，让“龙虾”在新机器上持续高效工作。如需获取OpenClaw迁移专属脚本、服务器迁移配置方案或技术支持，欢迎咨询天下数据，获取一对一落地服务。

bestclaw