↵

OpenClaw 是一个开源的 AI Agent 运行时，支持插件化执行和自主循环。本文介绍在 Windows 上安装 OpenClaw 的 3 种方法，从最简单的一键脚本到从源码构建，适合不同需求的用户。

快速选择建议：

• 新手用户 → 方法 1（官方一键脚本，最省心）
• 开发者 → 方法 2（pnpm 源码安装，可定制）
• 快速体验 → 方法 3（直接安装脚本，灵活选路径）

1、使用官方一键安装脚本（推荐新手）

这是官方为 Windows 用户提供的最便捷方式，它会自动检测并安装所需的 Node.js、Git 等环境。

1.1 准备工作

• 系统要求：Windows 10 (版本 1903+) 或 Windows 11，64位系统。
• 权限：需要使用管理员权限运行 PowerShell。
• 网络：确保网络通畅（若下载慢，可能需要开启代理）。

1.2 执行安装

1. 打开 PowerShell (管理员)：

   • 按 Win + X，选择 “Windows PowerShell (管理员)” 或 “终端 (管理员)”。

​编辑

如果 npm install 报错"因为在此系统上禁止运行脚本"，需要先解除 PowerShell 执行策略限制，按以下步骤操作：

1.3 以管理员身份打开 PowerShell

• 按键盘上的 Win 键。
• 输入 PowerShell。
• 在搜索结果中，右键点击 “Windows PowerShell”，选择 “以管理员身份运行” (Run as Administrator)。
  • 如果弹出用户账户控制 (UAC) 提示，点击“是”。

1.4 执行解锁命令

在打开的蓝色窗口中，复制并粘贴以下命令，然后按 Enter 键：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

1.5 确认更改

系统会提示你确认是否更改策略：

• 它会显示类似：执行策略更改... [Y] 是(Y) [A] 全是(A) ...
• 输入 Y 或 A，然后按 Enter 键。

​编辑

解释：RemoteSigned 是一个安全的策略，它允许运行本地创建的脚本，但要求从互联网下载的脚本必须有受信任的签名。-Scope CurrentUser 表示只修改当前用户的设置，不需要管理员权限即可永久生效（虽然刚才我们用了管理员窗口来确保写入成功）。

1.6 重新运行安装命令

现在策略已更改，你可以关闭当前的管理员窗口，重新打开一个普通的 PowerShell 或 CMD 窗口，再次运行你之前的命令：

npm install -g openclaw@latest

这次应该就能正常下载和安装了。

​编辑

2、使用 pnpm 安装（基于源代码）

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build

如果已经解决了 npm 的权限问题，直接用 npm 来安装 pnpm 是最快的方法。

1. 打开 PowerShell (不需要管理员身份，普通窗口即可)。
2. 运行以下命令：

   npm install -g pnpm

3. 验证安装：安装完成后，输入以下命令查看版本号，如果显示版本号（如 9.x.x），说明安装成功：

   pnpm -v

   
   ​编辑
4. 重新运行项目安装：
5. 在安装依赖前，必须将包管理器源切换到淘宝镜像 (npmmirror)，否则 pnpm install 会卡死。

   pnpm config set registry https://registry.npmmirror.com
   pnpm config get registry
   # 应该输出：https://registry.npmmirror.com/

   现在你可以回到 OpenClaw 的目录，再次运行：

   pnpm install

   
   ​编辑

pnpm ui:build # auto-installs UI deps on first run

​编辑

如果你不想用 WSL，必须确保使用 Git Bash 来运行构建命令，而不是 PowerShell。

1. 确认已安装 Git for Windows：如果你之前为了 clone 代码安装了 Git，那你已经有了 Git Bash。

2. 使用 Git Bash 打开项目：

   • 在文件资源管理器中，进入 D:\OpenClaw\openclaw 文件夹。
   • 在空白处 右键，选择 "Git Bash Here"。
   • 或者在 Git Bash 中输入：

     cd /d/OpenClaw/openclaw

3. 运行构建：在 Git Bash 窗口中运行：

   pnpm build

   (Git Bash 内置了 bash 解释器，可以直接运行 .sh 脚本)

   ​编辑

pnpm ui:build

​编辑

pnpm openclaw onboard --install-daemon

​编辑

3、直接安装

1. 运行安装命令：复制以下命令并粘贴到 PowerShell 中，按回车执行

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

   (注：如果官方域名变更，请去 GitHub 仓库首页查看最新的 install.ps1 地址)

   
   ​编辑

2. 跟随提示操作：

   • 脚本会自动检查是否安装了 Git 和 Node.js。如果没有，它会尝试自动安装或提示你安装。
   • 选择安装路径（默认通常在 C:\Users\你的用户名\.openclaw）。
   • 等待依赖下载和构建完成（进度条走完）。

3. 启动 OpenClaw：安装完成后，在终端输入

   openclaw start

   系统会自动在浏览器打开管理界面（通常是 http://localhost:3000）。

4、三种方法对比

5、常见问题

5.1 Q: npm install 报错"无法加载文件，因为在此系统上禁止运行脚本"

这是 PowerShell 执行策略限制。以管理员身份运行 PowerShell，执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，输入 Y 确认即可。

5.2 Q: pnpm install 卡死或极慢

默认源服务器在国内访问慢。切换到淘宝镜像：pnpm config set registry https://registry.npmmirror.com

5.3 Q: pnpm build 在 PowerShell 下报错

构建脚本依赖 bash 语法，PowerShell 不支持。改用 Git Bash 运行 pnpm build。