From ef078fec70c0878459ba64129db945404f37c508 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 25 Jan 2026 05:48:18 +0000
Subject: [PATCH] docs: add Windows install troubleshooting

---
 docs/install/installer.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/install/installer.md b/docs/install/installer.md
index ec7ffff77..7cd485756 100644
--- a/docs/install/installer.md
+++ b/docs/install/installer.md
@@ -114,3 +114,9 @@ Git requirement:
 
 If you choose `-InstallMethod git` and Git is missing, the installer will print the
 Git for Windows link (`https://git-scm.com/download/win`) and exit.
+
+Common Windows issues:
+
+- **npm error spawn git / ENOENT**: install Git for Windows and reopen PowerShell, then rerun the installer.
+- **"clawdbot" is not recognized**: your npm global bin folder is not on PATH. Most systems use
+  `%AppData%\\npm`. You can also run `npm config get prefix` and add `\\bin` to PATH, then reopen PowerShell.