一文教你解決Windows安裝OpenClaw報(bào)錯(cuò):無(wú)法加載npm.ps1,禁止運(yùn)行腳本
問(wèn)題現(xiàn)象
在Windows PowerShell中執(zhí)行OpenClaw安裝命令時(shí),出現(xiàn)如下權(quán)限錯(cuò)誤:
PS C:\Users\tangyuan> & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta
OpenClaw Installer
[OK] Windows detected
[!] Node.js not found
[*] Installing Node.js...
# 省略Node.js安裝成功日志
[OK] Node.js v24.14.0 found
[*] Installing OpenClaw (openclaw@beta)...
npm : 無(wú)法加載文件 C:\Program Files\nodejs\npm.ps1,因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本。有關(guān)詳細(xì)信息,請(qǐng)參閱 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:290 字符: 22
+ $npmOutput = npm install -g "$packageName@$Tag" 2>&1
+ ~~~
+ CategoryInfo : SecurityError: (:) [],ParentContainsErrorRecordException
+ FullyQualifiedErrorId : UnauthorizedAccess問(wèn)題根源
該報(bào)錯(cuò)的核心原因是 Windows PowerShell的執(zhí)行策略限制:Windows默認(rèn)啟用嚴(yán)格的執(zhí)行策略(默認(rèn)值為Restricted),禁止運(yùn)行任何未簽名的PowerShell腳本,而npm的核心腳本npm.ps1屬于未簽名的本地腳本,因此被系統(tǒng)攔截。
解決方案(分步實(shí)操)
步驟1:以管理員身份打開(kāi)PowerShell
- 按下
Win + X快捷鍵,在彈出的菜單中選擇「Windows PowerShell (管理員)」(Windows 11為「終端(管理員)」); - 彈出用戶(hù)賬戶(hù)控制(UAC)提示時(shí),點(diǎn)擊「是」確認(rèn)權(quán)限。
步驟2:臨時(shí)放寬執(zhí)行策略(推薦)
在管理員權(quán)限的PowerShell中執(zhí)行以下命令(僅當(dāng)前會(huì)話(huà)生效,重啟后恢復(fù)默認(rèn),安全無(wú)風(fēng)險(xiǎn)):
Set-ExecutionPolicy Bypass -Scope Process -Force
參數(shù)說(shuō)明:
-Scope Process:僅對(duì)當(dāng)前PowerShell進(jìn)程生效,不修改系統(tǒng)全局策略;-Force:跳過(guò)確認(rèn)提示,直接執(zhí)行。
步驟3:重新執(zhí)行OpenClaw安裝命令
在同一個(gè)管理員PowerShell窗口中,重新運(yùn)行安裝指令:
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta
可選:永久放寬執(zhí)行策略(謹(jǐn)慎使用)
如果需要長(zhǎng)期使用Node.js/npm,且確認(rèn)環(huán)境安全,可將執(zhí)行策略改為RemoteSigned(允許本地腳本運(yùn)行,遠(yuǎn)程腳本需簽名):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
注意:該命令對(duì)當(dāng)前用戶(hù)全局生效,僅建議在個(gè)人開(kāi)發(fā)機(jī)使用,企業(yè)環(huán)境需遵循IT規(guī)范。
驗(yàn)證安裝結(jié)果
安裝完成后,執(zhí)行以下命令驗(yàn)證OpenClaw是否成功安裝:
openclaw --version
若輸出類(lèi)似 openclaw/x.x.x beta 的版本信息,說(shuō)明安裝成功。
常見(jiàn)問(wèn)題排查
執(zhí)行Set-ExecutionPolicy提示「拒絕訪(fǎng)問(wèn)」
- 確認(rèn)PowerShell是管理員身份運(yùn)行;
- 企業(yè)環(huán)境可能通過(guò)組策略鎖定執(zhí)行策略,需聯(lián)系IT管理員解除限制。
npm依然報(bào)錯(cuò)「無(wú)法加載腳本」
- 重啟管理員權(quán)限的PowerShell后重試;
- 驗(yàn)證Node.js安裝是否成功:
node -v(正常輸出v24.14.0即可); - 手動(dòng)檢查npm路徑:
Get-Command npm(應(yīng)指向C:\Program Files\nodejs\npm.ps1)。
總結(jié)
- Windows默認(rèn)的PowerShell執(zhí)行策略是導(dǎo)致npm腳本無(wú)法運(yùn)行的核心原因;
- 優(yōu)先使用「臨時(shí)放寬執(zhí)行策略」(
-Scope Process),兼顧易用性和安全性; - 永久修改執(zhí)行策略?xún)H適用于個(gè)人開(kāi)發(fā)環(huán)境,生產(chǎn)/企業(yè)環(huán)境需嚴(yán)格遵循安全規(guī)范。
擴(kuò)展知識(shí):PowerShell執(zhí)行策略說(shuō)明
| 執(zhí)行策略 | 說(shuō)明 |
|---|---|
| Restricted | 默認(rèn)值,禁止運(yùn)行任何腳本 |
| AllSigned | 僅允許運(yùn)行已簽名的腳本(本地/遠(yuǎn)程均需簽名) |
| RemoteSigned | 本地腳本可運(yùn)行,遠(yuǎn)程腳本需簽名(推薦開(kāi)發(fā)環(huán)境使用) |
| Unrestricted | 允許運(yùn)行所有腳本(不推薦,有安全風(fēng)險(xiǎn)) |
| Bypass | 繞過(guò)所有執(zhí)行策略限制(僅臨時(shí)使用) |
到此這篇關(guān)于一文教你解決Windows安裝OpenClaw報(bào)錯(cuò):無(wú)法加載npm.ps1,禁止運(yùn)行腳本的文章就介紹到這了,更多相關(guān)Windows安裝OpenClaw內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

0基礎(chǔ)安裝 OpenClaw 圖文教程(Windows 系統(tǒng))
OpenClaw 是一個(gè)可自托管的個(gè)人 AI 助手,它可以運(yùn)行在你自己的電腦上并通過(guò) Telegram 等聊天渠道接收消息,再調(diào)用執(zhí)行、網(wǎng)頁(yè)、瀏覽器等能力,幫你完成各種自動(dòng)化操作2026-03-08
Windows下OpenClaw的安裝與Debug配置教程最終版(MiniPC i3-N305 / 無(wú) GPU)
這篇文章主要介紹了Windows下OpenClaw的安裝與Debug配置,機(jī)器是MiniPC i3-N305 / 無(wú) GPU,需要的朋友可以參考一下,有條件的盡量用mac系統(tǒng)簡(jiǎn)單快捷,一次通過(guò)的成功率高2026-03-03
Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程
在 Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程,你可以讓它運(yùn)行在自己的電腦上,通過(guò) WhatsApp、Telegram、Discord、Slack 等你已經(jīng)在用的聊天軟件與它對(duì)話(huà)2026-03-01




