docs: redirect /install/node to install section

docs/docs.json

@@ -733,6 +733,14 @@
       "source": "/wizard",
       "destination": "/start/wizard"
     },
+    {
+      "source": "/install/node",
+      "destination": "/install#nodejs--npm-path-sanity"
+    },
+    {
+      "source": "/install/node/",
+      "destination": "/install#nodejs--npm-path-sanity"
+    },
     {
       "source": "/start/faq",
       "destination": "/help"
@@ -779,7 +787,6 @@
         "group": "Install & Updates",
         "pages": [
           "install/index",
-          "install/node",
           "install/installer",
           "install/updating",
           "install/uninstall",

docs/help/index.md

@@ -10,7 +10,7 @@ read_when:
 If you want a quick “get unstuck” flow, start here:
 
 - **Troubleshooting:** [Start here](/help/troubleshooting)
-- **Install sanity (Node/npm/PATH):** [Node.js + npm (PATH sanity)](/install/node)
+- **Install sanity (Node/npm/PATH):** [Install](/install#nodejs--npm-path-sanity)
 - **Gateway issues:** [Gateway troubleshooting](/gateway/troubleshooting)
 - **Logs:** [Logging](/logging) and [Gateway logging](/gateway/logging)
 - **Repairs:** [Doctor](/gateway/doctor)

docs/help/troubleshooting.md

@@ -31,7 +31,7 @@ clawdbot status --deep
 
 Almost always a Node/npm PATH issue. Start here:
 
-- [Node.js + npm (PATH sanity)](/install/node)
+- [Install (Node/npm PATH sanity)](/install#nodejs--npm-path-sanity)
 
 ### Gateway “unauthorized”, can’t connect, or keeps reconnecting
 

docs/install/index.md

@@ -9,7 +9,28 @@ read_when:
 
 Runtime baseline: **Node >=22**.
 
-If the installer says it succeeded but you later see `clawdbot: command not found`, it’s usually a Node/npm PATH issue. See: [Node.js + npm (PATH sanity)](/install/node).
+If the installer says it succeeded but you later see `clawdbot: command not found`, it’s usually a Node/npm PATH issue (global npm bin dir not on PATH). See the section below.
+
+## Node.js + npm (PATH sanity)
+
+Quick diagnosis:
+
+```bash
+node -v
+npm -v
+npm bin -g
+echo "$PATH"
+```
+
+If the output of `npm bin -g` is **not** present inside `echo "$PATH"`, your shell can’t find global npm binaries (including `clawdbot`).
+
+Fix: add it to your shell startup file (zsh: `~/.zshrc`, bash: `~/.bashrc`):
+
+```bash
+export PATH="/path/from/npm/bin/-g:$PATH"
+```
+
+Then open a new terminal (or `rehash` in zsh / `hash -r` in bash).
 
 ## Recommended (installer script)
 

docs/install/installer.md

@@ -19,7 +19,7 @@ To see the current flags/behavior, run:
 curl -fsSL https://clawd.bot/install.sh | bash -s -- --help
 ```
 
-If the installer completes but `clawdbot` is not found in a new terminal, it’s usually a Node/npm PATH issue. See: [Node.js + npm (PATH sanity)](/install/node).
+If the installer completes but `clawdbot` is not found in a new terminal, it’s usually a Node/npm PATH issue. See: [Install](/install#nodejs--npm-path-sanity).
 
 ## install.sh (recommended)