हमने Server 2019 पर परीक्षण क्यों किया #

हमारे पास in-house चल रहा एक Windows Server 2019 environment था, और हम उस server को सीधे OpenClaw से नियंत्रित करना चाहते थे। WSL2 के साथ Linux environment अलग-थलग हो जाता है, और Windows file systems, processes और registry तक पहुँच WSL boundary के माध्यम से होने लगती है। native Windows इंस्टॉलेशन के साथ OpenClaw सीधे Windows APIs को call कर सकता है, जो server संचालन के use cases के लिए तर्कसंगत है।

Environment कॉन्फ़िगरेशन #

WSL2 उपलब्ध न होने की पुष्टि तक का सफ़र #

शुरुआत में हमने आधिकारिक documentation का पालन करते हुए 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 के साथ असंगत है, और Microsoft ने इसे backport न करने का निर्णय लिया है। WSL2 केवल Windows Server 2022 और उसके बाद के versions पर उपलब्ध है।

Pitfalls की सूची #

संपूर्ण इंस्टॉलेशन प्रक्रिया #

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 से verify करें।
3. script execution enable करें और 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. build scripts approve करें और reinstall करें

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

   OpenClaw के build में लगभग 2 मिनट लगते हैं।
6. PATH को Machine level पर persist करें

   $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

   model provider के लिए Custom Provider, Base URL के रूप में GPUStack का /v1 endpoint, और compatibility के लिए 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 का नाम अपने environment के अनुसार adjust करें।
9. Gateway launch करें और संचालन verify करें

   $env:NODE_OPTIONS=""
   openclaw gateway run

   जैसे ही [gateway] ready दिखे, दूसरी window खोलकर openclaw dashboard चलाएँ।

GPUStack कॉन्फ़िगरेशन (vLLM Backend Parameters) #

tool use (function calling) को enable करने के लिए, GPUStack management dashboard में model के backend parameters में निम्नलिखित जोड़ें।

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

Session Recovery प्रक्रिया #

बार-बार context overflow होने से main session heartbeat के रूप में पहचाना जा सकता है, जिससे सामान्य conversation रुक जाती है। reset करने के लिए sessions directory delete करें।

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

बनाया गया Operations Support Tool: OpenClaw PATH Manager #

मैन्युअल PATH कॉन्फ़िगरेशन के overhead को खत्म करने के लिए हमने एक PowerShell script और एक browser-आधारित diagnostic UI tool बनाया।

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" }
}

Desktop पर save करें और Shortcut बनाएँ #

# 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()

संचालन सत्यापन Checklist #

• browser में dashboard प्रदर्शित होता है (http://127.0.0.1:18789)
• model provider connection Verification successful दिखाता है
• chat से main session में जवाब मिलते हैं
• GPUStack logs में POST /v1/chat/completions HTTP/1.1" 200 OK दिखता है
• Gateway Scheduled Task के रूप में registered है और login पर auto-start होता है
• SearXNG search कॉन्फ़िगर है
• session screen का TOKENS display xxxxx / 32768 दिखाता है (16000 नहीं)

सारांश #

गैर-समर्थित Windows Server 2019 environment में OpenClaw deploy करना कई known bugs और environment-विशिष्ट बाधाओं के कारण चुनौतीपूर्ण साबित हुआ। इस काम से मिली तीन सबसे महत्वपूर्ण सीखें ये हैं:

• npm के बजाय pnpm का उपयोग करें: npm 2026.4.x में dependencies तोड़ने वाला एक critical bug है
• हर बार PATH और NODE_OPTIONS जाँचें: नई windows खोलने पर ये गायब हो जाते हैं; ocstart.ps1 से automate करें
• GPUStack vLLM parameters में --enable-auto-tool-choice --tool-call-parser hermes जोड़ें: इनके बिना tool use 400 error लौटाता है