OpenClaw(龙虾)完整迁移指南:从旧电脑无缝部署到新机器

OpenClaw（社区昵称"龙虾"）是本地优先、可执行任务的 AI 智能体，用户"养龙虾"的过程本质是积累专属配置、技能、记忆与会话历史的过程。迁移到新电脑的核心目标，是在保留完整运行环境、自定义技能、长期记忆、模型配置与认证凭证的前提下，实现从旧机器到新机器的无缝切换。

本文针对个人电脑（Windows/macOS/Linux）与服务器部署场景，提供标准化迁移流程，覆盖备份、环境准备、恢复、权限修复与验证全链路，解决"配置丢失、技能失效、记忆清空、登录失效"等常见迁移痛点。

📁 1. 迁移前准备：明确核心目录

迁移前必须明确两个核心目录，并停止 OpenClaw 服务。

📌 核心目录：

• 状态目录（OPENCLAW_STATE_DIR）：默认~/.openclaw/，存储核心配置、认证凭证、会话历史、渠道状态

• 工作区目录（workspace）：默认~/.openclaw/workspace/，存储记忆（MEMORY.md）、用户偏好、技能文件、项目数据

# 停止服务命令

# Windows (管理员 PowerShell)
pkill -f openclaw

# macOS/Linux
openclaw gateway stop && pkill -f openclaw

📦 2. 第一步：旧机器完整备份

备份是迁移成功的基础，需完整打包状态目录与工作区。

# 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\$env:USERNAME\.openclaw \
  -DestinationPath C:\Backup\openclaw-state.zip

💡 备份建议：打包后验证完整性，将归档文件保存至 U 盘、移动硬盘或云盘，避免丢失。

🖥️ 3. 第二步：新机器环境准备

新机器需安装与旧机器一致的 OpenClaw 版本与 Node.js 环境。

📌 环境准备步骤：

• Windows：下载 Node.js 22.x LTS，安装时勾选"Add to PATH"

• macOS：执行 brew install node@22

• Linux：执行 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

• 安装 OpenClaw：npm install -g openclaw（版本需与旧机器一致）

• 验证安装：openclaw --version

📥 4. 第三步：传输备份文件并解压

将旧机器的备份文件传输至新机器，推荐通过 U 盘、移动硬盘、SCP 命令或云盘传输。

# macOS/Linux 解压 (覆盖默认目录)
tar -xzf openclaw-state-20260311.tgz -C ~/
tar -xzf openclaw-workspace-20260311.tgz -C ~/

# Windows
将 zip 文件解压至 C:\Users\<用户名>\
覆盖原有.openclaw 文件夹

🔧 5. 第四步：权限修复与 Doctor 修复

跨系统迁移或不同用户部署时，易出现权限不足或配置不匹配问题。

# 1. 权限修复 (macOS/Linux)
sudo chown -R $USER:$USER ~/.openclaw
chmod -R 755 ~/.openclaw

# 2. 执行 Doctor 修复 (核心步骤)
openclaw doctor

✅ Doctor 自动修复：

配置兼容问题、权限异常、渠道状态异常，生成修复报告，确保服务可正常启动。

✅ 6. 第五步：启动服务与验证

启动 OpenClaw 服务，逐项验证核心功能。

📋 验证清单：

• 服务状态：openclaw status 显示"Gateway is running"

• 配置生效：打开 openclaw.json，确认模型配置、API Key 与旧机器一致

• 技能与记忆：确认 MEMORY.md、USER.md、技能文件完整存在

• 渠道登录：检查 Telegram/飞书/企业微信是否已登录

• 会话历史：打开 OpenClaw 面板，确认过往会话记录完整可查

🚚 7. 特殊场景：服务器迁移

📌 服务器迁移流程：

• 旧服务器：停止服务→打包备份→SCP 传输至新服务器

• 新服务器：解压备份→修复权限→执行 doctor→启动服务

• 集群迁移：统一备份模板、批量分发、自动校验

• 数据安全：备份文件加密存储、传输链路加密、日志全程审计

⚠️ 8. 迁移避坑指南

常见问题	解决方案
仅备份配置文件	必须同时备份状态目录与工作区
版本不一致	新旧机器 OpenClaw 版本必须相同
权限不足	跨系统迁移后必须执行 chown 修复
忘记停止服务	备份前未停止会导致文件被占用
忽略 Doctor 修复	未执行 doctor 易出现渠道异常

📝 总结

OpenClaw（龙虾）的迁移核心是"完整备份、环境对齐、精准恢复、修复适配"，通过规范的 5 步流程，可在保留所有记忆、技能与配置的前提下，实现从旧电脑到新机器的无缝切换。

💡 天下数据服务：

提供 OpenClaw 迁移专属脚本、服务器迁移配置方案与技术支持。详情：https://www.idcbest.com/2026/bestclaw.asp

🚀 天下数据 · AI 成本优化服务

提供 Token 成本测算、模型选型、配置优化服务

💬 有问题或建议？

欢迎通过以下方式联系我：

• 公众号留言：直接回复本文/对话框输入留言

• 微信：swarm2021

如果这篇文章对你有帮助，欢迎点赞、在看、转发三连支持！

作者：天下数据 | 数据来源：OpenClaw 社区实测