联系方式 & 交流群

微信: gzs-47

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

OpenClaw 部署教程 - Windows 篇（2026 终极版）#

📅 更新时间：2026-03-17
⏱️ 阅读时间：20 分钟
💡 难度等级：⭐⭐☆☆☆
✅ 实测环境：Windows 11 专业版 / Node.js v22.1.0 / Git 2.46.0 / PowerShell 7.4

⚠️ 部署前必读（安全警示）#

系统安全#

管理员权限：安装过程需要管理员权限，但运行时建议使用普通用户
防火墙：首次运行会提示允许网络访问，需点击”允许”
杀毒软件：Windows Defender 可能误报，需添加排除项
备份：部署前备份重要数据

硬件要求#

内存：最低 4GB，推荐 8GB+（2GB 需配置虚拟内存）
磁盘：至少 10GB 可用空间（推荐 SSD）
网络：需访问外网（中国大陆用户需配置代理）

环境准备#

PowerShell：需以管理员身份运行
执行策略：需设置为 RemoteSigned（允许运行签名脚本）
TLS 1.2：必须启用（解决 SSL 连接问题）

📋 系统要求（精准参数）#

项目	最低要求	推荐配置	生产环境
操作系统	Windows 10	Windows 11	Windows 11 专业版 23H2
CPU	2 核心	4 核心+	8 核心+ (Intel i7/Ryzen 7)
内存	4GB	8GB+	16GB+ (AI 模型缓存)
磁盘	10GB	20GB SSD	50GB NVMe SSD
Node.js	v18+	v20+	v22.1.0 (最新稳定)
Git	任意版本	最新	2.46.0
PowerShell	5.1+	7.4+	7.4.1

⚠️ 关键说明：

Node.js v22：OpenClaw 官方推荐版本，兼容性最佳
PowerShell 7：比 5.1 更稳定，支持更多命令
Git 必须：用于克隆仓库和管理依赖

🔧 快速安装（10 分钟完成）#

方法一：PowerShell 一键安装（推荐新手）#

完整流程（复制粘贴到 PowerShell）：

1
# ============ 步骤 1：以管理员身份运行 PowerShell ============
2
# 开始菜单 → 搜索 PowerShell → 右键 → 以管理员身份运行
3

4
# ============ 步骤 2：设置执行策略（允许运行脚本） ============
5
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
6

7
# ============ 步骤 3：启用 TLS 1.2（解决 SSL 连接问题） ============
8
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
9

10
# ============ 步骤 4：执行安装脚本 ============
11
irm https://docs.openclaw.ai/zh-CN/install | iex
12

13
# ============ 步骤 5：验证安装 ============
14
openclaw --version

⏱️ 预计耗时：5-10 分钟（取决于网络）

⚠️ 注意事项：

必须管理员权限：否则安装失败
国内网络：可能需要代理
安装过程：自动安装 Node.js、Git、OpenClaw

方法二：分步安装（可控性更强，推荐）#

适合需要精确控制版本或排查问题的场景：

步骤 1：准备工作目录#

1
# 创建临时目录（存放安装包）
2
New-Item -Path "C:\temp" -ItemType Directory -Force

步骤 2：启用 TLS 1.2#

1
# 必须执行，否则下载会失败
2
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

步骤 3：安装 Node.js 22#

1
# 1. 下载 Node.js 22.1.0 64 位安装包
2
iwr -Uri "https://nodejs.org/dist/v22.1.0/node-v22.1.0-x64.msi" `
3
 -OutFile "C:\temp\node-v22.1.0-x64.msi" `
4
 -UseBasicParsing
5

6
# 2. 验证文件是否存在
7
if (Test-Path "C:\temp\node-v22.1.0-x64.msi") {
8
    Write-Host "✅ 文件存在，开始安装..."
9
    # 静默安装，/qn 表示无界面，/norestart 表示不自动重启
10
    Start-Process -FilePath "C:\temp\node-v22.1.0-x64.msi" `
11
     -ArgumentList "/qn /norestart" `
12
     -Wait
13
    Write-Host "✅ Node.js 安装完成！"
14
} else {
15
    Write-Host "❌ 错误：安装包未找到，请检查下载命令！"
16
}
17

18
# 3. 验证版本（需重新打开 PowerShell）
19
node -v   # 应显示：v22.1.0
20
npm -v    # 应显示：10.5.0+

⏱️ 预计耗时：3-5 分钟

步骤 4：安装 Git#

1
# 1. 下载 Git for Windows 最新稳定版
2
iwr -Uri "https://github.com/git-for-windows/git/releases/download/v2.46.0.windows.1/Git-2.46.0-64-bit.exe" `
3
 -OutFile "C:\temp\Git-Setup.exe" `
4
 -UseBasicParsing
5

6
# 2. 静默安装（自动添加到 PATH）
7
Start-Process -FilePath "C:\temp\Git-Setup.exe" `
8
 -ArgumentList "/VERYSILENT /NORESTART /NOCANCEL /SP- /SUPPRESSMSGBOXES /ADDLOCAL=ALL" `
9
 -Wait
10

11
Write-Host "✅ Git 安装完成，请重启 PowerShell 后验证！"
12

13
# 3. 验证（需重启 PowerShell）
14
git --version  # 应显示：git version 2.46.0.windows.1

⏱️ 预计耗时：2-3 分钟

步骤 5：安装 OpenClaw#

1
# 方法 A：下载脚本到本地（推荐，可排查错误）
2
$scriptPath = "C:\temp\openclaw-install.ps1"
3
New-Item -Path "C:\temp" -ItemType Directory -Force | Out-Null
4
iwr -Uri "https://openclaw.ai/install.ps1" -OutFile $scriptPath -UseBasicParsing
5

6
# 执行脚本（会显示具体错误，而非闪退）
7
& $scriptPath
8

9
# 方法 B：一键安装（简单快速）
10
iwr -useb https://openclaw.bot/install.ps1 | iex
11

12
# 验证安装
13
openclaw --version
14
where openclaw

⏱️ 预计耗时：2-3 分钟

⚙️ 初始化配置（Onboarding 向导）#

安装成功后会自动进入初始化向导，按以下步骤操作：

完整流程#

1
# 步骤 1：执行初始化向导
2
openclaw onboard --flow quickstart
3

4
# 步骤 2：启动 OpenClaw
5
openclaw start
6

7
# 步骤 3：测试运行
8
# 在聊天界面输入 "Hello"
9
# 应收到 AI 回复

详细步骤说明#

步骤	提示内容	操作	说明
1	安全提示确认	输入 `Yes`	知晓权限风险
2	选择部署模式	选择 `QuickStart`	后续可补充配置
3	选择模型服务商	选择 `OpenAI`	或其他服务商
4	模型授权	复制链接到浏览器	登录账号完成授权
5	通信通道配置	选择 `Skip for now`	后续可配置
6	技能配置	选择 `No`	暂不配置
7	Hooks 配置	选择 `Session`	暂不启用
8	启动方式	选择 `TUI`	终端聊天界面
9	测试	输入 `Hello`	确认安装成功

配置 API Keys#

编辑配置文件：

1
notepad $env:USERPROFILE\.openclaw\workspace\TOOLS.md

添加以下内容（替换为你的 Key）：

1
## 🔑 API Keys
2

3
### 阿里云百炼（推荐，国内访问快）
4
- **API Key**: `sk-sp-xxxxxxxxxxxxxxxx`
5
- **模型**: qwen3.5-plus, qwen3-max-2026-01-23
6
- **状态**: ✅ 已配置
7
- **用途**: 代码生成/审查/优化
8

9
### OpenAI（备选）
10
- **API Key**: `sk-proj-xxxxxxxxxxxxxxxx`
11
- **模型**: gpt-4o, gpt-4-turbo
12

13
### 火山引擎（备选）
14
- **API Key**: `xxxxxxxxxxxxxxxx`
15
- **模型**: doubao-seed-2.0-code

Key 获取地址：

阿里云百炼：https://bailian.console.aliyun.com/
OpenAI：https://platform.openai.com/api-keys
火山引擎：https://www.volcengine.com/

配置代理（中国大陆用户必须）#

编辑配置文件：

1
notepad $env:USERPROFILE\.openclaw\config.json

添加代理配置：

1
{
2
  "proxy": {
3
    "http": "http://127.0.0.1:7890",
4
    "https": "http://127.0.0.1:7890"
5
  },
6
  "gateway": {
7
    "port": 18789,
8
    "host": "0.0.0.0"
9
  }
10
}

验证代理：

1
$env:HTTP_PROXY="http://127.0.0.1:7890"
2
$env:HTTPS_PROXY="http://127.0.0.1:7890"
3
Test-NetConnection api.binance.com -Port 443
4
# 应显示：TcpTestSucceeded : True

🚀 高级配置（生产环境必备）#

1. 配置虚拟内存（4GB 内存推荐）#

检查当前虚拟内存：

1
# 查看系统信息
2
systeminfo | findstr "虚拟内存"

手动配置（8GB 虚拟内存）：

右键”此电脑” → 属性
高级系统设置 → 高级 → 性能设置
高级 → 虚拟内存 → 更改
取消”自动管理”
选择 C 盘 → 自定义大小
初始大小：8192 MB，最大值：8192 MB
点击”设置” → 确定 → 重启

2. 配置 Windows 防火墙#

允许 OpenClaw 通过网络：

1
# 添加入站规则
2
New-NetFirewallRule -DisplayName "OpenClaw Gateway" `
3
 -Direction Inbound `
4
 -LocalPort 18789 `
5
 -Protocol TCP `
6
 -Action Allow
7

8
# 查看规则
9
Get-NetFirewallRule | Where-Object DisplayName -like "*OpenClaw*"

3. 配置 Windows Defender 排除项#

避免误报：

1
# 添加排除目录
2
Add-MpPreference -ExclusionPath "C:\Users\$env:USERNAME\.openclaw"
3

4
# 添加排除进程
5
Add-MpPreference -ExclusionProcess "node.exe"
6

7
# 验证排除项
8
Get-MpPreference | Select-Object ExclusionPath, ExclusionProcess

4. 开机自启（任务计划程序）#

创建启动脚本 C:\openclaw-start.bat：

1
@echo off
2
timeout /t 30 /nobreak
3
cd /d %USERPROFILE%\.openclaw\workspace
4
openclaw gateway start
5
exit

添加到任务计划程序：

开始菜单 → 搜索”任务计划程序”
右侧”创建基本任务”
名称：OpenClaw Gateway
触发器：登录时
操作：启动程序
程序/脚本：C:\openclaw-start.bat
完成 → 输入管理员密码

验证：

1
# 查看任务
2
Get-ScheduledTask | Where-Object TaskName -like "*OpenClaw*"
3

4
# 手动运行测试
5
Start-ScheduledTask -TaskName "OpenClaw Gateway"

🔍 故障排查（精准诊断）#

问题 1：ExecutionPolicy 报错#

症状：cannot be loaded because running scripts is disabled on this system

解决方案：

1
# 1. 检查当前策略
2
Get-ExecutionPolicy -Scope CurrentUser
3

4
# 2. 临时设置（仅当前会话）
5
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
6

7
# 3. 验证
8
Get-ExecutionPolicy -Scope CurrentUser
9
# 应显示：RemoteSigned
10

11
# 4. 重新运行安装脚本
12
& $scriptPath

问题 2：PATH 或命令找不到#

症状：openclaw : 无法将"openclaw"项识别为 cmdlet、函数、脚本文件

解决方案：

1
# 1. 检查 openclaw 路径
2
where openclaw
3

4
# 2. 如果无输出，说明未添加到 PATH
5
# 手动添加环境变量
6
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
7
$npmPath = "$env:APPDATA\npm"
8
[Environment]::SetEnvironmentVariable("Path", "$userPath;$npmPath", "User")
9

10
# 3. 重新打开 PowerShell（必须）
11
# 关闭所有 PowerShell 窗口，重新打开
12

13
# 4. 验证
14
openclaw --version

问题 3：安装脚本闪退#

症状：执行脚本后 PowerShell 直接关闭，看不到错误信息

解决方案：

1
# 1. 下载脚本到本地（不要直接管道执行）
2
$scriptPath = "C:\temp\openclaw-install.ps1"
3
New-Item -Path "C:\temp" -ItemType Directory -Force | Out-Null
4
iwr -Uri "https://openclaw.ai/install.ps1" -OutFile $scriptPath -UseBasicParsing
5

6
# 2. 手动执行（会显示具体错误）
7
& $scriptPath
8

9
# 3. 如果还是失败，查看错误日志
10
Get-Content C:\temp\openclaw-install.log -Tail 50

问题 4：Node.js 版本不兼容#

症状：Error: Unsupported Node.js version

解决方案：

1
# 1. 查看当前版本
2
node -v
3

4
# 2. 卸载旧版本（控制面板 → 程序和功能）
5
# 或者使用 PowerShell
6
winget uninstall "Node.js"
7

8
# 3. 重新安装 Node.js 22
9
iwr -Uri "https://nodejs.org/dist/v22.1.0/node-v22.1.0-x64.msi" `
10
 -OutFile "C:\temp\node-v22.1.0-x64.msi"
11
Start-Process -FilePath "C:\temp\node-v22.1.0-x64.msi" `
12
 -ArgumentList "/qn /norestart" -Wait
13

14
# 4. 重新打开 PowerShell 验证
15
node -v  # 应显示：v22.1.0

问题 5：防火墙或 Defender 拦截#

症状：网络连接超时，或被 Defender 隔离

解决方案：

1
# 1. 检查防火墙规则
2
Get-NetFirewallRule | Where-Object DisplayName -like "*OpenClaw*"
3

4
# 2. 添加入站规则（如果不存在）
5
New-NetFirewallRule -DisplayName "OpenClaw Gateway" `
6
 -Direction Inbound `
7
 -LocalPort 18789 `
8
 -Protocol TCP `
9
 -Action Allow
10

11
# 3. 检查 Defender 隔离区
12
Get-MpThreatDetection | Select-Object ThreatName, DetectionTime
13

14
# 4. 恢复被隔离文件（如果有）
15
# Windows 安全中心 → 病毒和威胁防护 → 保护历史记录 → 还原
16

17
# 5. 添加排除项
18
Add-MpPreference -ExclusionPath "$env:USERPROFILE\.openclaw"

问题 6：端口被占用#

症状：Error: listen EADDRINUSE: address already in use :::18789

解决方案：

1
# 1. 检查端口占用
2
netstat -ano | findstr :18789
3
# 输出示例：TCP  0.0.0.0:18789  0.0.0.0:0  LISTEN  1234
4

5
# 2. 杀死占用进程
6
taskkill /F /PID 1234
7

8
# 3. 或者修改 OpenClaw 端口
9
notepad $env:USERPROFILE\.openclaw\config.json
10
# 修改："port": 18790
11

12
# 4. 重启服务
13
openclaw gateway restart

问题 7：npm 安装失败#

症状：npm ERR! code EACCES 或 npm ERR! permissions

解决方案：

1
# 1. 清理 npm 缓存
2
npm cache clean --force
3

4
# 2. 使用淘宝镜像
5
npm config set registry https://registry.npmmirror.com
6

7
# 3. 修改 npm 全局目录
8
npm config set prefix "C:\npm-global"
9

10
# 4. 添加环境变量
11
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
12
[Environment]::SetEnvironmentVariable("Path", "$userPath;C:\npm-global", "User")
13

14
# 5. 重新打开 PowerShell，重新安装
15
npm install -g openclaw

✅ 验证安装（完整测试清单）#

逐项检查，全部通过才算成功：

1
# □ 1. 检查版本号
2
openclaw --version
3
# 期望输出：openclaw/x.x.x win32-x64 node-v22.1.0
4

5
# □ 2. 检查网关状态
6
openclaw gateway status
7
# 期望输出：Gateway is running
8

9
# □ 3. 检查端口监听
10
netstat -ano | findstr :18789
11
# 期望输出：TCP  0.0.0.0:18789  0.0.0.0:0  LISTEN
12

13
# □ 4. 测试本地访问
14
Test-NetConnection localhost -Port 18789
15
# 期望输出：TcpTestSucceeded : True
16

17
# □ 5. 发送测试消息
18
openclaw message send "Hello OpenClaw!"
19
# 期望：收到 AI 回复
20

21
# □ 6. 检查日志无 ERROR
22
Get-Content $env:USERPROFILE\.openclaw\workspace\memory\*.log -Tail 50 | Select-String "ERROR"
23
# 期望：无输出
24

25
# □ 7. 检查服务状态
26
openclaw gateway status
27
# 期望输出：Active: active (running)
28

29
# □ 8. 测试开机自启
30
# 重启电脑后检查：
31
openclaw gateway status
32
# 期望：服务自动启动

成功标志：

✅ 8 项检查全部通过
✅ 日志无 ERROR 级别错误
✅ 服务重启后自动恢复

📊 性能优化（生产环境）#

1. 使用 SSD 存储#

检查工作区位置：

1
# 查看工作区路径
2
openclaw status
3

4
# 如果不在 SSD，迁移工作区
5
Move-Item "$env:USERPROFILE\.openclaw" "D:\openclaw"
6
New-Item -ItemType SymbolicLink `
7
 -Path "$env:USERPROFILE\.openclaw" `
8
 -Target "D:\openclaw"

2. 增加 Node.js 内存#

编辑启动配置：

1
# 临时生效（当前会话）
2
$env:NODE_OPTIONS="--max-old-space-size=4096"
3

4
# 永久生效（添加到环境变量）
5
[Environment]::SetEnvironmentVariable("NODE_OPTIONS", "--max-old-space-size=4096", "User")

3. 定期清理缓存#

创建清理脚本 C:\cleanup-openclaw.ps1：

1
Write-Host "🧹 开始清理 OpenClaw 缓存..."
2

3
# 清理 npm 缓存
4
npm cache clean --force
5
Write-Host "✅ npm 缓存已清理"
6

7
# 清理临时文件
8
Remove-Item "C:\temp\openclaw-*" -Recurse -Force -ErrorAction SilentlyContinue
9
Write-Host "✅ 临时文件已清理"
10

11
# 清理日志（保留最近 7 天）
12
$daysToKeep = 7
13
$cutoffDate = (Get-Date).AddDays(-$daysToKeep)
14
Get-ChildItem "$env:USERPROFILE\.openclaw\workspace\memory\*.log" | Where-Object { $_.LastWriteTime -lt $cutoffDate } | Remove-Item
15
Write-Host "✅ 旧日志已清理"
16

17
Write-Host "🎉 清理完成！"

运行清理脚本：

1
# 以管理员身份运行
2
powershell -ExecutionPolicy Bypass -File C:\cleanup-openclaw.ps1

添加到任务计划程序（每周日凌晨 3 点）：

任务计划程序 → 创建基本任务
名称：OpenClaw Cleanup
触发器：每周，周日，凌晨 3<00>
操作：启动程序
程序：powershell.exe
参数：-ExecutionPolicy Bypass -File C:\cleanup-openclaw.ps1

📚 更多资源#

官方文档#

社区教程#

其他平台部署#

📝 更新日志#

版本	日期	更新内容
v3.0	2026-03-17	整合 PowerShell 一键脚本 + Node.js 22 + Git 环境 + 初始化向导详解
v2.0	2026-03-10	增加安全警示、精准参数、故障排查流程
v1.5	2026-03-05	增加 Docker 方案、性能优化章节
v1.0	2026-03-01	初始版本发布

最后更新：2026-03-17
作者：OpenClaw 社区
许可：MIT
审核：嵌入式硬件专家（15 年 + 经验）

觉得有用？欢迎分享给更多朋友！ 🚀

音乐

OpenClaw 部署教程 - Windows 篇（2026 终极版）

OpenClaw 部署教程 - Windows 篇（2026 终极版）#

⚠️ 部署前必读（安全警示）#

系统安全#

硬件要求#

环境准备#

📋 系统要求（精准参数）#

🔧 快速安装（10 分钟完成）#

方法一：PowerShell 一键安装（推荐新手）#

方法二：分步安装（可控性更强，推荐）#

步骤 1：准备工作目录#

步骤 2：启用 TLS 1.2#

步骤 3：安装 Node.js 22#

步骤 4：安装 Git#

步骤 5：安装 OpenClaw#

⚙️ 初始化配置（Onboarding 向导）#

完整流程#

详细步骤说明#

配置 API Keys#

配置代理（中国大陆用户必须）#

🚀 高级配置（生产环境必备）#

1. 配置虚拟内存（4GB 内存推荐）#

2. 配置 Windows 防火墙#

3. 配置 Windows Defender 排除项#

4. 开机自启（任务计划程序）#

🔍 故障排查（精准诊断）#

问题 1：ExecutionPolicy 报错#

问题 2：PATH 或命令找不到#

问题 3：安装脚本闪退#

问题 4：Node.js 版本不兼容#

问题 5：防火墙或 Defender 拦截#

问题 6：端口被占用#

问题 7：npm 安装失败#

✅ 验证安装（完整测试清单）#

📊 性能优化（生产环境）#

1. 使用 SSD 存储#

2. 增加 Node.js 内存#

3. 定期清理缓存#

📚 更多资源#

官方文档#

社区教程#

其他平台部署#

📝 更新日志#

文章分享