OpenClaw Windows 设置指南：在 Windows 10 和 11 上安装

简介

OpenClaw 在 Windows 上运行良好，但安装过程与 macOS 和 Linux 略有不同。本指南涵盖了在 Windows 10 或 Windows 11 上安装和运行 OpenClaw 所需的所有内容，包括 PowerShell 设置、Node.js 安装和 WSL2 建议。

有关一般安装说明，请参阅我们的完整安装指南。

系统要求

Windows 版本

Windows 10（版本 1903 或更高版本）
Windows 11（所有版本）
旧版本可能可以工作，但不受官方支持

硬件

RAM — 建议 2GB+（4GB+ 可获得最佳性能）
存储 — 500MB+ 用于安装，额外的内存/数据空间
处理器 — 任何现代 x64 处理器

软件先决条件

Node.js 18+ — 运行 OpenClaw 所需
PowerShell 5.1+ 或 Windows 终端 — 推荐使用 CMD
Git（可选）- 用于从源代码进行可破解安装

安装方法

方法一：npm Install（推荐）

在 Windows 上安装 OpenClaw 的标准方法：

安装 Node.js（如果尚未安装）：
- 从 nodejs.org 下载
- 选择 LTS 版本（18.x 或更高版本）
- 使用默认设置运行安装程序
- 验证安装：
```
node --version
npm --version
```
安装OpenClaw：
```
npm i -g openclaw
```
验证安装：
```
openclaw --version
```

方法 2：PowerShell One-Liner

PowerShell 脚本自动执行安装：

irm https://openclaw.ai/install.ps1 | iex

注意： 您可能需要启用脚本执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

该脚本将：

检查Node.js（如果缺少则提示安装）
全局安装OpenClaw
如果需要的话设置路径
验证安装

方法 3：WSL2 安装（最佳体验）

Windows Subsystem for Linux 2 (WSL2) 提供了一个通常更适合 OpenClaw 的 Linux 环境：

安装 WSL2：
```
wsl --install
```
出现提示时重新启动计算机。
安装 Ubuntu（或您喜欢的 Linux 发行版）：
```
wsl --install -d Ubuntu
```

在 WSL2 中，安装 OpenClaw：

curl -fsSL https://openclaw.ai/install.sh | bash

WSL2 提供：

与 Unix 工具更好的兼容性
原生 Linux 性能
更轻松地与基于 Linux 的服务集成
访问 Linux 包管理器

有关 WSL2 特定说明，请参阅我们的 Linux 设置指南。

方法 4：可破解安装（从源代码）

对于想要修改源代码的开发者：

安装Git：
- 从 git-scm.com 下载
- 或通过winget安装：
```
winget install Git.Git
```

克隆和构建：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

从源代码运行：
```
npm run openclaw onboard
```

在 Windows 上安装 Node.js

选项 1：官方安装程序

访问nodejs.org
下载LTS版本（18.x或更高版本）
运行安装程序
安装时勾选“添加到PATH”
验证：
```
node --version
npm --version
```

选项 2：winget（Windows 包管理器）

winget install OpenJS.NodeJS.LTS

选项 3：巧克力味

如果您安装了 Chocolatey：

choco install nodejs-lts

选项 4：勺子

如果您使用勺子：

scoop install nodejs-lts

PowerShell 与命令提示符

PowerShell（推荐）

PowerShell 更强大、更现代：

更好的脚本编写能力
与跨平台命令更加一致
更好的错误处理
原生 JSON 支持

使用 PowerShell 执行所有 OpenClaw 命令。

命令提示符 (CMD)

CMD 可以工作，但有局限性：

较旧的语法
不太强大的脚本
某些 npm 脚本可能无法正常工作

如果必须使用 CMD，命令大多相同，但建议使用 PowerShell。### Windows 终端

Windows Terminal 提供最佳体验：

多个选项卡
更好的字体渲染
可定制的外观
集成 PowerShell、CMD 和 WSL

从 Microsoft Store 安装或：

winget install Microsoft.WindowsTerminal

安装后设置

安装完成后，配置OpenClaw：

openclaw onboard

此交互式设置涵盖：

1.AI模型配置

选择您的人工智能提供商：

AnthropicClaude：

Claude 3.5 十四行诗（推荐）
Claude 3 部作品
Claude 4

从 console.anthropic.com 获取您的 API 密钥。

OpenAI GPT：

GPT-4o
GPT-4 涡轮增压
GPT-4.1

从 platform.openai.com 获取您的 API 密钥。

本地型号：

Ollama（本地运行）
LM工作室
最小最大

2. Windows 权限

OpenClaw 可能会请求权限：

防火墙 — 允许 Node.js/OpenClaw 通过 Windows 防火墙
防病毒 — 可能需要将 OpenClaw 目录列入白名单
文件系统 — 用于读/写文件

3. 路径配置

确保 OpenClaw 在您的路径中：

$env:PATH -split ';' | Select-String "npm"

如果没有找到，添加npm全局路径：

$npmPath = npm config get prefix
$env:PATH += ";$npmPath"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

修改PATH后重新启动PowerShell。

运行 OpenClaw

启动服务器

openclaw

这将启动本地服务器并连接所有配置的集成。

在后台运行

使用 Start-Process：

Start-Process -NoNewWindow openclaw

或者使用像 pm2 这样的进程管理器：

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

作为 Windows 服务运行

使用 node-windows 安装为 Windows 服务：

npm i -g node-windows

创建服务脚本（请参阅 node-windows 文档）。

在启动时启动

创建计划任务：

打开任务计划程序
创建基本任务
名称：“OpenClaw”
触发：“当我登录时”
操作：“启动程序”
程序：C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd
参数：（留空）

或者使用启动文件夹：

$startup = [Environment]::GetFolderPath("Startup")
$shortcut = "$startup\OpenClaw.lnk"
$shell = New-Object -ComObject WScript.Shell
$link = $shell.CreateShortcut($shortcut)
$link.TargetPath = "C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd"
$link.Save()

Windows 特定注意事项

防病毒软件

某些防病毒软件可能会标记 OpenClaw：

Windows Defender — 通常工作正常，可能需要排除
第三方 AV — 可能需要白名单

添加排除：

OpenClaw安装目录
~/.openclaw 数据目录
Node.js 可执行文件

防火墙配置

允许 OpenClaw 通过 Windows 防火墙：

New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -Program "C:\Users\YourName\AppData\Roaming\npm\node_modules\openclaw\bin\openclaw.js" -Action Allow

或者使用 Windows Defender 防火墙 GUI：

Windows 安全 → 防火墙和网络保护
允许应用程序通过防火墙
添加OpenClaw

长路径支持

Windows 有 260 个字符的路径限制。启用长路径：

打开组策略编辑器 (gpedit.msc)
导航至：计算机配置 → 管理模板 → 系统 → 文件系统
启用“启用Win32长路径”
重新启动计算机

或编辑注册表（仅限高级用户）。

行结尾

Windows 使用 CRLF，Unix 使用 LF。大多数工具会自动处理此问题，但如果您遇到问题：

git config --global core.autocrlf true

故障排除

未找到命令

如果 openclaw 未被识别：

检查npm全局路径：
```
npm config get prefix
```

添加到路径：

$npmPath = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", [EnvironmentVariableTarget]::User)

重新启动PowerShell
验证：
```
Get-Command openclaw
```

权限被拒绝

如果您看到权限错误：

以管理员身份运行 PowerShell：右键单击 PowerShell →“以管理员身份运行”
全局安装：
```
npm i -g openclaw
```

修复 npm 权限（替代方案）：

mkdir $env:APPDATA\npm-global
npm config set prefix "$env:APPDATA\npm-global"
$env:PATH += ";$env:APPDATA\npm-global"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

端口已在使用中

更改端口：

openclaw --port 3001

或者找到并终止该进程：

netstat -ano | findstr :3000
taskkill /PID <PID> /F

Node.js 版本问题

确保您有 Node.js 18+：

node --version

如果过时，请更新：

winget upgrade OpenJS.NodeJS.LTS
```或者从 [nodejs.org](https://nodejs.org/) 下载最新版本。

### WSL2 集成

如果使用 WSL2，请访问 Windows 文件：

```bash
# In WSL2
cd /mnt/c/Users/YourName

从 Windows 访问 WSL2 文件：

# In PowerShell
cd \\wsl$\Ubuntu\home\username

性能提示

WSL2 性能

如果使用 WSL2：

将 OpenClaw 数据存储在 WSL2 文件系统中（更快）
所有操作均使用 WSL2
需要时通过 /mnt/c/ 访问 Windows 文件

Windows Defender

从实时扫描中排除 OpenClaw 目录：

Windows 安全 → 病毒和威胁防护
管理设置 → 排除
添加文件夹：
- C:\Users\YourName\AppData\Roaming\npm
- C:\Users\YourName\.openclaw

内存管理

监控资源使用情况：

Get-Process | Where-Object {$_.ProcessName -like "*node*"} | Select-Object ProcessName, CPU, WorkingSet

更新 OpenClaw

更新到最新版本：

npm update -g openclaw

或者重新运行安装程序：

irm https://openclaw.ai/install.ps1 | iex

卸载

删除 OpenClaw：

npm uninstall -g openclaw

删除配置：

Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

从 PATH 中删除（如果手动添加）。

后续步骤

现在 OpenClaw 已安装在 Windows 上：

连接聊天应用程序 — WhatsApp、Telegram、Discord
设置集成 — Gmail、Slack
探索技能 — 技能库
阅读常见问题解答 — 常见问题

结论

使用 npm 在 Windows 上安装 OpenClaw 非常简单。虽然 WSL2 提供了最佳体验，但本机 Windows 安装非常适合大多数用户。建议使用 PowerShell 而不是 CMD，以获得更好的兼容性和脚本功能。

如需更多帮助，请查看我们的一般安装指南或常见问题解答页面。祝您在 Windows 上实现自动化！

Cookie 协议已启动

Quick Answer

简介