From 5292367324adc951cdce877623dfe88dda5da5ba Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Tue, 3 Feb 2026 23:24:32 -0800
Subject: [PATCH] docs: update Feishu plugin docs

---
 docs/channels/feishu.md     |  4 ++--
 docs/reference/RELEASING.md |  1 +
 extensions/feishu/README.md | 47 +++++++++++++++++++++++++++++++++++++
 3 files changed, 50 insertions(+), 2 deletions(-)
 create mode 100644 extensions/feishu/README.md

diff --git a/docs/channels/feishu.md b/docs/channels/feishu.md
index 33517547d9..e378afaba8 100644
--- a/docs/channels/feishu.md
+++ b/docs/channels/feishu.md
@@ -1,5 +1,5 @@
 ---
-summary: "Feishu bot support status, features, and configuration"
+summary: "Feishu bot overview, features, and configuration"
 read_when:
   - You want to connect a Feishu/Lark bot
   - You are configuring the Feishu channel
@@ -8,7 +8,7 @@ title: Feishu
 
 # Feishu bot
 
-Status: production-ready, supports bot DMs and group chats. Uses WebSocket long connection mode to receive events.
+Feishu (Lark) is a team chat platform used by companies for messaging and collaboration. This plugin connects OpenClaw to a Feishu/Lark bot using the platform’s WebSocket event subscription so messages can be received without exposing a public webhook URL.
 
 ---
 
diff --git a/docs/reference/RELEASING.md b/docs/reference/RELEASING.md
index 53ed5fb6fa..23670a1339 100644
--- a/docs/reference/RELEASING.md
+++ b/docs/reference/RELEASING.md
@@ -106,6 +106,7 @@ Current npm plugin list (update as needed):
 - @openclaw/bluebubbles
 - @openclaw/diagnostics-otel
 - @openclaw/discord
+- @openclaw/feishu
 - @openclaw/lobster
 - @openclaw/matrix
 - @openclaw/msteams
diff --git a/extensions/feishu/README.md b/extensions/feishu/README.md
new file mode 100644
index 0000000000..9bd0e5ce09
--- /dev/null
+++ b/extensions/feishu/README.md
@@ -0,0 +1,47 @@
+# @openclaw/feishu
+
+Feishu/Lark channel plugin for OpenClaw (WebSocket bot events).
+
+## Install (local checkout)
+
+```bash
+openclaw plugins install ./extensions/feishu
+```
+
+## Install (npm)
+
+```bash
+openclaw plugins install @openclaw/feishu
+```
+
+Onboarding: select Feishu/Lark and confirm the install prompt to fetch the plugin automatically.
+
+## Config
+
+```json5
+{
+  channels: {
+    feishu: {
+      accounts: {
+        default: {
+          appId: "cli_xxx",
+          appSecret: "xxx",
+          domain: "feishu",
+          enabled: true,
+        },
+      },
+      dmPolicy: "pairing",
+      groupPolicy: "open",
+      blockStreaming: true,
+    },
+  },
+}
+```
+
+Lark (global) tenants should set `domain: "lark"` (or a full https:// domain).
+
+Restart the gateway after config changes.
+
+## Docs
+
+https://docs.openclaw.ai/channels/feishu