fix(gateway): fall back to PowerShell when wmic is unavailable on Windows

Tao Li · claude · Tao Li · commit 9f4d01e6a561 · 2026-03-12T10:50:49.000+08:00
On modern Windows (11+), Microsoft has deprecated and removed wmic.exe. This causes resolveWindowsCommandLine() to silently fail, returning no command line for port listeners. The health check then only sees "node.exe" (the image name), which classifyPortListener() cannot identify as a gateway process — it requires "openclaw" in the command string. This results in ownsPort=false → healthy=false, and the restart health check loops for 60s before timing out, even though the gateway restarted successfully. Fix: when wmic fails (non-zero exit or no output), fall back to PowerShell Get-CimInstance Win32_Process to retrieve the full command line. This restores correct process classification on wmic-less systems. Related: #32620 (same class of bug on Linux when lsof is missing) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
diff --git a/src/infra/ports-inspect.ts b/src/infra/ports-inspect.ts
@@ -248,7 +248,24 @@ async function resolveWindowsImageName(pid: number): Promise<string | undefined>
   return undefined;
 }
 
+async function resolveWindowsCommandLineViaPowerShell(
+  pid: number,
+): Promise<string | undefined> {
+  const res = await runCommandSafe([
+    "powershell",
+    "-NoProfile",
+    "-Command",
+    `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`,
+  ]);
+  if (res.code !== 0) {
+    return undefined;
+  }
+  const value = res.stdout.trim();
+  return value || undefined;
+}
+
 async function resolveWindowsCommandLine(pid: number): Promise<string | undefined> {
+  // Try wmic first (fast, but deprecated/removed on modern Windows 11+).
   const res = await runCommandSafe([
     "wmic",
     "process",
@@ -258,18 +275,20 @@ async function resolveWindowsCommandLine(pid: number): Promise<string | undefine
     "CommandLine",
     "/value",
   ]);
-  if (res.code !== 0) {
-    return undefined;
-  }
-  for (const rawLine of res.stdout.split(/\r?\n/)) {
-    const line = rawLine.trim();
-    if (!line.toLowerCase().startsWith("commandline=")) {
-      continue;
+  if (res.code === 0) {
+    for (const rawLine of res.stdout.split(/\r?\n/)) {
+      const line = rawLine.trim();
+      if (!line.toLowerCase().startsWith("commandline=")) {
+        continue;
+      }
+      const value = line.slice("commandline=".length).trim();
+      if (value) {
+        return value;
+      }
     }
-    const value = line.slice("commandline=".length).trim();
-    return value || undefined;
   }
-  return undefined;
+  // Fallback to PowerShell Get-CimInstance when wmic is unavailable.
+  return resolveWindowsCommandLineViaPowerShell(pid);
 }
 
 async function readWindowsListeners(
