From 2f488b7e7a77b32441f1e039b0018526adb25af5 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 27 Apr 2026 20:26:49 +0100
Subject: [PATCH] docs: clarify ClawHub plugin discovery

---
 docs/tools/clawhub.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/tools/clawhub.md b/docs/tools/clawhub.md
index 941d379788f..a3aa6993565 100644
--- a/docs/tools/clawhub.md
+++ b/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