हमने WSL2 की बजाय नेटिव रूट क्यों चुना #

Windows 11 पर WSL2 और Ubuntu सिर्फ एक wsl --install कमांड से इंस्टॉल हो जाते हैं,
इसलिए आम तौर पर WSL2 रूट कहीं ज्यादा आसान है।
फिर भी हमने नेटिव रूट चुना, क्योंकि हमारा लक्ष्य था Windows मशीन को ही ऑपरेट करना।

एनवायरनमेंट कॉन्फ़िगरेशन #

इंस्टॉलेशन स्टेप्स #

1. Git for Windows इंस्टॉल करें #

   npm डिपेंडेंसी रेजोल्यूशन के लिए Git जरूरी है। एडमिनिस्ट्रेटर PowerShell में चलाएं।

   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 बंद करके दोबारा खोलें, फिर git --version से वेरिफाई करें।

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 से वेरिफाई करें कि v22.x.x दिखे।

3. स्क्रिप्ट एग्जीक्यूशन पॉलिसी और pnpm सेटअप #

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

   PowerShell बंद करके दोबारा खोलें।

4. pnpm से OpenClaw इंस्टॉल करें #

   $env:NODE_OPTIONS=""
   pnpm add -g openclaw@2026.4.5

   डाउनलोड पूरा होने के बाद build script को अप्रूव करें।

   pnpm approve-builds -g
   # Select all with spacebar → Enter → y
   pnpm add -g openclaw@2026.4.5

   OpenClaw का बिल्ड होने में लगभग 2 मिनट लगते हैं।

5. PATH को Machine लेवल पर पर्सिस्ट करें #

   इससे हर बार नया PowerShell खोलने पर PATH गायब होने की समस्या नहीं रहती।

   $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 ';')
   Write-Host "openclaw:" (Get-Command openclaw -EA SilentlyContinue).Source

6. ऑनबोर्डिंग #

   $env:NODE_OPTIONS=""
   openclaw onboard

   विज़ार्ड में निम्न कॉन्फ़िगर करें:

   • Security Warning: Yes के साथ आगे बढ़ें
   • Setup mode: QuickStart
   • Config handling (अगर मौजूदा config डिटेक्ट हो): Reset से नए सिरे से शुरू करें
   • Model Provider: Custom Provider
   • Base URL: http://<GPUStack IP>/v1
   • API Key Delivery Method: Paste API key now
   • Endpoint Compatibility: OpenAI-compatible
   • Model ID: GPUStack पर चल रहे model का नाम
   • Channel: Skip for now
   • Skill Dependencies: Skip for now
   • Web Search: SearXNG Search → URL डालें
   • Hooks: सिर्फ session-memory इनेबल करें
   अगर “Config handling” स्क्रीन दिखे
   अगर किसी दूसरी मशीन पर बनाई गई या पिछले इंस्टॉलेशन की कॉन्फ़िगरेशन फाइलें डिटेक्ट होती हैं,
   तो ऑनबोर्डिंग की शुरुआत में Existing config detected → Config handling ऑप्शन दिखेगा।
   नए सिरे से शुरू कर रहे हों तो Reset चुनें।

7. contextWindow को मैन्युअली ठीक करें #

   ऑनबोर्डिंग पूरी होने के बाद OpenClaw कभी-कभी model की context length गलत डिटेक्ट कर लेता है।
   कॉन्फ़िगरेशन फाइल को सीधे एडिट करें (provider का नाम अपने एनवायरनमेंट के हिसाब से बदलें)।

   $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

8. Gateway शुरू करें और ऑपरेशन वेरिफाई करें #

   $env:NODE_OPTIONS=""
   openclaw gateway run

   जब लॉग में [gateway] ready दिखे, तो दूसरी विंडो में डैशबोर्ड खोलें।

   $env:NODE_OPTIONS=""
   openclaw dashboard

   अगर main सेशन में चैट हो पा रही है तो इंस्टॉलेशन पूरा है।

9. ocstart.ps1 को Desktop पर सेव करें #

   हर बार PATH और NODE_OPTIONS सेट करने की जरूरत खत्म करने के लिए एक शॉर्टकट बनाएं।

   $script = @'
   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) { openclaw gateway stop; exit }
   $action = Read-Host "[1] Start Gateway  [2] Stop  [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 }
   }
   '@
   $script | Out-File "$env:USERPROFILE\Desktop\ocstart.ps1" -Encoding UTF8
   
   $ws = New-Object -ComObject WScript.Shell
   $sc = $ws.CreateShortcut("$env:USERPROFILE\Desktop\OpenClaw Start.lnk")
   $sc.TargetPath = "powershell.exe"
   $sc.Arguments = "-ExecutionPolicy Bypass -File `"$env:USERPROFILE\Desktop\ocstart.ps1`""
   $sc.Save()
   Write-Host "Complete"

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

GPUStack एडमिन पैनल में model के backend parameters में निम्न जोड़ें और model को रीस्टार्ट करें।

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

Server 2019 से तुलना #

ऑपरेशन वेरिफिकेशन चेकलिस्ट #

• openclaw --version आउटपुट दिखाता है
• लॉग में [gateway] ready दिखता है
• डैशबोर्ड (http://127.0.0.1:18789) ब्राउज़र में खुलता है
• main सेशन में चैट का जवाब आता है
• GPUStack लॉग में POST /v1/chat/completions HTTP/1.1" 200 OK दिखता है
• सेशन स्क्रीन के TOKENS में xxxxx / 32768 दिखता है
• SearXNG सर्च काम करती है

सारांश #

Windows 11 पर नेटिव इंस्टॉलेशन में Server 2019 के लिए बनाई गई प्रोसीजर लगभग जस की तस दोबारा इस्तेमाल की जा सकती है।
pnpm इस्तेमाल करें, PATH पर्सिस्ट करें, और NODE_OPTIONS क्लियर करें — ये तीन सिद्धांत Windows 11 पर भी वैसे ही लागू रहते हैं।

Server 2019 से एक अहम फर्क यह है कि Windows 11 पर WSL2 एक विकल्प के तौर पर मौजूद है,
जिससे आप अपने यूज-केस के हिसाब से रूट चुन सकते हैं।
अगर Windows को ही ऑपरेट करना है तो नेटिव चुनें,
और सामान्य AI एजेंट उपयोग के लिए WSL2 — अपने लक्ष्य के हिसाब से तय करें।