Windows10 安装 openclaw 前,先把 npm、node.js 与 PowerShell 环境理顺

发布时间:2026/10/9 11:01:26

Windows10 安装 openclaw 前,先把 npm、node.js 与 PowerShell 环境理顺 1. Windows10 装 openclaw 前为什么环境准备比安装本身更折腾如果你在 Windows10 上搜过 openclaw 安装教程大概率会看到一堆「npm install -g openclawlatest 一把梭」的说法。但真正动手的人会发现卡住你的往往不是 openclaw 本身而是它脚下那三层地基Node.js 版本、npm 全局路径、PowerShell 执行策略。这三样任何一处不对后面就是EPERM、无法加载文件 xxx.ps1、node 不是内部或外部命令轮番上阵。openclaw社区里叫「龙虾」是一个本地部署的 AI 智能体框架它需要通过 npm 全局安装安装过程会调用 PowerShell 脚本、编译原生依赖、写入全局目录。这意味着它对环境的要求比普通前端项目更挑剔。Node.js 版本太低原生模块编译不过npm 全局路径带空格或权限不足写入直接失败PowerShell 执行策略是 Restricted安装脚本根本跑不起来。这篇内容聚焦的是「安装前」这一步也就是把 node、npm、PowerShell 三件事理顺并且逐条验证命令可用。适合谁看在 Windows10 上第一次装 openclaw、被环境报错劝退过、或者装到一半发现命令找不到的人。我试过在一台全新的 Win10 机器上从零走一遍把每一步的验证命令和踩坑点都记下来了你可以直接照着做。核心检索词先明确Windows10 安装 openclaw 前的环境准备重点是 node.js 版本选择、npm 全局路径配置、PowerShell 执行策略检查。这三件事做完正式安装 openclaw 的成功率会高很多。2. Node.js 与 npm 版本选择openclaw 安装前的 node 版本要求与全局路径配置openclaw 官方建议 Node.js LTS 版本 ≥ 22。这个数字不是随便写的因为 openclaw 依赖的一些原生模块比如 libsignal-node需要较新的 V8 和 N-API 支持Node 18 及以下在编译阶段就容易报node-gyp相关错误。所以第一步不是急着装 openclaw而是先把 Node.js 版本确认到位。2.1 下载与安装 Node.js LTS去 Node.js 中文站下载 LTS 版本地址是 https://nodejs.cn/en/download 。选 Windows Installer (.msi) 64-bit。安装过程中有一个关键勾选项Add to PATH。这个必须勾上否则装完之后在 PowerShell 里敲node会提示「不是内部或外部命令」。另外安装向导里有个「Automatically install the necessary tools」的选项它会顺带装 Chocolatey 和 Python如果你不想装额外东西可以跳过但后面如果遇到 node-gyp 编译报错可能还是得补 Python。安装完成后不要用旧的 CMD 窗口验证因为 PATH 是安装时刷新的旧窗口读不到新环境变量。重新开一个 PowerShell 或 CMD执行node -v npm -v正常应该输出类似v22.14.0和10.9.2这样的版本号。如果node -v有输出但npm -v报错说明 npm 没随 Node 一起装好建议卸载重装。2.2 npm 全局路径检查与配置npm 全局安装的包会放在一个「全局目录」里openclaw 就装在这里。Windows 上默认路径通常是C:\Users\你的用户名\AppData\Roaming\npm。这个路径本身没问题但有两个隐患一是用户名带中文或空格时容易出问题二是权限不足时写入失败。先查看当前配置npm config get prefix npm root -gprefix是全局安装的可执行文件目录root -g是全局模块的实际存放目录。确认prefix对应的目录在你的用户目录下并且你有完全控制权限。如果想把全局目录改到一个更干净的位置比如避免中文路径可以这样设置npm config set prefix C:\nodejs\npm-global设置完之后需要把这个新路径加到系统环境变量 PATH 里否则全局安装的命令行工具包括 openclaw还是找不到。手动加 PATH 的步骤Win S 搜「环境变量」→ 编辑系统环境变量 → 环境变量 → 在用户变量的 Path 里新增一行C:\nodejs\npm-global。改完重开 PowerShell 生效。2.3 切换 npm 镜像加速国内直连 npm 官方源下载 openclaw 及其依赖会很慢甚至超时。切换镜像npm config set registry https://registry.npmmirror.com/ npm config set electron_mirror https://npmmirror.com/mirrors/electron/验证镜像是否生效npm config get registry应该输出https://registry.npmmirror.com/。这一步做完后面安装 openclaw 的下载速度会明显改善。2.4 补充VC 运行库openclaw 的部分原生依赖在 Windows 上编译时需要微软 VC 运行库。如果缺失安装时会报MSB3428或vcbuild.exe not found之类的错误。提前装好 VC 2015-2022 x64 版本下载地址在微软官方文档页https://learn.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist?viewmsvc-170 。装完不用重启但建议重开 PowerShell。3. PowerShell 执行策略与 openclaw 安装脚本配置片段openclaw 的安装和初始化过程会执行 PowerShell 脚本比如openclaw onboard --install-daemon会注册守护进程。Windows 默认的执行策略是Restricted意思是「任何脚本都不许跑」这时候你会看到红色报错无法加载文件 xxx.ps1因为在此系统上禁止运行脚本。所以安装前必须把执行策略调成RemoteSigned。3.1 以管理员身份打开 PowerShell两种方式Win X 然后选「Windows PowerShell (管理员)」或者搜 PowerShell 右键「以管理员身份运行」。注意改执行策略和后面装全局包都建议在管理员窗口里做避免权限不足。3.2 设置执行策略在管理员 PowerShell 里执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser提示确认时输入Y回车。RemoteSigned的含义是本地写的脚本可以直接跑从网上下载的脚本需要有数字签名。这个策略比Unrestricted安全又比Restricted实用是开发机的常规选择。验证当前策略Get-ExecutionPolicy -Scope CurrentUser应该输出RemoteSigned。如果输出还是Restricted说明设置没生效检查是不是在正确的 Scope 下设置的。3.3 Git 全局配置openclaw 依赖拉取用openclaw 安装过程中会从 GitHub 拉取依赖比如 libsignal-node 的 tar 包。如果你的网络环境对 git 协议不友好可以配置 git 用 https 替代 sshgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/ git config --global url.https://github.com/.insteadOf gitgithub.com:这两条命令的作用是当 git 遇到ssh://gitgithub.com/或gitgithub.com:开头的地址时自动替换成 https 形式。这样就不需要配置 SSH key直接用 https 拉取。3.4 可复制的 settings 配置片段如果你习惯用配置文件管理可以把 npm 相关配置写进.npmrc。文件位置在用户目录下C:\Users\你的用户名\.npmrc。内容如下registryhttps://registry.npmmirror.com/ electron_mirrorhttps://npmmirror.com/mirrors/electron/ strict-ssltrue prefixC:\Users\你的用户名\AppData\Roaming\npm注意prefix这一行如果你没改过全局路径就保持默认改过的话写你改后的路径。strict-ssl建议保持true除非你确实遇到 SSL 证书问题再临时关掉关掉会降低安全性。如果你用的是 Cline MCP 或 Claude Code 这类工具来辅助开发它们的配置里也需要填 Base URL、Key、Model ID 三件套。以 Cline 的 MCP 配置为例JSON 片段长这样{ mcpServers: { taotoken: { url: https://taotoken.net/api, apiKey: 你的API Key, model: claude-sonnet-4-20250514 } } }这里的 Base URL 用https://taotoken.net/apiKey 在控制台生成Model ID 按你实际要用的模型填。这三样缺一不可少一个就会报 401 或 model not found。4. 逐条验证node、npm、openclaw 命令是否可用环境配置完不要急着装 openclaw先把基础命令逐条验证一遍。这一步能帮你提前发现 80% 的环境问题。4.1 验证 node 和 npmnode -v npm -v where.exe node where.exe npm前两条输出正常版本号。where.exe会列出命令的实际路径确认它们指向你刚装的 Node.js 目录而不是系统里残留的旧版本。如果where.exe node输出多个路径说明 PATH 里有多个 Node需要清理掉旧的。4.2 验证 npm 全局目录可写npm root -g记下输出的路径然后手动往这个目录里写一个测试文件echo test $(npm root -g)\test.txt如果没报权限错误说明全局目录可写。删掉测试文件Remove-Item $(npm root -g)\test.txt4.3 验证 PowerShell 脚本可执行创建一个测试脚本echo Write-Host PowerShell OK test.ps1 .\test.ps1如果输出PowerShell OK说明执行策略没问题。删掉脚本Remove-Item test.ps14.4 验证 openclaw 命令安装后如果你已经装完 openclaw验证命令是openclaw --version正常输出类似2026.3.13。如果报「不是内部或外部命令」说明 npm 全局目录不在 PATH 里回到 2.2 节检查 PATH 配置。再验证网关能否启动openclaw gateway --port 18789 --allow-unconfigured看到类似下面的输出说明网关启动成功OpenClaw 2026.3.13 (61d171a) — Your config is valid, your assumptions are not. Gateway listening on http://0.0.0.0:18789 UI available at http://localhost:18789浏览器访问http://localhost:18789能看到管理面板就说明环境完全通了。4.5 验证模型接入可选如果你打算用 TaoToken 接入模型可以在 openclaw 的配置里填 Base URL 和 Key。模型对话功能可以先在 https://taotoken.net/api-keys 生成 Key然后在 https://taotoken.net/doc 查接入文档。验证模型是否通可以用模型对话页面发一条测试消息看是否正常返回。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth环境准备阶段和安装阶段最常见的报错就那么几个。下面按报错原文对照排查。5.1401 Unauthorized这个报错通常出现在模型接入环节不是 openclaw 安装本身的问题。原因是你填的 API Key 无效、过期或者 Base URL 填错了。排查步骤确认 Key 是从控制台生成的没有多余空格确认 Base URL 是https://taotoken.net/api不要多加斜杠或路径确认 Model ID 拼写正确。三件套Base URL Key Model ID任何一个不对都会 401。5.2local proxy failed或proxy error这个报错说明你的网络请求经过了一个本地代理但代理没起来或配置不对。排查检查系统代理设置是否开启了一个不存在的端口检查 npm 的 proxy 配置npm config get proxy npm config get https-proxy如果输出不是null说明设了代理用npm config delete proxy和npm config delete https-proxy删掉。openclaw 安装不需要额外代理直连镜像源即可。5.3Cannot read properties of undefined (reading choices)这个报错通常出现在调用模型 API 时返回结构不符合预期。原因可能是 Base URL 指向了一个不兼容 OpenAI 格式的端点或者 Model ID 填了一个不存在的模型。排查确认 Base URL 是https://taotoken.net/api确认 Model ID 是平台支持的模型名用 curl 直接测一下接口curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\hi\}]}如果 curl 返回正常 JSON说明接口没问题是 openclaw 配置里的字段填错了。5.4OAuth相关报错如果你用的是 Claude Code 或 Codex 这类需要 OAuth 的工具可能会遇到OAuth token expired或OAuth callback failed。排查重新走一遍授权流程确认回调地址没有被防火墙拦截如果用的是 Codex 的auth.json检查文件里的 token 是否过期。Codex 的auth.json通常放在C:\Users\你的用户名\.codex\auth.json里面的字段包括access_token、refresh_token等过期后需要重新登录生成。5.5EPERM: operation not permitted这是 Windows 上 npm 全局安装的经典报错原因是文件被占用或权限不足。排查关闭所有 PowerShell、CMD、VS Code、浏览器窗口打开任务管理器结束所有node.exe和npm.exe进程用管理员权限重置 npm 目录权限icacls C:\Users\你的用户名\AppData\Roaming\npm /grant 你的用户名:F /t /c然后重新安装。5.6无法加载文件 xxx.ps1因为在此系统上禁止运行脚本这就是执行策略没改。回到第 3 节用管理员 PowerShell 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。6. 环境理顺之后openclaw 安装与模型接入的下一步环境准备做完node、npm、PowerShell 三样都验证通过接下来才是正式安装 openclaw。安装命令本身不复杂npm cache clean --force npm install -g openclawlatest openclaw onboard --install-daemon但这一步能不能顺利完全取决于前面环境有没有理顺。Node 版本够、全局目录可写、执行策略放开这三条满足了安装基本一把过。装完之后如果你要用模型能力需要接入 API。TaoToken 的接入文档在 https://taotoken.net/doc API Key 在 https://taotoken.net/api-keys 生成模型对话测试页在 https://taotoken.net/chat 。长期跑编码任务或 Agent 的话可以看 Coding Planhttps://taotoken.net/coding-plan 。最后说一个实际经验Windows 上装 openclaw最容易忽略的是「重开 PowerShell」这件事。改完 PATH、改完执行策略、装完 Node都要重开窗口才生效。很多人卡在「明明装了却找不到命令」就是因为还在用旧窗口。环境准备这件事慢就是快逐条验证比事后排错省时间。
延伸阅读

更多相关文章

2026/10/9 10:56:25

HTML快速入门实战:从零构建语义化与可访问性页面

1. 为什么HTML值得你花一个下午认真过一遍很多人第一次接触网页开发,脑子里冒出来的第一个念头是“我要学一门编程语言”,然后一头扎进Python或者JavaScript的教程里。结果折腾了两周,连一个像样的页面都摆不出来。问题出在哪儿?出…

2026/10/9 11:51:36

Xcode Cloud、Python协程与HarmonyOS:终端降价背后的工程升级

1. 项目概述:这不是一条新闻,而是一组技术信号的交叉验证“极客日报:曝 iPhone 13 系列定价有望下调:起售价或低于 5499 元;TikTok 成为全球收入最高 App”——这个标题乍看是消费电子与移动应用市场的两条平行资讯&am…

2026/10/9 11:51:36

AnyPS5如何联网?libSceNet的TCP/UDP实现与完整移植拆解

AnyPS5如何联网?libSceNet的TCP/UDP实现与完整移植拆解 【免费下载链接】AnyPS5 Tool for automatic PS5 executables porting to Linux and Windows 项目地址: https://gitcode.com/GitHub_Trending/an/AnyPS5 AnyPS5 是一个将 PS5 可执行文件自动移植到 Li…

2026/10/9 11:46:35

Python EasyDict 配置管理实战:从嵌套字典痛点到工程化方案

1. 为什么一个字典模块值得单独写一篇第一次在项目里看到from easydict import EasyDict这行代码的时候,我的反应是:字典就字典,Python 自带的dict用了这么多年,为什么还要额外装一个第三方库?直到我在一个图像处理项目…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/8 10:03:20

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/9 0:04:27

毕业论文初稿完成后首次进行AIGC疑似度自查的摸底与分流策略

毕业论文初稿完成后首次进行AIGC疑似度自查的摸底与分流策略当数万字的学位论文初稿经历开题、实验、问卷与多轮文献梳理最终成形时,绝大多数研究生都会面临一道全新的形式审查关卡:AIGC 疑似度排查。在高校毕业审核流程中,盲审前的文本检测通…

2026/10/9 0:04:27

食堂节能改造源头工厂,商用厨房设备焕新方案广受好评

商用厨房作为餐饮经营、单位供餐的核心后勤阵地,其设备配置、动线规划与运维体系直接决定后厨作业效率、运营成本与合规性。从基础的灶具、制冷存储设备,到油烟净化、水处理等配套系统,每一个环节的合理性都与食品安全、能耗管控、消防安全挂…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑