原电脑只运行了 npm install -g openclaw，迁移到新电脑的菜鸟教程（含 TaoToken 配置）

1. 为什么只复制 .openclaw 目录新电脑还是跑不起来很多人迁移 OpenClaw 的第一反应是把旧电脑的.openclaw文件夹拷过去不就完事了我一开始也这么想结果在新电脑敲openclaw doctor直接提示「不是内部或外部命令」。原因很简单npm install -g openclaw装的是命令行程序本体而.openclaw目录只是用户数据配置、密钥、会话记录。这两者是分开的程序装在 Node.js 的全局目录里数据放在用户主目录下。你只搬了数据没装程序系统当然找不到openclaw这个命令。所以完整的迁移其实是三件事第一在旧电脑导出 npm 全局包清单和.openclaw数据第二在新电脑装好 Node.js 和 OpenClaw 本体第三把数据还原回去再用openclaw doctor修一遍路径差异。这篇教程就按这个顺序走每一步都给可复制的命令菜鸟也能跟下来。先明确一下适用人群你在旧电脑上只跑过npm install -g openclaw可能还配过模型 endpoint、API Key、聊天渠道比如飞书现在换新电脑想原样搬过去。如果你还没装过 OpenClaw那这篇也适用只是旧电脑那步可以跳过直接看新电脑安装部分。迁移前有两个前提要确认。一是新旧电脑的 Node.js 大版本尽量一致比如旧机是 v22新机也装 v22避免全局包因为 ABI 不兼容出问题。二是新电脑的 Windows 建议 Win10 1809 以上最好 22H2老版本可能在解压或启动网关时报环境错误。这两点后面还会展开。我实测下来整个流程最容易被忽略的是「npm 全局包清单」这一步。很多人只记得搬.openclaw忘了旧电脑上可能还装了别的全局工具或者 OpenClaw 依赖某个特定版本的包。导出清单能让你在新电脑一次性复现而不是一个个回忆装了什么。另外提醒一句迁移过程中如果涉及 API endpoint 配置建议统一改到一个稳定的接入地址后面第 3 节会给具体的 settings 片段。这样新电脑装好后不用再翻旧配置找 Key。2. 旧电脑导出npm 全局包清单与 .openclaw 打包这一节全在旧电脑上操作目的是把「程序清单」和「用户数据」分别导出方便新电脑复现。2.1 导出 npm 全局包清单打开 PowerShell普通权限即可先看看你装了哪些全局包npm list -g --depth0输出大概长这样C:\Users\你的用户名\AppData\Roaming\npm ├── openclaw1.4.2 └── npm10.8.1把这份清单存成文件方便带到新电脑npm list -g --depth0 $HOME\npm-global-list.txt如果你想要更精确、可以直接用来重装的格式用--json导出npm list -g --depth0 --json $HOME\npm-global-list.json这个 JSON 里会记录每个包的名称和版本号新电脑上照着装就行。注意npm本身不用重装它是随 Node.js 来的。2.2 停止 OpenClaw 网关打包数据前一定要先停网关否则文件可能被占用打包出来是坏的。用管理员身份打开 PowerShellopenclaw gateway stop如果提示服务未运行也没关系说明本来就没启动。停掉之后确认一下状态openclaw gateway status看到Runtime: stopped就可以继续。2.3 打包 .openclaw 数据目录.openclaw默认在用户主目录下也就是C:\Users\你的用户名\.openclaw。用 tar 打包Win10 1803 以后自带 tarcd $HOME tar -czf openclaw-backup.tar.gz .openclaw执行完在C:\Users\你的用户名下会多出一个openclaw-backup.tar.gz。你可以先验证一下包内容对不对tar -tzf openclaw-backup.tar.gz | Select-Object -First 20应该能看到.openclaw/config.json、.openclaw/sessions/之类的路径。如果列表是空的说明打包时目录不对检查一下当前路径是不是$HOME。2.4 把两个文件复制到新电脑需要带过去的是两个东西openclaw-backup.tar.gz和npm-global-list.json或 txt。用 U 盘、局域网共享都行放到新电脑的同一个位置比如也放C:\Users\新用户名\下。注意.openclaw里可能存着 API Key 和会话记录传输过程注意别放到公共网盘的不加密目录。迁移完成后旧电脑上的备份文件建议删掉。到这里旧电脑的活就干完了。清单和数据都拿到手接下来去新电脑装环境。3. 新电脑复现Node.js、OpenClaw 与 TaoToken settings 配置这一节全在新电脑操作。核心是三件事装 Node.js、装 OpenClaw 本体、还原数据并改 endpoint。3.1 安装 Node.js去 Node.js 官网下载和旧电脑一致的版本比如 v22.22.0 的 x64 msi。双击安装一路 Next务必勾选 Add to PATH否则 PowerShell 里识别不了node和npm。装完验证node -v npm -v能打印出版本号就对了。如果提示「不是内部或外部命令」说明 PATH 没配上重新跑一遍安装程序勾选 Add to PATH或者手动把 Node.js 安装目录加进系统环境变量。3.2 安装 OpenClaw 命令行工具用管理员 PowerShell 运行npm install -g openclawlatest装完先别急着openclaw onboard因为我们要用旧数据覆盖onboard 会生成新配置反而添乱。验证安装openclaw --version3.3 还原 .openclaw 数据确认openclaw-backup.tar.gz已经在新电脑的用户目录下然后cd $HOME tar -xzf openclaw-backup.tar.gz解压完C:\Users\新用户名\.openclaw就回来了里面包含模型配置、API Key、会话记录。3.4 把 endpoint 改到 TaoToken如果你旧配置里的模型 endpoint 想换成 TaoToken 的接入地址编辑.openclaw下的配置文件。具体文件名以你本地为准常见是config.json或settings.json。用记事本或 VS Code 打开找到模型/provider 相关段落改成下面这样JSON 片段路径和字段名按你本地实际结构调整{ providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, model: claude-sonnet-4-5 } }, defaultProvider: taotoken }三个关键字段对齐一下Base URL 填https://taotoken.net/apiAPI Key 去控制台生成Model ID 填你要用的模型名。这三件套Base URL Key Model ID缺一不可少一个就会在请求时报 401 或 model not found。如果你用的是 TOML 格式的配置写法类似[providers.taotoken] base_url https://taotoken.net/api api_key 你的_TaoToken_API_Key model claude-sonnet-4-5 default_provider taotokenAPI Key 的获取入口在 TaoToken 控制台的 API Keys 页面生成后复制粘贴到上面字段即可。接入细节可以对照官方接入文档里面有各语言的调用示例。3.5 让 OpenClaw 适应新环境新电脑的用户名、路径可能和旧机不同跑一次自动修复openclaw doctor --fix它会检查路径、权限、依赖遇到问题会问你是否修复选 Yes 回车。这一步很关键跳过的话网关可能因为路径写死而启动失败。4. 验证请求openclaw doctor 与连通性检查配置改完得验证真的能跑通不能只看命令没报错就以为成了。4.1 启动网关并看状态openclaw gateway start openclaw gateway status状态里重点看两行Runtime: running和Connectivity probe: ok。前者说明网关进程起来了后者说明它能连上你配的 endpoint。如果Connectivity probe显示 failed八成是 Base URL 或 Key 有问题回到 3.4 检查。4.2 用 doctor 做一次完整体检openclaw doctor不带--fix时它只诊断不修改输出会列出各项检查结果。关注这几项Node.js 版本、全局包完整性、配置文件可读性、endpoint 连通性。有 warning 不一定是错但 error 必须处理。4.3 发一条真实请求验证模型打开浏览器访问http://127.0.0.1:18789或者用openclaw dashboard拿链接。在界面里发一条消息比如「你好报一下你现在的模型名」。如果能看到正常回复说明从 OpenClaw 到 TaoToken endpoint 的整条链路通了。想用命令行验证也行很多版本支持openclaw chat 你好返回内容里如果带模型名和正常文本就说明请求成功。这一步能过迁移基本就完成了。4.4 检查历史会话和渠道回到 dashboard看看左侧的会话列表是不是旧电脑那些记录之前配的飞书等渠道是否还在。如果会话在但渠道掉了通常是渠道的 webhook 或 token 需要在新环境重新授权按提示重新绑定即可。5. 常见报错排查401、local proxy failed、reading choices迁移过程最容易卡在这几个报错上逐个说清楚。5.1 401 Unauthorized这是最常见的。原因通常是 API Key 没填、填错或者 Key 和 Base URL 不匹配。排查顺序先确认config.json里apiKey字段不是空的再确认baseUrl是https://taotoken.net/api而不是别的地址。如果 Key 是从旧电脑带过来的有可能已经失效去控制台重新生成一个换上。还有一种情况是 Key 前后带了空格或换行复制粘贴时容易带上。用编辑器打开配置文件把 Key 那行重新手敲一遍最稳。5.2 local proxy failed这个报错一般出现在网关启动阶段提示本地代理起不来。常见原因是端口被占用OpenClaw 默认用 18789如果新电脑上别的程序占了这个端口就会冲突。查一下netstat -ano | findstr 18789如果有输出记下 PID去任务管理器结束对应进程或者改 OpenClaw 的监听端口。另一个原因是杀毒软件拦截了本地监听临时关掉实时防护再启动试试。5.3 reading choices 相关报错类似error reading choices或cannot read property choices的报错通常和会话数据损坏有关。可能是打包时网关没停干净导致.openclaw/sessions里有半截文件。解决办法把损坏的会话文件移走让 OpenClaw 重建。cd $HOME\.openclaw mkdir sessions-bak move sessions\* sessions-bak\然后重启网关。历史记录会丢一部分但程序能正常跑。如果不想丢可以逐个检查 sessions 目录下的文件把明显是 0 字节或格式乱的删掉。5.4 OAuth 相关报错如果你之前配的渠道走 OAuth 授权迁移后可能提示 token 过期或 refresh 失败。这类问题没法靠复制文件解决因为 OAuth token 往往和机器指纹或回调地址绑定。在新电脑上重新走一遍授权流程即可配置里的 client id/secret 可以保留。5.5 命令找不到 openclaw回到最开始那个坑openclaw不是内部或外部命令。说明全局包没装成功或者 npm 全局目录不在 PATH 里。先npm list -g --depth0看 openclaw 在不在列表不在就重装在的话检查C:\Users\新用户名\AppData\Roaming\npm有没有加进 PATH。排查完这些基本能覆盖 90% 的迁移报错。遇到没列出来的把完整错误信息贴出来一般从报错关键词就能定位。6. 迁移后的收尾与长期使用建议迁移跑通之后有几件事值得做一下能省掉后面很多麻烦。第一把新电脑的 npm 全局包清单和旧电脑的对比一下确认该装的都装了。用第 2 节导出的npm-global-list.json逐个核对缺的补上npm install -g 包名版本号第二把配置文件里的 endpoint 和 Key 统一管理。如果你经常换电脑或者多台机器共用建议把 provider 配置抽出来单独维护改一处就能同步。TaoToken 的接入文档里有推荐的配置组织方式可以参考。第三长期做编码或 Agent 任务的话可以考虑用 Coding Plan比按量调用更省心适合高频使用的场景。如果只是偶尔验证模型效果用模型对话页面就够了。第四养成迁移前先openclaw gateway stop的习惯。这次是打包数据下次可能是升级版本停干净再操作能避免大部分文件损坏问题。最后说个实用技巧把openclaw doctor加进你的日常检查清单。每次换环境、升级 Node.js、改配置之后都跑一遍它能在问题变大之前就报出来。我试过几次都是 doctor 先发现路径不对比等到网关启动失败再排查省事得多。整个迁移流程走下来核心就三句话旧机导出清单和数据新机装 Node.js 和 OpenClaw 本体还原数据后用 doctor 修路径并验证连通性。把 endpoint 指向 TaoToken 之后新电脑就能接着旧电脑的活继续干了。