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 用于克隆仓库和管理依赖，必装

快速安装

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

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

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

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

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

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

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

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

注意事项：

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

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

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

步骤 1：准备工作目录

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

步骤 2：启用 TLS 1.2

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

步骤 3：安装 Node.js 22

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

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

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

预计耗时：3-5 分钟

步骤 4：安装 Git

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

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

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

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

预计耗时：2-3 分钟

步骤 5：安装 OpenClaw

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

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

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

# 验证安装
openclaw --version
where openclaw

预计耗时：2-3 分钟

初始化配置（Onboarding 向导）

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

完整流程

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

# 步骤 2：启动 OpenClaw
openclaw start

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

详细步骤说明

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

配置 API Keys

编辑配置文件：

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

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

## API Keys

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

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

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

Key 获取地址：

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

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

编辑配置文件：

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

添加代理配置：

{
 "proxy": {
 "http": "http://127.0.0.1:7890",
 "https": "http://127.0.0.1:7890"
 },
 "gateway": {
 "port": 18789,
 "host": "0.0.0.0"
 }
}

验证代理：

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

高级配置

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

检查当前虚拟内存：

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

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

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

2. 配置 Windows 防火墙

允许 OpenClaw 通过网络：

# 添加入站规则
New-NetFirewallRule -DisplayName "OpenClaw Gateway" `
 -Direction Inbound `
 -LocalPort 18789 `
 -Protocol TCP `
 -Action Allow

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

3. 配置 Windows Defender 排除项

避免误报：

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

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

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

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

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

@echo off
timeout /t 30 /nobreak
cd /d %USERPROFILE%\.openclaw\workspace
openclaw gateway start
exit

添加到任务计划程序：

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

验证：

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

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

故障排查

问题 1：ExecutionPolicy 报错

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

解决方案：

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

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

# 3. 验证
Get-ExecutionPolicy -Scope CurrentUser
# 应显示：RemoteSigned

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

问题 2：PATH 或命令找不到

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

解决方案：

# 1. 检查 openclaw 路径
where openclaw

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

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

# 4. 验证
openclaw --version

问题 3：安装脚本闪退

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

解决方案：

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

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

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

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

症状：Error: Unsupported Node.js version

解决方案：

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

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

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

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

问题 5：防火墙或 Defender 拦截

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

解决方案：

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

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

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

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

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

问题 6：端口被占用

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

解决方案：

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

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

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

# 4. 重启服务
openclaw gateway restart

问题 7：npm 安装失败

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

解决方案：

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

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

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

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

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

验证安装

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

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

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

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

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

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

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

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

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

成功标志：

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

性能优化

1. 使用 SSD 存储

检查工作区位置：

# 查看工作区路径
openclaw status

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

2. 增加 Node.js 内存

编辑启动配置：

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

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

3. 定期清理缓存

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

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

# 清理 npm 缓存
npm cache clean --force
Write-Host "npm 缓存已清理"

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

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

Write-Host "清理完成"

运行清理脚本：

# 以管理员身份运行
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

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

部署前必读

系统安全

硬件要求

环境准备

系统要求

快速安装

方法一：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. 定期清理缓存

更多资源

官方文档

社区教程

其他平台部署

更新日志