From 066f5eb83dbf5ee3229affcfad2761554db5c3c8 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Wed, 26 Aug 2026 13:33:30 -0700
Subject: [PATCH] docs(plugins): register imap in generated plugin inventory
 (#130363)

The bundled imap plugin landed in #130230 without regenerating the plugin
inventory docs, so pnpm plugins:inventory:check failed on main and the plugin
was absent from the reference index. Regenerate, and register its operator
guide in PLUGIN_DOC_ALIASES so the generated reference page links to
/automation/imap (same mechanism codex and firecrawl use).
---
 docs/plugins/plugin-inventory.md          |  4 +++-
 docs/plugins/reference.md                 |  2 +-
 docs/plugins/reference/imap.md            | 23 +++++++++++++++++++++++
 scripts/generate-plugin-inventory-doc.mts |  1 +
 4 files changed, 28 insertions(+), 2 deletions(-)
 create mode 100644 docs/plugins/reference/imap.md

diff --git a/docs/plugins/plugin-inventory.md b/docs/plugins/plugin-inventory.md
index 81e612c1a726..54dec453358e 100644
--- a/docs/plugins/plugin-inventory.md
+++ b/docs/plugins/plugin-inventory.md
@@ -52,7 +52,7 @@ Each entry lists the package, distribution route, and description.
 
 ## Core npm package
 
-58 plugins
+59 plugins
 
 - **[a2a](/plugins/reference/a2a)** (`@openclaw/a2a`) - included in OpenClaw. A2A v1.0 Agent-to-Agent protocol channel plugin.
 
@@ -102,6 +102,8 @@ Each entry lists the package, distribution route, and description.
 
 - **[huggingface](/plugins/reference/huggingface)** (`@openclaw/huggingface-provider`) - included in OpenClaw. Adds Hugging Face model provider support to OpenClaw.
 
+- **[imap](/plugins/reference/imap)** (`@openclaw/imap`) - included in OpenClaw. Watch IMAP mailboxes and dispatch authenticated incoming email to isolated agent sessions.
+
 - **[linux-node](/plugins/reference/linux-node)** (`@openclaw/linux-node`) - included in OpenClaw. Desktop notifications, camera capture, and location for Linux node hosts.
 
 - **[litellm](/plugins/reference/litellm)** (`@openclaw/litellm-provider`) - included in OpenClaw. Adds LiteLLM model provider support to OpenClaw.
diff --git a/docs/plugins/reference.md b/docs/plugins/reference.md
index f1de05e51b50..cf03bc4e8eac 100644
--- a/docs/plugins/reference.md
+++ b/docs/plugins/reference.md
@@ -16,5 +16,5 @@ Regenerate it with:
 pnpm plugins:inventory:gen
 ```
 
-Use [Plugin inventory](/plugins/plugin-inventory) to browse all 149
+Use [Plugin inventory](/plugins/plugin-inventory) to browse all 150
 generated plugin reference pages by distribution, package, and description.
diff --git a/docs/plugins/reference/imap.md b/docs/plugins/reference/imap.md
new file mode 100644
index 000000000000..5a239b0a2948
--- /dev/null
+++ b/docs/plugins/reference/imap.md
@@ -0,0 +1,23 @@
+---
+summary: "Watch IMAP mailboxes and dispatch authenticated incoming email to isolated agent sessions."
+read_when:
+  - You are installing, configuring, or auditing the imap plugin
+title: "Imap plugin"
+---
+
+# Imap plugin
+
+Watch IMAP mailboxes and dispatch authenticated incoming email to isolated agent sessions.
+
+## Distribution
+
+- Package: `@openclaw/imap`
+- Install route: included in OpenClaw
+
+## Surface
+
+plugin
+
+## Related docs
+
+- [imap](/automation/imap)
diff --git a/scripts/generate-plugin-inventory-doc.mts b/scripts/generate-plugin-inventory-doc.mts
index b926d1dab070..c50d82a91a6b 100644
--- a/scripts/generate-plugin-inventory-doc.mts
+++ b/scripts/generate-plugin-inventory-doc.mts
@@ -33,6 +33,7 @@ const PLUGIN_DOC_ALIASES = new Map([
   ["duckduckgo", "/tools/duckduckgo-search"],
   ["exa", "/tools/exa-search"],
   ["firecrawl", "/tools/firecrawl"],
+  ["imap", "/automation/imap"],
   ["parallel", "/tools/parallel-search"],
   ["perplexity", "/tools/perplexity-search"],
   ["policy", "/cli/policy"],