From f8a22521bdc1c273a6f18c271d6a9a4f535915a1 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sun, 25 Jan 2026 02:30:09 +0000 Subject: [PATCH] docs: clarify WSL2 recommendation --- docs/platforms/windows.md | 3 ++- docs/start/getting-started.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/platforms/windows.md b/docs/platforms/windows.md index 30f8714e0..fa7d5d35b 100644 --- a/docs/platforms/windows.md +++ b/docs/platforms/windows.md @@ -7,7 +7,8 @@ read_when: # Windows (WSL2) Clawdbot on Windows is recommended **via WSL2** (Ubuntu recommended). The -CLI + Gateway run inside Linux, which keeps the runtime consistent. Native +CLI + Gateway run inside Linux, which keeps the runtime consistent and makes +tooling far more compatible (Node/Bun/pnpm, Linux binaries, skills). Native Windows installs are untested and more problematic. Native Windows companion apps are planned. diff --git a/docs/start/getting-started.md b/docs/start/getting-started.md index 449bb76e8..dd68b8f55 100644 --- a/docs/start/getting-started.md +++ b/docs/start/getting-started.md @@ -45,7 +45,7 @@ run on host, set an explicit per-agent override: See [Web tools](/tools/web). macOS: if you plan to build the apps, install Xcode / CLT. For the CLI + gateway only, Node is enough. -Windows: use **WSL2** (Ubuntu recommended). WSL2 is strongly recommended; native Windows is untested and more problematic. Install WSL2 first, then run the Linux steps inside WSL. See [Windows (WSL2)](/platforms/windows). +Windows: use **WSL2** (Ubuntu recommended). WSL2 is strongly recommended; native Windows is untested, more problematic, and has poorer tool compatibility. Install WSL2 first, then run the Linux steps inside WSL. See [Windows (WSL2)](/platforms/windows). ## 1) Install the CLI (recommended)