好的,这份菜鸟教程会帮你把原电脑上的 OpenClaw 完整"搬家"到新电脑,所有配置、密钥、聊天记录都会原样保留。
📦 准备工作:原电脑上打包数据
在原电脑上操作。
-
关闭 OpenClaw 网关
-
打开 PowerShell(管理员身份),运行:
powershellopenclaw gateway stop
-
-
打包状态目录
-
继续在 PowerShell 中运行以下命令,它会把你所有的配置和数据打包成一个文件
openclaw-backup.tar.gz,放在你的用户目录下:powershellcd ~ tar -czf openclaw-backup.tar.gz .openclaw -
打包完成后,在你的用户文件夹(
C:\Users\你的用户名)里会多出一个openclaw-backup.tar.gz文件。
-
-
把备份文件复制到新电脑
- 可以用 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,输入:
powershellnode -v显示
v22.22.0即成功。
2️⃣ 安装 OpenClaw 命令行工具
在管理员 PowerShell 中运行:
powershell
npm install -g openclaw@latest
安装完成后,不要运行 openclaw onboard! 我们下一步直接用旧数据覆盖。
3️⃣ 还原旧电脑的数据
-
确保之前复制过来的
openclaw-backup.tar.gz文件已经放在新电脑的用户目录下(即C:\Users\你的用户名)。 -
在 PowerShell 中运行以下命令,把备份数据解压到正确的位置:
powershellcd ~ tar -xzf openclaw-backup.tar.gz这会把你原来的
.openclaw文件夹完整解压出来,里面包含了你的模型配置、API Key、会话记录等所有东西。
4️⃣ 让 OpenClaw 适应新环境
因为新电脑的用户名、路径可能不一样,需要让 OpenClaw 自己修一修。
-
运行环境检查与自动修复:
powershellopenclaw doctor --fix它会自动修复因路径变化导致的问题(如果询问是否修复,选
Yes并回车)。 -
启动网关:
powershellopenclaw gateway start -
检查状态:
powershellopenclaw 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,常来看看