OpenClaw Windows 安装报错：无法加载脚本 / 执行策略限制 解决方法

报错现象

在 Windows PowerShell 中运行 OpenClaw 安装命令或任何 npm 命令时，可能会看到如下报错：

npm.ps1 cannot be loaded because running scripts is disabled on this system.
For more information, see about_execution_policies at
https:/go.microsoft.com/fwlink/?LinkID=135170.

触发此错误的常见场景包括：

• 运行 OpenClaw 官方安装命令：

  iwr -useb https://openclaw.ai/install.ps1 | iex

• 安装完 Node.js 后首次运行 npm install、npx 等任何 npm 相关命令
• 在 PowerShell 中直接执行任何 .ps1 脚本文件

原因说明

这是 Windows PowerShell 的安全机制 —— 执行策略（ExecutionPolicy）在起作用。Windows 默认将执行策略设置为 Restricted，完全禁止运行任何 PowerShell 脚本（包括 npm 自带的 npm.ps1 启动脚本）。

执行策略的存在是为了防止恶意脚本在用户不知情的情况下运行。这是系统层面的保护，与 OpenClaw 本身无关，也不代表你下载的安装包有问题。

npm 之所以也会触发这个错误，是因为 npm 在 Windows 上通过一个叫 npm.ps1 的 PowerShell 脚本来启动，而不是直接的 .exe 文件。只要执行策略是 Restricted，任何 .ps1 脚本都无法运行，自然包括 npm。

解决方法

方法一：仅对当前会话解除限制（推荐）

这是最安全的做法。在 PowerShell 窗口中运行以下命令，仅对当前打开的这个会话临时放开执行策略，关闭窗口后自动恢复默认：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

命令执行后无需重启，直接在同一个 PowerShell 窗口中重新运行你的 OpenClaw 安装命令即可：

iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：对当前用户持久生效

如果你希望以后每次打开 PowerShell 都不用重新设置，可以将当前用户的执行策略改为 RemoteSigned。这允许运行本地脚本，但从网络下载的脚本必须有数字签名才能执行：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

PowerShell 会提示你确认，输入 Y 回车即可。这个设置只影响你自己的用户账户，不影响其他用户或系统整体策略。

方法三：以管理员身份运行 PowerShell

部分情况下，当前用户的执行策略修改会被系统级策略覆盖。此时需要以管理员身份运行 PowerShell：

• 按 Win + X，选择「Windows PowerShell（管理员）」或「终端（管理员）」
• 在弹出的 UAC 确认框中点击「是」
• 在管理员 PowerShell 中运行方法一或方法二的命令，然后再执行安装

方法四：确认 npm 触发原因及验证

完成上述任意一种方法后，可以用以下命令验证执行策略是否已生效：

Get-ExecutionPolicy -List

输出中 Process 一行显示 Bypass（方法一）或 CurrentUser 一行显示 RemoteSigned（方法二）即表示设置成功。此后 npm 命令和 OpenClaw 安装脚本均可正常运行。

不需要切换到 Git Bash 或 WSL

你可能在网上看到有人建议「换用 Git Bash」或「切换到 WSL」来绕过这个问题。这些方法确实可行，但并非必要。按照上述方法放开 PowerShell 执行策略后，直接在 PowerShell 中安装和使用 OpenClaw 完全没问题，无需额外安装 Git Bash 或配置 WSL。

WSL（Windows Subsystem for Linux）是另一种在 Windows 上运行 OpenClaw 的方式，适合熟悉 Linux 环境的用户，但如果你只是想在 Windows 本地快速安装 OpenClaw，PowerShell + 执行策略修改是最直接的路径。

安全注意事项

在修改执行策略时，请注意以下安全原则，避免不必要的风险：

• 使用 -Scope Process（当前会话）或 -Scope CurrentUser（当前用户）来限定范围，不要使用 -Scope LocalMachine 修改机器级别策略
• 不要将执行策略设置为 Unrestricted —— 这会允许运行任何来源的脚本，包括未经签名的网络脚本，存在安全隐患
• RemoteSigned 是推荐的持久设置：本地脚本可随意运行，从网络下载的脚本需要数字签名
• 只从 OpenClaw 官方渠道（openclaw.ai）下载安装脚本，不要执行来历不明的 ps1 文件

常见问题（FAQ）

设置执行策略后重启电脑会失效吗？

取决于你使用的范围。-Scope Process 是临时的，关闭 PowerShell 窗口后即失效，重启电脑后当然也需要重新设置。-Scope CurrentUser 是持久的，保存在注册表中，重启电脑后依然有效，无需重复设置。

为什么 cmd（命令提示符）没有这个问题？

Windows 的 cmd 使用 .bat 或 .cmd 脚本，不受 PowerShell 执行策略限制。但 npm 在 PowerShell 中会优先调用 npm.ps1，在 cmd 中会调用 npm.cmd，所以同样的 npm 命令在 cmd 中通常不受此问题影响。如果你习惯使用 cmd，也可以直接在 cmd 中运行 OpenClaw 安装命令。

修改执行策略会影响系统安全吗？

使用 -Scope CurrentUser -ExecutionPolicy RemoteSigned 对系统安全影响极小。它只允许运行本地脚本和有数字签名的远程脚本，不允许运行未签名的远程脚本。这是微软在 Windows 10/11 上对开发者推荐的默认设置之一，被广泛采用。

除了执行策略问题，OpenClaw Windows 安装还有哪些常见坑？

解决执行策略问题后，Windows 安装 OpenClaw 的另一个常见问题是 Node.js 版本过低。OpenClaw 要求 Node.js 18 或以上版本。可以运行 node -v 查看当前版本，如果版本过低，前往 nodejs.org 下载最新 LTS 版本重新安装即可。此外，如果你想省去所有本地安装烦恼，也可以直接使用 OpenClaw Launch 托管部署，无需在本地安装任何环境。