@colinlu50/openclaw-lark-stream 2026.3.28 → 2026.3.30

package/README.en.md

@@ -2,6 +2,8 @@ English | [中文](./README.md)
 
 # OpenClaw Lark/Feishu Plugin — Stream Card Fork
 
+![demo](./demo.gif)
+
 Fork of the official [openclaw-larksuite](https://github.com/larksuite/openclaw-larksuite) plugin with **streaming block output** and **tool call indicators**.
 
 ## What's Changed

package/README.md

@@ -2,27 +2,32 @@
 
 # OpenClaw 飞书插件 — 流式卡片 Fork
 
+![demo](./demo.gif)
+
 基于官方 [openclaw-larksuite](https://github.com/larksuite/openclaw-larksuite) 插件的 Fork，支持**流式分块输出**和**工具调用状态展示**。
 
-## 改动说明
+## ✨ 改动说明
 
 官方插件在 LLM 生成完一个 block 后才一次性推送结果。本 Fork 实现了：
 
-- **实时流式追加** — 每个 block 的内容在生成过程中逐步追加到流式卡片
+- **实时流式输出** — 每个 block 的内容在生成过程中逐步追加到流式卡片
 - **工具调用状态** — agent 调用工具时，卡片顶部实时显示当前工具，完成后自动折叠为摘要面板
 
-## 安装
+## 📢 News
 
-需要 [OpenClaw](https://openclaw.ai)（>= 2026.2.26）和 Node.js（>= v22）。
+- **2026.3.23** — 发布第一版，支持实时流式输出和工具调用状态展示
 
-```bash
-openclaw plugins install @colinlu50/openclaw-lark-stream
-```
+## 📦 安装
 
-安装完成后重启网关：
+需要 [OpenClaw](https://openclaw.ai)（>= 2026.2.26）和 Node.js（>= v22）。
+
+> 查看 OpenClaw 版本：`openclaw -v`，如版本过低请先升级：
+> ```bash
+> npm install -g openclaw
+> ```
 
 ```bash
-openclaw gateway restart
+npx -y @colinlu50/openclaw-lark-stream install
 ```
 
 > 如果之前安装过官方插件，先卸载：
@@ -39,7 +44,7 @@ cd openclaw-lark-stream && npm install && npm run build
 openclaw gateway restart
 ```
 
-## 配置
+## ⚙️ 配置
 
 卡片底栏默认显示耗时和完成状态，如需关闭：
 
@@ -51,6 +56,6 @@ openclaw config set channels.feishu.footer.status false   # 隐藏完成状态
 - **elapsed** — 卡片底栏显示总响应耗时（如 `耗时 3.2s`）
 - **status** — 卡片底栏显示完成状态（`已完成` / `出错` / `已停止`）
 
-## 许可证
+## 📄 许可证
 
 MIT — 与上游项目相同。

package/bin/openclaw-lark.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { execFileSync, execSync } from "node:child_process";
+import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 
 const SELF_PACKAGE = "@colinlu50/openclaw-lark-stream";
@@ -16,39 +16,34 @@ const args = process.argv.slice(2);
 const subcommand = args[0];
 
 // ── install / update ──
-// 1) Let @larksuite/openclaw-lark-tools run the full interactive setup
-//    (version check, bot config, gateway restart, etc.)
-// 2) Then swap the installed official code with our fork
+// 1) Clean existing plugin state so tools gets a fresh environment
+// 2) Let @larksuite/openclaw-lark-tools run the interactive setup (bot config)
+// 3) Clean again (tools installs official code), then install our fork
 if (subcommand === "install" || subcommand === "update") {
-  // Step 1: Run tools for interactive setup (installs official + configures bot)
-  // Don't exit on error — config is already saved, we still need to swap the code.
+  // Step 1: Clean existing state so tools doesn't choke on stale plugins
+  cleanPluginState();
+
+  // Step 2: Run tools for interactive setup (bot config, version check, etc.)
   const toolsArgs = args.slice();
   try {
     runTools(toolsArgs);
   } catch {
-    // Tools may fail on gateway restart etc. — that's OK, config is preserved.
+    // Tools may fail on gateway restart / interactive prompt — that's OK,
+    // bot config is already saved to openclaw.json at this point.
   }
 
-  // Step 2: Clean up old plugin dirs + config references, then install ours
+  // Step 3: Clean official plugin + any staging leftovers, install ours
+  cleanPluginState();
   try {
-    for (const dir of [OFFICIAL_DIR, SELF_DIR]) {
-      if (existsSync(dir)) {
-        console.log(`\nRemoving ${dir}...`);
-        rmSync(dir, { recursive: true, force: true });
-      }
-    }
-    // Remove stale "openclaw-lark" references from config so openclaw doesn't
-    // fail validation when the directory is gone.
-    cleanConfigReferences("openclaw-lark");
-
     console.log(`\nInstalling ${SELF_PACKAGE}...`);
-    execFileSync("openclaw", ["plugins", "install", SELF_PACKAGE], {
+    execSync(`openclaw plugins install ${SELF_PACKAGE}`, {
       stdio: "inherit",
     });
     console.log(`\n✅ ${SELF_PACKAGE} installed successfully.`);
     console.log("Run: openclaw gateway restart");
   } catch (error) {
-    console.error(`\n❌ Failed to install ${SELF_PACKAGE}. The bot config is preserved.`);
+    console.error(`\n❌ Failed to install ${SELF_PACKAGE}.`);
+    console.error(error.message || error);
     console.error("You can retry with: openclaw plugins install " + SELF_PACKAGE);
     process.exit(error.status ?? 1);
   }
@@ -62,6 +57,39 @@ try {
   process.exit(error.status ?? 1);
 }
 
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Remove all plugin directories, staging leftovers, and stale config
+ * references so that openclaw has a clean state for the next install.
+ */
+function cleanPluginState() {
+  // Remove plugin directories
+  for (const dir of [OFFICIAL_DIR, SELF_DIR]) {
+    if (existsSync(dir)) {
+      console.log(`Removing ${dir}...`);
+      rmSync(dir, { recursive: true, force: true });
+    }
+  }
+  // Remove leftover staging directories (.openclaw-install-stage-*)
+  if (existsSync(EXTENSIONS_DIR)) {
+    try {
+      for (const entry of readdirSync(EXTENSIONS_DIR)) {
+        if (entry.startsWith(".openclaw-install-stage-")) {
+          const p = join(EXTENSIONS_DIR, entry);
+          console.log(`Removing staging dir ${p}...`);
+          rmSync(p, { recursive: true, force: true });
+        }
+      }
+    } catch { /* ignore readdir errors */ }
+  }
+  // Clean config references for both plugin IDs
+  cleanConfigReferences("openclaw-lark");
+  cleanConfigReferences("openclaw-lark-stream");
+}
+
 /**
  * Remove stale plugin references from openclaw.json so that
  * `openclaw plugins install` doesn't fail config validation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colinlu50/openclaw-lark-stream",
-  "version": "2026.3.28",
+  "version": "2026.3.30",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "main": "./dist/index.js",
   "type": "module",