diff --git a/docs/cli/hooks.md b/docs/cli/hooks.md
index b6b1af0a6ef..e227ca7f868 100644
--- a/docs/cli/hooks.md
+++ b/docs/cli/hooks.md
@@ -198,6 +198,7 @@ openclaw hooks disable command-logger
 
 ```bash
 openclaw plugins install <package>        # ClawHub first, then npm
+openclaw plugins install npm:<package>    # npm only
 openclaw plugins install <package> --pin  # pin version
 openclaw plugins install <path>           # local path
 ```
diff --git a/docs/tools/clawhub.md b/docs/tools/clawhub.md
index 448f2f99f50..941d379788f 100644
--- a/docs/tools/clawhub.md
+++ b/docs/tools/clawhub.md
@@ -70,6 +70,13 @@ Site: [clawhub.ai](https://clawhub.ai)
     openclaw plugins install openclaw-codex-app-server
     ```
 
+    Use `npm:<package>` when you want npm-only resolution without a
+    ClawHub lookup:
+
+    ```bash
+    openclaw plugins install npm:openclaw-codex-app-server
+    ```
+
     Plugin installs validate advertised `pluginApi` and
     `minGatewayVersion` compatibility before archive install runs, so
     incompatible hosts fail closed early instead of partially installing