fix(setup): parse WSL version independent of locale

Parse the WSL package version from the stable WSL product-token line instead of matching localized label text. Add regression coverage for the localized MessagePackageVersions labels currently published by microsoft/WSL, plus NUL-stripped UTF-16 output and adjacent component-version guard cases.

Addresses #661, but the issue should remain open until this is included in a release and verified there. Runtime verification on Chinese-localized Windows: #661 (comment)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: github-actions[bot]

src/OpenClaw.SetupEngine/SetupSteps.cs

@@ -37,6 +37,12 @@ public static string SafeWindowsWorkingDirectory
 internal static class WslInstallSupport
 {
     private static readonly Version s_minDirectNamedInstallVersion = new(2, 4, 4);
+    private static readonly System.Text.RegularExpressions.Regex s_wslProductTokenRegex = new(
+        @"(?<![A-Za-z0-9])WSL(?![A-Za-z0-9])",
+        System.Text.RegularExpressions.RegexOptions.IgnoreCase | System.Text.RegularExpressions.RegexOptions.CultureInvariant);
+    private static readonly System.Text.RegularExpressions.Regex s_semanticVersionRegex = new(
+        @"(?<![\d.])(\d+)\.(\d+)\.(\d+)(?:\.(\d+))?(?![\d.])",
+        System.Text.RegularExpressions.RegexOptions.CultureInvariant);
     public const string UpdateUrl = "https://aka.ms/wslstorepage";
 
     public static string UpdateInstructions
@@ -54,27 +60,38 @@ public static bool ContainsDistro(string output, string distroName)
 
     public static bool TryParseWslVersion(string output, out Version version)
     {
-        var match = System.Text.RegularExpressions.Regex.Match(
-            Normalize(output),
-            @"WSL\s+version:\s*(\d+)\.(\d+)\.(\d+)(?:\.(\d+))?",
-            System.Text.RegularExpressions.RegexOptions.IgnoreCase);
-
-        if (!match.Success)
+        // Match the product token and version shape instead of localized label text.
+        // WSL is the stable product acronym; labels around it vary by Windows language
+        // and by UTF-16LE/NUL-stripped output shape.
+        foreach (var rawLine in Normalize(output).Split(['\r', '\n'], StringSplitOptions.RemoveEmptyEntries))
         {
-            version = new Version();
-            return false;
+            var line = rawLine.Trim();
+            if (!s_wslProductTokenRegex.IsMatch(line))
+                continue;
+
+            var match = s_semanticVersionRegex.Match(line);
+            if (!match.Success)
+                continue;
+
+            version = ParseVersionMatch(match);
+            return true;
         }
 
+        version = new Version();
+        return false;
+    }
+
+    private static Version ParseVersionMatch(System.Text.RegularExpressions.Match match)
+    {
         var major = int.Parse(match.Groups[1].Value, System.Globalization.CultureInfo.InvariantCulture);
         var minor = int.Parse(match.Groups[2].Value, System.Globalization.CultureInfo.InvariantCulture);
         var build = int.Parse(match.Groups[3].Value, System.Globalization.CultureInfo.InvariantCulture);
         var revision = match.Groups[4].Success
             ? int.Parse(match.Groups[4].Value, System.Globalization.CultureInfo.InvariantCulture)
             : -1;
-        version = revision >= 0
+        return revision >= 0
             ? new Version(major, minor, build, revision)
             : new Version(major, minor, build);
-        return true;
     }
 
     public static bool SupportsDirectNamedInstall(Version version)

tests/OpenClaw.SetupEngine.Tests/SetupStepsTests.cs

@@ -496,6 +496,7 @@ public async Task CreateWslInstance_RemovesStaleFileAtInstallPathBeforeInstallin
     public void WslInstallSupport_ParsesVersionAndVerboseDistroList()
     {
         Assert.True(WslInstallSupport.TryParseWslVersion("WSL version: 2.7.3.0", out var version));
+        Assert.Equal(new Version(2, 7, 3, 0), version);
         Assert.True(WslInstallSupport.SupportsDirectNamedInstall(version));
 
         Assert.True(WslInstallSupport.TryGetDistroVersion(
@@ -505,6 +506,93 @@ public void WslInstallSupport_ParsesVersionAndVerboseDistroList()
         Assert.Equal(2, distroVersion);
     }
 
+    // Regression: wsl.exe emits UTF-16LE on some Windows builds, and localized
+    // Windows changes the human-readable label around the stable WSL product token.
+    [Theory]
+    [InlineData("WSL version: 2.7.3.0", "2.7.3.0")]                       // English
+    [InlineData("WSL-Version: 2.7.7.0", "2.7.7.0")]                       // German / NUL-stripped UTF-16
+    [InlineData("WSL-Version: 2.7.7.0\nKernelversion: 6.18.26.1-1\nWSLg-Version: 1.0.73.2\nWindows-Version: 10.0.26300.8553", "2.7.7.0")]
+    [InlineData("Versión de WSL: 2.7.3.0", "2.7.3.0")]                    // Spanish
+    [InlineData("Versión de WSL: 2.7.3.0\nKernel: 5.15.0.1", "2.7.3.0")]  // Spanish with trailing lines
+    [InlineData("WSL バージョン: 2.7.8.0", "2.7.8.0")]                    // Japanese-style label
+    [InlineData("WSL版本: 2.7.9.0", "2.7.9.0")]                          // No separator after WSL
+    public void WslInstallSupport_TryParseWslVersion_HandlesLocalizedAndHyphenatedLabels(string output, string expectedVersion)
+    {
+        Assert.True(WslInstallSupport.TryParseWslVersion(output, out var version),
+            $"Expected TryParseWslVersion to succeed for: {output}");
+        Assert.Equal(Version.Parse(expectedVersion), version);
+        Assert.True(WslInstallSupport.SupportsDirectNamedInstall(version),
+            $"Expected parsed version {version} to satisfy minimum install requirement");
+    }
+
+    // Mirrors microsoft/WSL localization/strings/*/Resources.resw MessagePackageVersions.
+    [Theory]
+    [InlineData("cs-CZ", "Verze WSL: 2.7.3.0")]
+    [InlineData("da-DK", "WSL-version: 2.7.3.0")]
+    [InlineData("de-DE", "WSL-Version: 2.7.3.0")]
+    [InlineData("en-GB", "WSL version: 2.7.3.0")]
+    [InlineData("en-US", "WSL version: 2.7.3.0")]
+    [InlineData("es-ES", "Versión de WSL: 2.7.3.0")]
+    [InlineData("fi-FI", "WSL-versio: 2.7.3.0")]
+    [InlineData("fr-FR", "Version WSL : 2.7.3.0")]
+    [InlineData("hu-HU", "WSL-verzió: 2.7.3.0")]
+    [InlineData("it-IT", "Versione WSL: 2.7.3.0")]
+    [InlineData("ja-JP", "WSL バージョン: 2.7.3.0")]
+    [InlineData("ko-KR", "WSL 버전: 2.7.3.0")]
+    [InlineData("nb-NO", "WSL-versjon: 2.7.3.0")]
+    [InlineData("nl-NL", "WSL-versie: 2.7.3.0")]
+    [InlineData("pl-PL", "Wersja podsystemu WSL: 2.7.3.0")]
+    [InlineData("pt-BR", "Versão do WSL: 2.7.3.0")]
+    [InlineData("pt-PT", "Versão WSL: 2.7.3.0")]
+    [InlineData("ru-RU", "Версия WSL: 2.7.3.0")]
+    [InlineData("sv-SE", "WSL-version: 2.7.3.0")]
+    [InlineData("tr-TR", "WSL sürümü: 2.7.3.0")]
+    [InlineData("zh-CN", "WSL 版本: 2.7.3.0")]
+    [InlineData("zh-TW", "WSL 版本： 2.7.3.0")]
+    public void WslInstallSupport_TryParseWslVersion_HandlesMicrosoftLocalizedPackageVersionLabels(
+        string locale,
+        string output)
+    {
+        Assert.True(WslInstallSupport.TryParseWslVersion(output, out var version),
+            $"Expected TryParseWslVersion to succeed for {locale}: {output}");
+        Assert.Equal(new Version(2, 7, 3, 0), version);
+    }
+
+    [Theory]
+    [InlineData("WSL-Version: 2.7.7.0", "2.7.7.0")]
+    [InlineData("Versión de WSL: 2.7.3.0", "2.7.3.0")]
+    public void WslInstallSupport_TryParseWslVersion_NulStrippedUtf16_ParsesCorrectVersion(string raw, string expectedVersion)
+    {
+        // Simulate UTF-16LE NUL-byte injection then NUL-stripping.
+        var utf16Encoded = string.Join("\0", raw.ToCharArray()) + "\0";
+        var stripped = utf16Encoded.Replace("\0", "");
+        Assert.True(WslInstallSupport.TryParseWslVersion(stripped, out var version),
+            $"Expected TryParseWslVersion to succeed for NUL-stripped: {raw}");
+        Assert.Equal(Version.Parse(expectedVersion), version);
+    }
+
+    [Fact]
+    public void WslInstallSupport_TryParseWslVersion_IgnoresAdjacentWslAndWindowsVersionLines()
+    {
+        var output = "WSLg-Version: 1.0.73.2\n"
+            + "Windows-Version: 10.0.26300.8553\n"
+            + "Kernelversion: 6.18.26.1-1\n"
+            + "WSL-Version: 2.7.7.0\n";
+
+        Assert.True(WslInstallSupport.TryParseWslVersion(output, out var version));
+        Assert.Equal(new Version(2, 7, 7, 0), version);
+    }
+
+    [Fact]
+    public void WslInstallSupport_TryParseWslVersion_FailsWhenOnlyAdjacentComponentVersionsArePresent()
+    {
+        var output = "WSLg-Version: 1.0.73.2\n"
+            + "Windows-Version: 10.0.26300.8553\n"
+            + "Kernelversion: 6.18.26.1-1\n";
+
+        Assert.False(WslInstallSupport.TryParseWslVersion(output, out _));
+    }
+
     [Fact]
     public void WslInstallSupport_TryGetEnvironmentIssue_DetectsFirmwareVirtualizationOff()
     {