好的,这份菜鸟教程会帮你把原电脑上的 OpenClaw 完整“搬家”到新电脑,所有配置、密钥、聊天记录都会原样保留。
📦 准备工作:原电脑上打包数据
在原电脑上操作。
关闭 OpenClaw 网关
- 打开 PowerShell(管理员身份),运行:
openclaw gateway stop
- 打开 PowerShell(管理员身份),运行:
打包状态目录
- 继续在 PowerShell 中运行以下命令,它会把你所有的配置和数据打包成一个文件
openclaw-backup.tar.gz,放在你的用户目录下:cd ~ tar-czf openclaw-backup.tar.gz.openclaw - 打包完成后,在你的用户文件夹(
C:\Users\你的用户名)里会多出一个openclaw-backup.tar.gz文件。
- 继续在 PowerShell 中运行以下命令,它会把你所有的配置和数据打包成一个文件
把备份文件复制到新电脑
- 可以用 U 盘、网盘、局域网共享等方式,把这个
openclaw-backup.tar.gz文件复制到新电脑的同一个位置(比如也放在新电脑用户文件夹的根目录下)。
- 可以用 U 盘、网盘、局域网共享等方式,把这个
💻 新电脑上:安装环境并恢复数据
在新电脑上操作。
1️⃣ 安装 Node.js
OpenClaw 需要 Node.js 环境。如果新电脑还没装,按以下步骤操作:
- 下载地址:浏览器打开
https://nodejs.org/zh-cn/download→ 点击“以往的版本”。 - 选择版本:下载v22.22.0-x64.msi(与你原电脑一致最稳妥)。
- 安装:双击运行,一路
Next,务必勾选 “Add to PATH”。 - 验证:安装完成后,打开 PowerShell,输入:
显示node-vv22.22.0即成功。
2️⃣ 安装 OpenClaw 命令行工具
在管理员 PowerShell中运行:
npm install-g openclaw@latest安装完成后,不要运行openclaw onboard!我们下一步直接用旧数据覆盖。
3️⃣ 还原旧电脑的数据
- 确保之前复制过来的
openclaw-backup.tar.gz文件已经放在新电脑的用户目录下(即C:\Users\你的用户名)。 - 在 PowerShell 中运行以下命令,把备份数据解压到正确的位置:
这会把你原来的cd ~ tar-xzf openclaw-backup.tar.gz.openclaw文件夹完整解压出来,里面包含了你的模型配置、API Key、会话记录等所有东西。
4️⃣ 让 OpenClaw 适应新环境
因为新电脑的用户名、路径可能不一样,需要让 OpenClaw 自己修一修。
运行环境检查与自动修复:
openclaw doctor--fix它会自动修复因路径变化导致的问题(如果询问是否修复,选
Yes并回车)。启动网关:
openclaw gatewaystart检查状态:
openclaw gateway status如果显示
Connectivity probe: ok或Runtime: running,说明迁移成功。
✅ 验证迁移结果
- 在浏览器打开
http://127.0.0.1:18789(或openclaw dashboard生成的链接)。 - 如果你之前配置过模型(比如 MiniMax),应该还能看到左上角的模型名称,并且能正常聊天。
- 聊天历史、配置的渠道(如飞书)都会原封不动地保留。
⚠️ 注意事项
- 杀毒软件:解压或启动时,杀毒软件可能会拦截,如果遇到报错,请临时关闭实时防护。
- Windows 版本:确保新电脑的 Windows 版本是 Win10 1809 以上,最好 22H2,否则可能遇到环境问题。
- 如果启动报错:先运行
openclaw doctor查看具体问题,通常都能自动修复。
这份教程应该能让你轻松完成搬家。如果你在新电脑上启动时遇到任何报错,直接把错误信息发给我,我帮你接着处理。
tips:新电脑如果不做这一步可以吗?(安装 OpenClaw 命令行工具)
不可以。这一步是必须的,因为仅仅复制~\.openclaw目录,只迁移了你的个人配置和数据,并没有在新电脑上安装 OpenClaw 这个命令行程序本身。
如果把 OpenClaw 比作一个“软件”,把配置目录比作“用户数据”,你现在做的事情相当于只把“用户数据”搬到了新电脑,但“软件”还没装。如果跳过这一步,新电脑的终端里根本无法识别openclaw命令,后续的openclaw doctor、openclaw gateway start等操作自然也就无法执行。
因此,你需要先在新电脑的管理员 PowerShell中运行npm install -g openclaw@latest安装好命令行工具,再进行数据恢复。
cLc8点cn,常来看看