openclaw 安装遇到的问题记录

OpenClaw 安装指南：Windows 环境常见问题诊断与解决方案总结

在新工具链的部署过程中，遭遇技术障碍是开发者时常面对的情况。本文将以 Windows 平台为例，详细复盘安装 OpenClaw 过程中可能出现的两个典型问题及其排查解决全流程。内容涵盖从错误识别到实际操作，旨在为遇到相似状况的用户提供清晰的排错思路和可直接复用的步骤。

问题一：Node.js 脚本执行权限被阻止

安装初始阶段，在配置 Node.js 环境时可能首先遭遇脚本执行限制。具体错误提示通常如下：

npm : 无法加载文件 D:\ProgramFiles\nodejs\npm.ps1，因为在此系统上禁止运行脚本。

此报错源于 Windows PowerShell 的默认安全策略限制。核心解决方案是调整当前用户的脚本执行策略，分为三个明确步骤执行。

首先，打开 PowerShell 终端（建议以管理员身份运行），输入 get-ExecutionPolicy 命令，可查看到当前策略，默认通常为 Restricted（受限状态），此策略会阻止所有脚本运行。

随后，执行命令 Set-ExecutionPolicy -Scope CurrentUser 以修改当前用户策略。系统会提示输入新策略名称，此处键入 RemoteSigned。该策略允许运行本地脚本及来自互联网的、带有可信签名的脚本，兼顾了安全与日常使用需求。

最后，为验证修改是否生效，可再次运行 get-ExecutionPolicy 命令。当终端显示输出为 RemoteSigned 时，即表明权限障碍已清除，Node.js 及 npm 相关命令可正常执行。

问题二：SSL 证书过期导致的安装失败

突破权限问题后，安装进程可能因网络下载环节受阻。执行安装指令后，终端可能呈现如下错误：

PS C:\Users\username> iwr -useb https://openclaw.ai/install.ps1 | iex
[*] Installing OpenClaw (openclaw@latest)...
node.exe : npm error code CERT_HAS_EXPIRED

错误信息 “CERT_HAS_EXPIRED” 明确指出 SSL 证书已过期。关键在于判断是 OpenClaw 官网证书问题，还是本地配置的 npm 镜像源证书失效。多数情况下，问题出在第三方 npm 镜像站的证书未能及时续签。

一个快速有效的验证与解决方案是，临时将 npm 源切换至官方 registry。执行以下命令：

# 切换至 npm 官方源
npm config set registry https://registry.npmjs.org
# 全局安装 pnpm（OpenClaw 安装依赖）
npm install -g pnpm

若切换后安装成功（如下图所示），则确认问题源于原镜像源证书。这提醒我们，使用第三方镜像虽可提升下载速度，但偶尔可能引入此类间接的稳定性问题。

备选方案：采用 Docker 容器化部署

除了直接解决宿主机环境问题，另一种更为稳健和流行的部署方式是转向容器化方案。直接安装常面临环境冲突与依赖难题，而 Docker 可将应用及其完整运行环境打包，确保跨平台的一致性。

对于 Windows 用户，通过 Docker 部署 OpenClaw 通常需要借助 WSL（Windows Subsystem for Linux），因为许多开发工具链在 Linux 环境中运行更为原生。启用 WSL 的过程需进入“启用或关闭 Windows 功能”面板，勾选“适用于 Linux 的 Windows 子系统”选项，具体界面如下图所示。

完成配置并重启系统后，即可在 WSL 内的 Linux 发行版中，通过 Docker 命令拉取并运行 OpenClaw 的官方镜像。此方法能有效规避复杂的本地环境配置，是追求部署效率和环境隔离性的优选方案。