docs: recommend WSL2 for Windows installs

2026-01-07 01:21:36 +01:00
parent 62112d9978
commit 0116184b1c
13 changed files with 123 additions and 31 deletions
--- a/src/commands/onboard.ts
+++ b/src/commands/onboard.ts
@@ -10,6 +10,15 @@ export async function onboardCommand(
  runtime: RuntimeEnv = defaultRuntime,
 ) {
  assertSupportedRuntime(runtime);
+  if (process.platform === "win32") {
+    runtime.log(
+      [
+        "Windows detected.",
+        "WSL2 is strongly recommended; native Windows is untested and more problematic.",
+        "Guide: https://docs.clawd.bot/windows",
+      ].join("\n"),
+    );
+  }

  if (opts.nonInteractive) {
    await runNonInteractiveOnboarding(opts, runtime);