原电脑只运行了:npm install -g openclaw 要把它迁移到一个新电脑,怎么操作,菜鸟教程

好的,这份菜鸟教程会帮你把原电脑上的 OpenClaw 完整"搬家"到新电脑,所有配置、密钥、聊天记录都会原样保留


📦 准备工作:原电脑上打包数据

在原电脑上操作。

  1. 关闭 OpenClaw 网关

    • 打开 PowerShell(管理员身份),运行:

      powershell 复制代码
      openclaw gateway stop
  2. 打包状态目录

    • 继续在 PowerShell 中运行以下命令,它会把你所有的配置和数据打包成一个文件 openclaw-backup.tar.gz,放在你的用户目录下:

      powershell 复制代码
      cd ~
      tar -czf openclaw-backup.tar.gz .openclaw
    • 打包完成后,在你的用户文件夹(C:\Users\你的用户名)里会多出一个 openclaw-backup.tar.gz 文件。

  3. 把备份文件复制到新电脑

    • 可以用 U 盘、网盘、局域网共享等方式,把这个 openclaw-backup.tar.gz 文件复制到新电脑的同一个位置(比如也放在新电脑用户文件夹的根目录下)。

💻 新电脑上:安装环境并恢复数据

在新电脑上操作。

1️⃣ 安装 Node.js

OpenClaw 需要 Node.js 环境。如果新电脑还没装,按以下步骤操作:

  • 下载地址 :浏览器打开 https://nodejs.org/zh-cn/download → 点击"以往的版本"。

  • 选择版本 :下载 v22.22.0-x64.msi(与你原电脑一致最稳妥)。

  • 安装 :双击运行,一路 Next务必勾选 "Add to PATH"

  • 验证 :安装完成后,打开 PowerShell,输入:

    powershell 复制代码
    node -v

    显示 v22.22.0 即成功。

2️⃣ 安装 OpenClaw 命令行工具

管理员 PowerShell 中运行:

powershell 复制代码
npm install -g openclaw@latest

安装完成后,不要运行 openclaw onboard 我们下一步直接用旧数据覆盖。

3️⃣ 还原旧电脑的数据

  1. 确保之前复制过来的 openclaw-backup.tar.gz 文件已经放在新电脑的用户目录下(即 C:\Users\你的用户名)。

  2. 在 PowerShell 中运行以下命令,把备份数据解压到正确的位置:

    powershell 复制代码
    cd ~
    tar -xzf openclaw-backup.tar.gz

    这会把你原来的 .openclaw 文件夹完整解压出来,里面包含了你的模型配置、API Key、会话记录等所有东西。

4️⃣ 让 OpenClaw 适应新环境

因为新电脑的用户名、路径可能不一样,需要让 OpenClaw 自己修一修。

  1. 运行环境检查与自动修复:

    powershell 复制代码
    openclaw doctor --fix

    它会自动修复因路径变化导致的问题(如果询问是否修复,选 Yes 并回车)。

  2. 启动网关:

    powershell 复制代码
    openclaw gateway start
  3. 检查状态:

    powershell 复制代码
    openclaw gateway status

    如果显示 Connectivity probe: okRuntime: running,说明迁移成功。


✅ 验证迁移结果

  • 在浏览器打开 http://127.0.0.1:18789(或 openclaw dashboard 生成的链接)。
  • 如果你之前配置过模型(比如 MiniMax),应该还能看到左上角的模型名称,并且能正常聊天。
  • 聊天历史、配置的渠道(如飞书)都会原封不动地保留。

⚠️ 注意事项

  • 杀毒软件:解压或启动时,杀毒软件可能会拦截,如果遇到报错,请临时关闭实时防护。
  • Windows 版本:确保新电脑的 Windows 版本是 Win10 1809 以上,最好 22H2,否则可能遇到环境问题。
  • 如果启动报错 :先运行 openclaw doctor 查看具体问题,通常都能自动修复。

这份教程应该能让你轻松完成搬家。如果你在新电脑上启动时遇到任何报错,直接把错误信息发给我,我帮你接着处理。


tips:新电脑如果不做这一步可以吗?(安装 OpenClaw 命令行工具)

不可以 。这一步是必须的,因为仅仅复制 ~\.openclaw 目录,只迁移了你的个人配置和数据,并没有在新电脑上安装 OpenClaw 这个命令行程序本身。

如果把 OpenClaw 比作一个"软件",把配置目录比作"用户数据",你现在做的事情相当于只把"用户数据"搬到了新电脑,但"软件"还没装。如果跳过这一步,新电脑的终端里根本无法识别 openclaw 命令,后续的 openclaw doctoropenclaw gateway start 等操作自然也就无法执行。

因此,你需要先在新电脑的管理员 PowerShell 中运行 npm install -g openclaw@latest 安装好命令行工具,再进行数据恢复。


cLc8点cn,常来看看

相关推荐
浮尘笔记1 小时前
在Snowy后台无需编码实现自动化生成CRUD操作流程
java·开发语言·经验分享·spring boot·后端·程序人生·mybatis
我是发哥哈1 小时前
三款主流AI视频生成模型商用能力对比与选型分析
大数据·人工智能·学习·ai·chatgpt·aigc·音视频
是大强2 小时前
nvm安装node成功npm失败
前端·npm·node.js
华创材料2 小时前
国产替代加速:高端环氧胶如何打破进口依赖、支撑产业链自主可控
经验分享·数据挖掘
bloglin999993 小时前
使用url请求本地qwen3-embed-0.6B向量大模型示例
ai
智慧物业老杨3 小时前
物业数智化转型实战:从单一服务到综合解决方案的技术落地路径
人工智能·算法·ai
Agent手记3 小时前
生产节拍混乱,在制品积压严重该怎么破解?——2026制造业柔性生产与Agent自动化实战指南
运维·人工智能·ai·自动化
西门子918!3 小时前
西门子S7-1200控制V90伺服精确定位
经验分享
优化控制仿真模型3 小时前
【英一】考研英语一历年真题及答案解析PDF电子版(1980-2026年)
经验分享·pdf