diff --git a/docs/channels/index.md b/docs/channels/index.md
index b198a8c71..f6b90ba3b 100644
--- a/docs/channels/index.md
+++ b/docs/channels/index.md
@@ -18,7 +18,7 @@ Text is supported everywhere; media and reactions vary by channel.
 - [Signal](/channels/signal) — signal-cli; privacy-focused.
 - [iMessage](/channels/imessage) — macOS only; native integration.
 - [Microsoft Teams](/channels/msteams) — Bot Framework; enterprise support.
-- [Zalo](/channels/zalo) — Zalo Bot API; Vietnam's popular messenger (plugin).
+- [Zalo](/channels/zalo) — Zalo Bot API; Vietnam's popular messenger (plugin, installed separately).
 - [WebChat](/web/webchat) — Gateway WebChat UI over WebSocket.
 
 ## Notes
diff --git a/docs/channels/zalo.md b/docs/channels/zalo.md
index 38839a117..80e89f6f6 100644
--- a/docs/channels/zalo.md
+++ b/docs/channels/zalo.md
@@ -7,6 +7,12 @@ read_when:
 
 Status: experimental. Direct messages only; groups coming soon per Zalo docs.
 
+## Plugin required
+Zalo ships as a plugin and is not bundled with the core install.
+- Install via CLI: `clawdbot plugins install @clawdbot/zalo`
+- Or select **Zalo** during onboarding and confirm the install prompt
+- Details: [Plugins](/plugin)
+
 ## Quick setup (beginner)
 1) Install the Zalo plugin:
    - From a source checkout: `clawdbot plugins install ./extensions/zalo`
diff --git a/docs/docs.json b/docs/docs.json
index f0168aa49..17df5cf75 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -197,6 +197,14 @@
       "source": "/providers/troubleshooting/",
       "destination": "/channels/troubleshooting"
     },
+    {
+      "source": "/providers/zalo",
+      "destination": "/channels/zalo"
+    },
+    {
+      "source": "/providers/zalo/",
+      "destination": "/channels/zalo"
+    },
     {
       "source": "/providers/whatsapp",
       "destination": "/channels/whatsapp"
@@ -854,6 +862,7 @@
           "channels/signal",
           "channels/imessage",
           "channels/msteams",
+          "channels/zalo",
           "broadcast-groups",
           "channels/troubleshooting",
           "channels/location"