为什么要在 Server 2019 上进行测试 #

我们公司内部运行着一台 Windows Server 2019 环境，希望能用 OpenClaw 直接控制该服务器。 如果使用 WSL2，Linux 环境会被隔离，对 Windows 文件系统、进程、注册表的访问都要经过 WSL 边界中转。 如果采用原生 Windows 安装，OpenClaw 可以直接调用 Windows API，这对服务器运维场景来说更为合理。

环境配置 #

确认 WSL2 不可用的过程 #

一开始，我们按照官方文档尝试执行 wsl --install。但从一开始就遇到了问题。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

经过调查，根本原因已经明确：Windows Server 2019 与 WSL2 不兼容，微软已决定不会为其回溯适配。 WSL2 仅在 Windows Server 2022 及更高版本上可用。

坑点清单 #

完整安装步骤 #

1. 安装 Git for Windows

   curl.exe -L -o git.exe "https://github.com/git-for-windows/git/releases/download/v2.47.1.windows.1/Git-2.47.1-64-bit.exe"
   .\git.exe /VERYSILENT /NORESTART
   Start-Sleep -Seconds 30

   关闭并重新打开 PowerShell。
2. 手动安装 Node.js 22 LTS

   curl.exe -L -o nodejs.msi "https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi"
   msiexec /i nodejs.msi /quiet /norestart
   Start-Sleep -Seconds 30

   关闭并重新打开 PowerShell，用 node --version 进行验证。
3. 启用脚本执行并设置 pnpm

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
   npm install -g pnpm
   pnpm setup

   关闭并重新打开 PowerShell。
4. 使用 pnpm 安装 OpenClaw

   pnpm add -g openclaw@2026.4.5

5. 批准构建脚本并重新安装

   pnpm approve-builds -g
   # Select all (space to select all) → Enter → y
   pnpm add -g openclaw@2026.4.5

   OpenClaw 的构建大约需要 2 分钟。
6. 将 PATH 持久化到 Machine 级别

   $paths = @(
     'C:\Program Files\nodejs',
     "$env:APPDATA\npm",
     "$env:LOCALAPPDATA\pnpm"
   )
   $current = [System.Environment]::GetEnvironmentVariable('PATH','Machine')
   $entries = ($current -split ';') + $paths | Select-Object -Unique
   [System.Environment]::SetEnvironmentVariable('PATH', ($entries -join ';'), 'Machine')
   $env:PATH = ($entries -join ';')

7. 初始化配置（Onboarding）

   $env:NODE_OPTIONS=""
   openclaw onboard

   在模型提供方处选择 Custom Provider，Base URL 填写 GPUStack 的 /v1 端点，兼容模式选择 OpenAI-compatible。
8. 手动修正 contextWindow

   $config = Get-Content "$env:USERPROFILE\.openclaw\openclaw.json" | ConvertFrom-Json
   $config.models.providers.'custom-10-255-253-205'.models[0].contextWindow = 32768
   $config.models.providers.'custom-10-255-253-205'.models[0].maxTokens = 8192
   $config | ConvertTo-Json -Depth 20 | Set-Content "$env:USERPROFILE\.openclaw\openclaw.json" -Encoding UTF8

   请根据您的环境调整 provider 名称。
9. 启动 Gateway 并验证运行状态

   $env:NODE_OPTIONS=""
   openclaw gateway run

   出现 [gateway] ready 后，打开另一个窗口执行 openclaw dashboard。

GPUStack 配置（vLLM 后端参数） #

为启用工具调用（function calling）功能，请在 GPUStack 管理控制台中为该模型的后端参数添加以下内容。

--max-model-len 32768
--generation-config vllm
--enable-auto-tool-choice
--tool-call-parser hermes

会话恢复步骤 #

反复出现上下文溢出可能导致主会话被识别为 heartbeat，从而无法正常对话。此时可删除 sessions 目录进行重置。

openclaw gateway stop
Remove-Item "$env:USERPROFILE\.openclaw\agents\main\sessions" -Recurse -Force
New-Item "$env:USERPROFILE\.openclaw\agents\main\sessions" -ItemType Directory
openclaw gateway run

创建的运维支持工具：OpenClaw PATH Manager #

为消除手动配置 PATH 的繁琐工作，我们创建了一个 PowerShell 脚本以及一个基于浏览器的诊断 UI 工具。

ocstart.ps1 的内容 #

param([switch]$Stop)

$env:NODE_OPTIONS=""

$paths = @(
  'C:\Program Files\nodejs',
  "$env:APPDATA\npm",
  "$env:LOCALAPPDATA\pnpm"
)
foreach ($p in $paths) {
  if (($env:PATH -split ';') -notcontains $p) { $env:PATH += ";$p" }
}

if ($Stop) {
  Write-Host "Stopping Gateway..."
  & openclaw gateway stop
  exit
}

Write-Host "OpenClaw PATH configured"
Write-Host "openclaw: $((Get-Command openclaw -EA SilentlyContinue).Source)"

$action = Read-Host "[1] Start Gateway  [2] Stop Gateway  [3] Dashboard  [4] TUI  [5] Status`n> "

switch ($action) {
  '1' { openclaw gateway run }
  '2' { openclaw gateway stop }
  '3' { openclaw dashboard }
  '4' { openclaw tui }
  '5' { openclaw gateway status; openclaw doctor }
  default { Write-Host "Cancelled" }
}

保存到桌面并创建快捷方式 #

# Save script to desktop
$script | Out-File "$env:USERPROFILE\Desktop\ocstart.ps1" -Encoding UTF8

# Create shortcut
$ws = New-Object -ComObject WScript.Shell
$sc = $ws.CreateShortcut("$env:USERPROFILE\Desktop\OpenClaw Launcher.lnk")
$sc.TargetPath = "powershell.exe"
$sc.Arguments = '-ExecutionPolicy Bypass -File "C:\Users\Administrator\Desktop\ocstart.ps1"'
$sc.WorkingDirectory = "$env:USERPROFILE\Desktop"
$sc.IconLocation = "powershell.exe,0"
$sc.Save()

运行验证清单 #

• 在浏览器中可以显示控制台（http://127.0.0.1:18789）
• 模型提供方连接显示Verification successful
• 在 main 会话中可以获得聊天回复
• GPUStack 日志中出现 POST /v1/chat/completions HTTP/1.1" 200 OK
• Gateway 已注册为计划任务，登录后自动启动
• 已配置好 SearXNG 搜索
• 会话界面的 TOKENS 显示为 xxxxx / 32768（而非 16000）

总结 #

将 OpenClaw 部署到不受支持的 Windows Server 2019 环境中充满挑战，原因在于多个已知 bug 以及该环境特有的限制。 本次工作中最重要的三点经验如下：

• 使用 pnpm 而非 npm：npm 2026.4.x 存在破坏依赖关系的严重 bug
• 每次都要检查 PATH 与 NODE_OPTIONS：打开新窗口时它们会消失，建议用 ocstart.ps1 实现自动化
• 在 GPUStack 的 vLLM 参数中添加 --enable-auto-tool-choice --tool-call-parser hermes：若不添加，工具调用会返回 400 错误