なぜ Server 2019 で試したのか #

社内に稼働中の Windows Server 2019 環境があり、OpenClaw でその Server を直接操作させたいというモチベーションがありました。 WSL2 経由だと Linux 環境に閉じてしまい、Windows のファイルシステム・プロセス・レジストリへのアクセスが WSL の壁越しになります。 ネイティブ Windows インストールなら OpenClaw が直接 Windows API を叩けるため、Server 操作用途には理にかなっています。

環境構成 #

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 に非対応であり、Microsoft はバックポートしないと決定しています。 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
   # すべて選択（スペースキーで全選択）→ 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. オンボーディング

   $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

   プロバイダー名は環境に合わせて変更してください。
9. Gateway 起動・動作確認

   $env:NODE_OPTIONS=""
   openclaw gateway run

   [gateway] ready が表示されたら別ウィンドウで openclaw dashboard を実行します。

GPUStack 側の設定（vLLM バックエンドパラメータ） #

tool use（関数呼び出し）を有効にするには、GPUStack の管理画面でモデルのバックエンドパラメータに以下を追加します。

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

セッション破損時のリセット手順 #

コンテキストオーバーフローを繰り返すと、main セッションが 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 "Gatewayを停止します..."
  & openclaw gateway stop
  exit
}

Write-Host "OpenClaw PATH設定済み"
Write-Host "openclaw: $((Get-Command openclaw -EA SilentlyContinue).Source)"

$action = Read-Host "[1] Gateway起動  [2] Gateway停止  [3] ダッシュボード  [4] TUI  [5] ステータス`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 "キャンセル" }
}

デスクトップへの保存とショートカット作成 #

# スクリプトをデスクトップに保存
$script | Out-File "$env:USERPROFILE\Desktop\ocstart.ps1" -Encoding UTF8

# ショートカットを作成
$ws = New-Object -ComObject WScript.Shell
$sc = $ws.CreateShortcut("$env:USERPROFILE\Desktop\OpenClaw起動.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 が Scheduled Task として登録されており、ログイン時に自動起動する
• SearXNG 検索が設定されている
• セッション画面の TOKENS 表示が xxxxx / 32768 になっている（16000 でなく）

まとめ #

Windows Server 2019 という非推奨環境への OpenClaw 導入は、 複数の既知バグと環境固有の制約が重なるため一筋縄ではいきませんでした。 今回の作業で最も重要だった知見をまとめると以下の3点です。

• npm ではなく pnpm を使う：2026.4.x では npm 経由だと依存関係が壊れる重大バグがある
• PATH と NODE_OPTIONS を毎回確認する：新しいウィンドウを開くたびに設定が消えるため ocstart.ps1 で自動化する
• GPUStack の vLLM パラメータに --enable-auto-tool-choice --tool-call-parser hermes を追加する：これがないと tool use が 400 エラーになる