OpenClaw 在 Windows 系统下的完整安装部署指南

OpenClaw 在 Windows 系统下的完整安装部署指南

一、安装方式选择

在 Windows 操作系统上部署 OpenClaw 应用，我们强烈推荐使用 PowerShell 方式进行安装。该方法步骤明确、系统兼容性好，能有效规避常见错误。通过 Windows Subsystem for Linux (WSL) 安装的方式仅建议作为备选方案，适用于需要在 Windows 中同时运行 Linux 兼容开发环境的特定场景。

二、PowerShell 安装（推荐方案）

前置准备：调整脚本执行策略

开启安装流程的第一步，是配置 PowerShell 脚本的执行权限。请务必使用管理员身份启动 PowerShell 窗口。随后，执行下方命令以临时调整当前会话的脚本执行策略。此设置为临时性变更，关闭窗口后自动恢复默认安全策略，兼顾了操作的便利性与系统安全性。

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

执行命令后，系统会弹出确认提示，请键入 Y（Yes）并按回车键继续。

步骤1：安装 Node.js 运行环境

方式A：官方安装程序直接安装（推荐新手使用）

对于初次接触 Node.js 的用户，最为稳妥的方式是下载官方安装程序进行部署。请访问 Node.js 官网，下载适用于 Windows 的 LTS（长期支持）版本安装包（.msi 文件）。下载完成后，双击运行并跟随图形化安装向导的指引完成安装即可，过程与其他 Windows 软件无异。

安装成功后，强烈建议进行基础验证。打开新的命令提示符或 PowerShell 窗口，输入以下两个命令进行测试：

node -v # 验证 Node.js 版本，成功安装将显示版本号 npm -v # 验证 npm 包管理器版本

当两条命令均能正确返回版本号时，即表明 Node.js 环境已成功部署，为后续 OpenClaw 的安装奠定了坚实基础。

方式B：通过 nvm-windows 安装（适合多版本管理需求）

如果您需要在同一台 Windows 电脑上管理或切换多个不同的 Node.js 版本（例如为不同的项目工作），那么使用 nvm-windows（Node Version Manager for Windows）工具是更优的选择。它是一个专为 Windows 设计的 Node.js 版本管理工具，让版本切换与管理变得轻而易举。

您需要首先在 nvm-windows 项目的 GitHub 发布页下载其安装程序。安装完成 nvm-windows 工具后，即可利用其强大的命令行工具来管理 Node.js，例如：

nvm install lts # 安装最新可用的长期支持版Node.js nvm list # 列举出当前系统中通过nvm安装的所有Node.js版本 nvm use 20.10.0 # 将当前命令行环境切换到指定的Node.js版本

借助 nvm-windows，您可以轻松地为每个项目配置独立的 Node.js 运行环境，从而保证项目依赖的精确匹配，极大地提升了开发环境管理的效率和条理性。