本文介绍了在Windows系统本地部署OpenClaw的完整流程。首先安装Nodejs、Git和Visual Studio，然后通过npm安装OpenClaw并进行交互式配置。部署完成后，通过PowerShell脚本将OpenClaw注册为Windows服务，实现开机自启动，解决了需手动启动的问题。

一、部署环境说明

· 无需科学上网
· 本地部署，无需WSL

二、安装步骤

1、安装 Node.js、Git 和 Visual Studio

1）下载安装包

· Node.js + Git + Visual Studio 点击下载

2）安装Git

· 安装过程中请全部勾选选项，持续点击“下一步”直至完成

· 在相关步骤选择“Use Windows’ default console window”，继续下一步

· 安装结束时，无需勾选任何选项，点击“Finish”完成

3)安装 Node.js

· 按照提示，持续点击“下一步”即可完成安装

4）安装Visual Studio

· 在安装界面勾选“使用C++的桌面开发”选项

5）验证安装结果

· 以管理员身份打开 PowerShell
· 右键点击Windows图标，选择“Windows PowerShell(管理员）”

· 依次运行以下命令，检查安装结果：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
node -V
npm -V
git -V

2、下载 OpenClaw

· 在刚刚打开的 PowerShell窗口，执行如下命令：

npm install -g openclaw@latest

· 若出现安装回显，说明已成功安装

3、初始化配置OpenClaw

1）在命令行窗口执行：

openclaw onboard

2）进行交互式配置

· 部署存在风险时，选择“yes”并回车

· 选择“QuickStart”并回车

· 选择模型供应商（如火山引擎），回车确认

· 输入火山引|擎的APIKey，粘贴后回车即可

· 选择模型(如volcengine-plan/ark-code-latest），可根据实际需求更改

· 对话工具配置暂时跳过，选择“skip for now”

· Skills 配置暂时跳过，选择“no”

· 日志和会话记录建议全部选上，通过方向键加空格选中，回车确认

· 等待OpenClaw的Gateway程序自动安装并打开浏览器网页

三、测试与设置开机自启动

· 安装完成后，可发送消息测试部署效果。示例：在桌面创建“hi.txt”文件，并返回存放路径
注意：命令行窗口不可关闭，关闭后OpenClaw会停止运行。

· Al执行完毕后，可检查成果

· 文件已成功创建，部署完成
· 部署缺点：每次重启需手动打开 PowerShell 并输入openclaw gateway run命令，否则无法访问控制台网页
· 为解决此问题，已编写脚本实现开机自启动

开机自启动操作步骤

设置前需要先关闭openclaw运行窗口
1、创建一个txt文件
2、将以下代码复制到txt文件中：

# 1. 自动提权
if (!([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
    exit
}

Write-Host "🔧 正在将 OpenClaw 注册为 Windows 服务..." -ForegroundColor Cyan

# ================= 配置区域 =================
$serviceName = "OpenClawGateway"
$serviceDesc = "OpenClaw Gateway Service - Runs automatically at boot"
$nssmUrl = "https://nssm.cc/release/nssm-2.24.zip"
$nssmZip = "$env:TEMP\nssm.zip"
$nssmDir = "$env:TEMP\nssm"
$nssmExe = "$nssmDir\nssm-2.24\win64\nssm.exe" # 假设 64 位系统

# 获取当前用户真实路径
$realUser = $env:USERNAME
$userProfilePath = "C:\Users\$realUser"
$nodeExe = "C:\Program Files\nodejs\node.exe"
$scriptPath = "$userProfilePath\AppData\Roaming\npm\node_modules\openclaw\dist\index.js"
$logDir = "C:\OpenClaw\Logs"

# 验证核心文件
if (-not (Test-Path $nodeExe)) { Write-Host "❌ Node.js 未找到"; exit 1 }
if (-not (Test-Path $scriptPath)) { Write-Host "❌ OpenClaw 脚本未找到"; exit 1 }

# 创建日志目录
if (-not (Test-Path $logDir)) { New-Item -ItemType Directory -Path $logDir -Force | Out-Null }

# ================= 1. 下载并准备 NSSM =================
if (-not (Test-Path $nssmExe)) {
    Write-Host "📥 正在下载 NSSM..." -ForegroundColor Gray
    try {
        Invoke-WebRequest -Uri $nssmUrl -OutFile $nssmZip -UseBasicParsing
        Expand-Archive -Path $nssmZip -DestinationPath $nssmDir -Force
        Write-Host "✅ NSSM 下载完成" -ForegroundColor Green
    } catch {
        Write-Host "❌ 下载 NSSM 失败，请检查网络或手动下载放在 $nssmDir" -ForegroundColor Red
        exit 1
    }
} else {
    Write-Host "✅ NSSM 已存在" -ForegroundColor Green
}

# ================= 2. 移除旧服务 (如果有) =================
& $nssmExe remove $serviceName confirm | Out-Null
Start-Sleep -Seconds 1

# ================= 3. 安装新服务 =================
Write-Host "🛠 正在安装服务 $serviceName ..." -ForegroundColor Cyan

# 基础安装：应用程序路径
& $nssmExe install $serviceName $nodeExe "`"$scriptPath`" gateway --port 18789"

# 设置工作目录 (关键：让 openclaw 能找到相对路径配置)
& $nssmExe set $serviceName AppDirectory "$userProfilePath"

# 设置环境变量 (关键：欺骗 openclaw 认为它是当前用户运行的)
# NSSM 支持设置自定义环境变量
& $nssmExe set $serviceName AppEnvironmentExtra "USERPROFILE=$userProfilePath`0HOMEDRIVE=C:`0HOMEPATH=\Users\$realUser`0OPENCLAW_GATEWAY_PORT=18789"

# 设置日志输出 (可选，方便调试)
& $nssmExe set $serviceName AppStdout "$logDir\openclaw-out.log"
& $nssmExe set $serviceName AppStderr "$logDir\openclaw-err.log"
& $nssmExe set $serviceName AppRotateFiles 1
& $nssmExe set $serviceName AppRotateOnline 1

# 设置描述
& $nssmExe set $serviceName Description $serviceDesc

# ================= 4. 配置自动重启策略 =================
# 如果服务停止，等待 1 秒后重启
& $nssmExe set $serviceName AppExit Default Restart
& $nssmExe set $serviceName AppRestartDelay 1000

# ================= 5. 启动服务 =================
Write-Host "🚀 正在启动服务..." -ForegroundColor Cyan
Start-Service -Name $serviceName

# 等待几秒让服务初始化
Start-Sleep -Seconds 5

# ================= 6. 验证状态 =================
Write-Host "`n🔍 检查结果:" -ForegroundColor Cyan

$svcStatus = Get-Service -Name $serviceName -ErrorAction SilentlyContinue
if ($svcStatus) {
    Write-Host "✅ 服务状态：$($svcStatus.Status)" -ForegroundColor Green
    
    if ($svcStatus.Status -eq 'Running') {
        Write-Host "🎉 服务运行正常！" -ForegroundColor Green
        
        # 尝试调用 openclaw 状态检查
        Write-Host "`n📊 OpenClaw 内部状态:" -ForegroundColor Cyan
        & openclaw gateway status
    } else {
        Write-Host "⚠️ 服务已安装但未运行，请查看事件查看器或日志。" -ForegroundColor Yellow
        Write-Host "📄 错误日志：$logDir\openclaw-err.log"
        if (Test-Path "$logDir\openclaw-err.log") {
            Get-Content "$logDir\openclaw-err.log" -Tail 10
        }
    }
} else {
    Write-Host "❌ 服务安装失败。" -ForegroundColor Red
}

Write-Host "`n💡 管理命令:" -ForegroundColor Gray
Write-Host "   停止：Stop-Service -Name '$serviceName'"
Write-Host "   启动：Start-Service -Name '$serviceName'"
Write-Host "   卸载：& '$nssmExe' remove '$serviceName' confirm"

Read-Host "按回车退出"

· 保存txt文件后，将后缀名由 .txt修改为 .ps1

· 若看不到后缀名，可开启“文件扩展名显示”

· 右键文件，选择“使用PowerShell运行”，执行完成后即可实现开机自启动。上述代码也可直接在PowerShell 中执行。