docs: clarify ClawHub plugin discovery

docs/tools/clawhub.md

@@ -207,8 +207,29 @@ publish/sync.
     clawhub search "query"
     ```
 
+    Searches skills. For plugin/package discovery, use `clawhub package explore`.
+
     - `--limit <n>` — max results.
 
+  </Accordion>
+  <Accordion title="Browse / inspect plugins">
+    ```bash
+    clawhub package explore --family code-plugin
+    clawhub package explore "episodic-claw" --family code-plugin
+    clawhub package inspect episodic-claw
+    ```
+
+    `package explore` and `package inspect` are the ClawHub CLI surfaces for plugin/package discovery and metadata inspection. Native OpenClaw installs still use `openclaw plugins install clawhub:<package>`.
+
+    Options:
+
+    - `--family skill|code-plugin|bundle-plugin` — filter package family.
+    - `--official` — show only official packages.
+    - `--executes-code` — show only packages that execute code.
+    - `--version <version>` / `--tag <tag>` — inspect a specific package version.
+    - `--versions`, `--files`, `--file <path>` — inspect package history and files.
+    - `--json` — machine-readable output.
+
   </Accordion>
   <Accordion title="Install / update / list">
     ```bash
@@ -286,6 +307,13 @@ publish/sync.
     clawhub search "postgres backups"
     ```
   </Tab>
+  <Tab title="Find a plugin">
+    ```bash
+    clawhub package explore --family code-plugin
+    clawhub package explore "memory" --family code-plugin
+    clawhub package inspect episodic-claw
+    ```
+  </Tab>
   <Tab title="Install">
     ```bash
     clawhub install my-skill-pack