diff --git a/docs/help/faq.md b/docs/help/faq.md
index dd24ff2b41..60b27eb04d 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -546,6 +546,15 @@ For a hackable (git) install:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
```
+Windows (PowerShell) equivalent:
+
+```powershell
+# install.ps1 has no dedicated -Verbose flag yet.
+Set-PSDebug -Trace 1
+& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
+Set-PSDebug -Trace 0
+```
+
More options: [Installer flags](/install/installer).
### Windows install says git not found or openclaw not recognized
diff --git a/docs/install/installer.md b/docs/install/installer.md
index 18d96329b0..331943d0a3 100644
--- a/docs/install/installer.md
+++ b/docs/install/installer.md
@@ -286,6 +286,14 @@ Designed for environments where you want everything under a local prefix (defaul
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun
```
+
+ ```powershell
+ # install.ps1 has no dedicated -Verbose flag yet.
+ Set-PSDebug -Trace 1
+ & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
+ Set-PSDebug -Trace 0
+ ```
+
@@ -379,6 +387,18 @@ Use non-interactive flags/env vars for predictable runs.
Run `npm config get prefix`, append `\bin`, add that directory to user PATH, then reopen PowerShell.
+
+ `install.ps1` does not currently expose a `-Verbose` switch.
+ Use PowerShell tracing for script-level diagnostics:
+
+ ```powershell
+ Set-PSDebug -Trace 1
+ & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
+ Set-PSDebug -Trace 0
+ ```
+
+
+
Usually a PATH issue. See [Node.js troubleshooting](/install/node#troubleshooting).