Windows 11 上安装 OpenClaw 的步骤与通用流程类似，但需要特别注意 Node.js 的版本兼容性以及 PowerShell 的权限设置。OpenClaw 依赖较新的 Node.js 特性（通常要求 v22+），而 Windows 默认可能未安装或版本过低。

以下是专为 Windows 11 优化的详细安装指南：

🛑 第一步：准备环境（关键）

OpenClaw 需要 Node.js v22.0 或更高版本。

1. 检查当前版本：
   右键点击开始菜单，选择 终端 (Terminal) 或 PowerShell，输入：

   poweshell

   编辑

2. node -v

• 如果显示 v22.x.x 或更高，跳过此步。

• 如果显示 v18、v20 或提示“不是内部或外部命令”，请继续下一步。

3. 安装/升级 Node.js：

• 访问 Node.js 官网下载页。

• 下载 Current (当前版本)，通常是 v22.x 或 v23.x（不要下载 LTS 长期支持版，除非它已经是 v22+）。

• 运行 .msi 安装包，一路点击 "Next" 即可（确保勾选 "Add to PATH"）。

• 重要：安装完成后，必须关闭并重新打开 PowerShell 窗口，使环境变量生效。

• 再次运行 node -v 确认版本已更新。

4. (推荐) 安装 pnpm：
   OpenClaw 官方推荐使用 pnpm，它在 Windows 上比 npm 更快且更稳定。
   在 PowerShell 中运行：

   powershell

   编辑

5. npm install -g pnpm

   如果提示权限错误，请以管理员身份运行 PowerShell 后再执行。

🚀 第二步：安装 OpenClaw

您有两种选择：英文版 或 中文版（推荐国内用户使用中文版，配置更友好）。

选项 A：安装中文版 (推荐)

这是由社区维护的汉化版本，文档和提示均为中文，更适合国内网络环境配置。

1. 在 PowerShell 中运行：

   powershell

   编辑

2. pnpm add -g @qingchencloud/openclaw-zh@latest

   (如果没有安装 pnpm，可将 pnpm 替换为 npm)

3. 验证安装：

   powershell

   编辑

4. openclaw-zh --version

选项 B：安装国际英文版

powershell

编辑

pnpm add -g openclaw

验证：openclaw --version

⚙️ 第三步：初始化配置 (Onboarding)

安装完成后，需要运行向导来配置模型密钥和聊天渠道。

1. 运行向导：

• 如果是中文版：

  powershell

  编辑

openclaw-zh onboard

• 如果是英文版：

  powershell

  编辑

openclaw onboard

2. 跟随交互式提示：
   程序会引导您完成以下操作（使用键盘上下键选择，回车确认）：

• 常用选项：Telegram (最简单)、Discord、飞书、钉钉。

• 注意：微信个人号接入在 Windows 上配置较复杂，通常建议先用 Telegram 或飞书测试。

• 如果您有 API Key：选择 DeepSeek、通义千问 (Aliyun) 或 OpenAI。

• 如果您想在本地运行模型：选择 Ollama（需先自行安装 Ollama for Windows）。

• 选择大模型：

• 输入 API Key：根据提示粘贴您的密钥。

• 选择接入平台：

3. 完成配置：
   向导结束后，系统会自动生成配置文件（通常位于用户目录下的 .openclaw 文件夹中）。

▶️ 第四步：启动服务

配置完成后，启动 OpenClaw：

• 中文版：

  powershell

  编辑

• openclaw-zh start

• 英文版：

  powershell

  编辑

• openclaw start

成功标志：
终端会显示类似 Server running at http://localhost:3000 的信息，并且您配置的聊天机器人（如 Telegram Bot）开始响应消息。

💡 Windows 11 特有常见问题解决

1. 报错：EPERM: operation not permitted 或权限拒绝

这是在 Windows 上全局安装包时最常见的问题。

• 解决方法：

1. 点击开始菜单，搜索 PowerShell。

2. 右键点击，选择 “以管理员身份运行”。

3. 重新执行安装命令 (pnpm add -g ...)。

2. 报错：'openclaw' 不是内部或外部命令

这通常是因为环境变量未刷新。

• 解决方法：

1. 完全关闭当前的 PowerShell 窗口。

2. 重新打开一个新的窗口。

3. 再次尝试运行命令。

4. 如果仍然不行，重启电脑。

3. 网络问题 (连接 GitHub 或 npm 源超时)

如果您在国内，下载依赖包可能会很慢或失败。

• 解决方法：配置国内镜像源。
  在执行安装命令前，运行：

  powershell

  编辑

• npm config set registry https://registry.npmmirror.compnpm config set registry https://registry.npmmirror.com

  然后再执行安装步骤。

4. 如何在后台运行？

默认情况下，关闭 PowerShell 窗口服务就会停止。如果您希望它像软件一样在后台运行：

• 简单方法：保持 PowerShell 窗口最小化运行。

• 进阶方法：使用 nssm (Non-Sucking Service Manager) 将其注册为 Windows 服务，或者使用 Docker Desktop for Windows 进行容器化部署（适合高级用户）。

✅ 验证是否成功

1. 打开您配置的聊天软件（例如 Telegram）。

2. 向机器人发送 help 或 你好。

3. 如果机器人回复了消息，说明安装成功！

4. 也可以在浏览器访问 http://localhost:3000 查看管理面板（如果开启了 Web UI）。