@memtensor/memos-local-openclaw-plugin 1.0.4-beta.7 → 1.0.4-beta.9

package/dist/viewer/server.js

@@ -91,6 +91,11 @@ class ViewerServer {
     ppAbort = false;
     ppState = { running: false, done: false, stopped: false, processed: 0, total: 0, tasksCreated: 0, skillsCreated: 0, errors: 0, skippedSessions: 0, totalSessions: 0 };
     ppSSEClients = [];
+    notifSSEClients = [];
+    notifPollTimer;
+    lastKnownNotifCount = 0;
+    hubHeartbeatTimer;
+    static HUB_HEARTBEAT_INTERVAL_MS = 45_000;
     constructor(opts) {
         this.store = opts.store;
         this.embedder = opts.embedder;
@@ -109,16 +114,17 @@ class ViewerServer {
             this.server.on("error", (err) => {
                 if (err.code === "EADDRINUSE") {
                     this.log.warn(`Viewer port ${this.port} in use, trying ${this.port + 1}`);
-                    this.server.listen(this.port + 1, "127.0.0.1");
+                    this.server.listen(this.port + 1, "0.0.0.0");
                 }
                 else {
                     reject(err);
                 }
             });
-            this.server.listen(this.port, "127.0.0.1", () => {
+            this.server.listen(this.port, "0.0.0.0", () => {
                 const addr = this.server.address();
                 const actualPort = typeof addr === "object" && addr ? addr.port : this.port;
                 this.autoCleanupPolluted();
+                this.startHubHeartbeat();
                 resolve(`http://127.0.0.1:${actualPort}`);
             });
         });
@@ -141,6 +147,15 @@ class ViewerServer {
         }
     }
     stop() {
+        this.stopHubHeartbeat();
+        this.stopNotifPoll();
+        for (const c of this.notifSSEClients) {
+            try {
+                c.end();
+            }
+            catch { }
+        }
+        this.notifSSEClients = [];
         this.server?.close();
         this.server = null;
     }
@@ -338,12 +353,18 @@ class ViewerServer {
                 this.handleSharingNotificationsRead(req, res);
             else if (p === "/api/sharing/notifications/clear" && req.method === "POST")
                 this.handleSharingNotificationsClear(req, res);
+            else if (p === "/api/notifications/stream" && req.method === "GET")
+                this.handleNotifSSE(req, res);
             else if (p === "/api/admin/shared-tasks" && req.method === "GET")
                 this.serveAdminSharedTasks(res);
+            else if (p.match(/^\/api\/admin\/shared-tasks\/[^/]+\/detail$/) && req.method === "GET")
+                this.serveHubTaskDetail(res, p);
             else if (p.match(/^\/api\/admin\/shared-tasks\/[^/]+$/) && req.method === "DELETE")
                 this.handleAdminDeleteTask(res, p);
             else if (p === "/api/admin/shared-skills" && req.method === "GET")
                 this.serveAdminSharedSkills(res);
+            else if (p.match(/^\/api\/admin\/shared-skills\/[^/]+\/detail$/) && req.method === "GET")
+                this.serveHubSkillDetail(res, p);
             else if (p.match(/^\/api\/admin\/shared-skills\/[^/]+$/) && req.method === "DELETE")
                 this.handleAdminDeleteSkill(res, p);
             else if (p === "/api/admin/shared-memories" && req.method === "GET")
@@ -521,7 +542,12 @@ class ViewerServer {
             conditions.push("role = ?");
             params.push(role);
         }
-        if (owner) {
+        if (owner && owner.startsWith("agent:")) {
+            const agentPrefix = owner + ":";
+            conditions.push("(owner = ? OR (owner = 'public' AND session_key LIKE ?))");
+            params.push(owner, agentPrefix + "%");
+        }
+        else if (owner) {
             conditions.push("owner = ?");
             params.push(owner);
         }
@@ -601,9 +627,10 @@ class ViewerServer {
     serveTasks(res, url) {
         this.store.recordViewerEvent("tasks_list");
         const status = url.searchParams.get("status") ?? undefined;
+        const owner = url.searchParams.get("owner") ?? undefined;
         const limit = Math.min(100, Math.max(1, Number(url.searchParams.get("limit")) || 50));
         const offset = Math.max(0, Number(url.searchParams.get("offset")) || 0);
-        const { tasks, total } = this.store.listTasks({ status, limit, offset });
+        const { tasks, total } = this.store.listTasks({ status, limit, offset, owner });
         const db = this.store.db;
         const items = tasks.map((t) => {
             const meta = db.prepare("SELECT skill_status, owner FROM tasks WHERE id = ?").get(t.id);
@@ -698,12 +725,22 @@ class ViewerServer {
                 embCount = db.prepare("SELECT COUNT(*) as count FROM embeddings").get().count;
             }
             catch { /* table may not exist */ }
-            const sessionQuery = ownerFilter
-                ? "SELECT session_key, COUNT(*) as count, MIN(created_at) as earliest, MAX(created_at) as latest FROM chunks WHERE owner = ? GROUP BY session_key ORDER BY latest DESC"
-                : "SELECT session_key, COUNT(*) as count, MIN(created_at) as earliest, MAX(created_at) as latest FROM chunks GROUP BY session_key ORDER BY latest DESC";
-            const sessionList = (ownerFilter
-                ? db.prepare(sessionQuery).all(ownerFilter)
-                : db.prepare(sessionQuery).all());
+            let sessionQuery;
+            let sessionParams;
+            if (ownerFilter && ownerFilter.startsWith("agent:")) {
+                const agentPrefix = ownerFilter + ":";
+                sessionQuery = "SELECT session_key, COUNT(*) as count, MIN(created_at) as earliest, MAX(created_at) as latest FROM chunks WHERE (owner = ? OR (owner = 'public' AND session_key LIKE ?)) GROUP BY session_key ORDER BY latest DESC";
+                sessionParams = [ownerFilter, agentPrefix + "%"];
+            }
+            else if (ownerFilter) {
+                sessionQuery = "SELECT session_key, COUNT(*) as count, MIN(created_at) as earliest, MAX(created_at) as latest FROM chunks WHERE owner = ? GROUP BY session_key ORDER BY latest DESC";
+                sessionParams = [ownerFilter];
+            }
+            else {
+                sessionQuery = "SELECT session_key, COUNT(*) as count, MIN(created_at) as earliest, MAX(created_at) as latest FROM chunks GROUP BY session_key ORDER BY latest DESC";
+                sessionParams = [];
+            }
+            const sessionList = db.prepare(sessionQuery).all(...sessionParams);
             let skillCount = 0;
             try {
                 skillCount = db.prepare("SELECT COUNT(*) as count FROM skills").get().count;
@@ -717,10 +754,17 @@ class ViewerServer {
             catch { /* column may not exist yet */ }
             let owners = [];
             try {
-                const ownerRows = db.prepare("SELECT DISTINCT owner FROM chunks WHERE owner IS NOT NULL ORDER BY owner").all();
+                const ownerRows = db.prepare("SELECT DISTINCT owner FROM chunks WHERE owner IS NOT NULL AND owner LIKE 'agent:%' ORDER BY owner").all();
                 owners = ownerRows.map((o) => o.owner);
             }
             catch { /* column may not exist yet */ }
+            let currentAgentOwner = "agent:main";
+            try {
+                const latest = db.prepare("SELECT owner FROM chunks WHERE owner IS NOT NULL AND owner LIKE 'agent:%' ORDER BY created_at DESC LIMIT 1").get();
+                if (latest?.owner)
+                    currentAgentOwner = latest.owner;
+            }
+            catch { /* best-effort */ }
             this.jsonResponse(res, {
                 totalMemories: total.count, totalSessions: sessions.count, totalEmbeddings: embCount,
                 totalSkills: skillCount,
@@ -729,6 +773,7 @@ class ViewerServer {
                 timeRange: { earliest: timeRange.earliest, latest: timeRange.latest },
                 sessions: sessionList,
                 owners,
+                currentAgentOwner,
             });
         }
         catch (e) {
@@ -1597,7 +1642,8 @@ class ViewerServer {
     // ─── Config API ───
     getOpenClawConfigPath() {
         const home = process.env.HOME || process.env.USERPROFILE || "";
-        return node_path_1.default.join(home, ".openclaw", "openclaw.json");
+        const ocHome = process.env.OPENCLAW_STATE_DIR || node_path_1.default.join(home, ".openclaw");
+        return node_path_1.default.join(ocHome, "openclaw.json");
     }
     getPluginEntryConfig(raw) {
         const entries = raw?.plugins?.entries ?? {};
@@ -1846,12 +1892,22 @@ class ViewerServer {
             }
             try {
                 const hubUrl = (0, hub_1.normalizeHubUrl)(hubAddress);
+                const localIPs = this.getLocalIPs();
+                localIPs.push("127.0.0.1", "localhost", "0.0.0.0");
+                try {
+                    const u = new URL(hubUrl);
+                    if (localIPs.includes(u.hostname)) {
+                        return this.jsonResponse(res, { ok: false, error: "cannot_join_self" });
+                    }
+                }
+                catch { }
                 const os = await Promise.resolve().then(() => __importStar(require("os")));
-                const username = os.userInfo().username || "user";
+                const nickname = sharing.client?.nickname;
+                const username = nickname || os.userInfo().username || "user";
                 const hostname = os.hostname() || "unknown";
                 const result = await (0, hub_1.hubRequestJson)(hubUrl, "", "/api/v1/hub/join", {
                     method: "POST",
-                    body: JSON.stringify({ teamToken, username, deviceName: hostname }),
+                    body: JSON.stringify({ teamToken, username, deviceName: hostname, reapply: true }),
                 });
                 this.store.setClientHubConnection({
                     hubUrl,
@@ -1873,7 +1929,14 @@ class ViewerServer {
             return this.jsonResponse(res, { memories: [], error: "sharing_unavailable" });
         try {
             const limit = Number(url.searchParams.get("limit") || 40);
-            const data = await (0, hub_1.hubListMemories)(this.store, this.ctx, { limit });
+            const hub = this.resolveHubConnection();
+            let data;
+            if (hub) {
+                data = await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, `/api/v1/hub/memories?limit=${limit}`);
+            }
+            else {
+                data = await (0, hub_1.hubListMemories)(this.store, this.ctx, { limit });
+            }
             this.jsonResponse(res, { memories: Array.isArray(data?.memories) ? data.memories : [] });
         }
         catch (err) {
@@ -1885,7 +1948,14 @@ class ViewerServer {
             return this.jsonResponse(res, { tasks: [], error: "sharing_unavailable" });
         try {
             const limit = Number(url.searchParams.get("limit") || 40);
-            const data = await (0, hub_1.hubListTasks)(this.store, this.ctx, { limit });
+            const hub = this.resolveHubConnection();
+            let data;
+            if (hub) {
+                data = await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, `/api/v1/hub/tasks?limit=${limit}`);
+            }
+            else {
+                data = await (0, hub_1.hubListTasks)(this.store, this.ctx, { limit });
+            }
             this.jsonResponse(res, { tasks: Array.isArray(data?.tasks) ? data.tasks : [] });
         }
         catch (err) {
@@ -1897,7 +1967,14 @@ class ViewerServer {
             return this.jsonResponse(res, { skills: [], error: "sharing_unavailable" });
         try {
             const limit = Number(url.searchParams.get("limit") || 40);
-            const data = await (0, hub_1.hubListSkills)(this.store, this.ctx, { limit });
+            const hub = this.resolveHubConnection();
+            let data;
+            if (hub) {
+                data = await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, `/api/v1/hub/skills/list?limit=${limit}`);
+            }
+            else {
+                data = await (0, hub_1.hubListSkills)(this.store, this.ctx, { limit });
+            }
             this.jsonResponse(res, { skills: Array.isArray(data?.skills) ? data.skills : [] });
         }
         catch (err) {
@@ -1914,13 +1991,22 @@ class ViewerServer {
                 const query = String(parsed.query || "");
                 const role = typeof parsed.role === "string" ? parsed.role : undefined;
                 const maxResults = typeof parsed.maxResults === "number" ? parsed.maxResults : 10;
-                const scope = parsed.scope === "group" || parsed.scope === "all" ? parsed.scope : "local";
+                const scope = parsed.scope === "group" || parsed.scope === "all" || parsed.scope === "hub" ? (parsed.scope === "hub" ? "all" : parsed.scope) : "local";
                 const local = this.searchLocalViewerMemories(query, { role, maxResults });
                 if (scope === "local") {
                     return this.jsonResponse(res, { local: { hits: local.hits, meta: local.meta }, hub: emptyHub });
                 }
                 try {
-                    const hub = await (0, hub_1.hubSearchMemories)(this.store, this.ctx, { query, maxResults, scope });
+                    const conn = this.resolveHubConnection();
+                    let hub;
+                    if (conn) {
+                        hub = await (0, hub_1.hubRequestJson)(conn.hubUrl, conn.userToken, "/api/v1/hub/search", {
+                            method: "POST", body: JSON.stringify({ query, maxResults, scope }),
+                        });
+                    }
+                    else {
+                        hub = await (0, hub_1.hubSearchMemories)(this.store, this.ctx, { query, maxResults, scope });
+                    }
                     this.jsonResponse(res, { local: { hits: local.hits, meta: local.meta }, hub });
                 }
                 catch (err) {
@@ -2356,6 +2442,38 @@ class ViewerServer {
             this.jsonResponse(res, { ok: false, error: String(err) });
         }
     }
+    async serveHubTaskDetail(res, p) {
+        const hub = this.resolveHubConnection();
+        if (!hub)
+            return this.jsonResponse(res, { error: "not_configured" }, 500);
+        const m = p.match(/^\/api\/admin\/shared-tasks\/([^/]+)\/detail$/);
+        if (!m)
+            return this.jsonResponse(res, { error: "bad_request" }, 400);
+        const taskId = decodeURIComponent(m[1]);
+        try {
+            const data = await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, `/api/v1/hub/shared-tasks/${encodeURIComponent(taskId)}/detail`, { method: "GET" });
+            this.jsonResponse(res, data);
+        }
+        catch (err) {
+            this.jsonResponse(res, { error: String(err) }, 500);
+        }
+    }
+    async serveHubSkillDetail(res, p) {
+        const hub = this.resolveHubConnection();
+        if (!hub)
+            return this.jsonResponse(res, { error: "not_configured" }, 500);
+        const m = p.match(/^\/api\/admin\/shared-skills\/([^/]+)\/detail$/);
+        if (!m)
+            return this.jsonResponse(res, { error: "bad_request" }, 400);
+        const skillId = decodeURIComponent(m[1]);
+        try {
+            const data = await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, `/api/v1/hub/shared-skills/${encodeURIComponent(skillId)}/detail`, { method: "GET" });
+            this.jsonResponse(res, data);
+        }
+        catch (err) {
+            this.jsonResponse(res, { error: String(err) }, 500);
+        }
+    }
     async serveAdminSharedSkills(res) {
         const hub = this.resolveHubConnection();
         if (!hub)
@@ -2449,6 +2567,13 @@ class ViewerServer {
                 const body = JSON.parse(raw || "{}");
                 await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/notifications/read", { method: "POST", body: JSON.stringify(body) });
                 this.jsonResponse(res, { ok: true });
+                try {
+                    const data = (await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/notifications?unread=1"));
+                    const count = data?.unreadCount ?? 0;
+                    this.lastKnownNotifCount = count;
+                    this.broadcastNotifSSE({ type: "update", unreadCount: count });
+                }
+                catch { /* best effort */ }
             }
             catch (err) {
                 this.jsonResponse(res, { ok: false, error: String(err) });
@@ -2463,12 +2588,92 @@ class ViewerServer {
             try {
                 await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/notifications/clear", { method: "POST", body: "{}" });
                 this.jsonResponse(res, { ok: true });
+                this.broadcastNotifSSE({ type: "cleared", unreadCount: 0 });
             }
             catch (err) {
                 this.jsonResponse(res, { ok: false, error: String(err) });
             }
         });
     }
+    handleNotifSSE(req, res) {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            "Access-Control-Allow-Origin": "*",
+        });
+        res.write("data: {\"type\":\"connected\"}\n\n");
+        this.notifSSEClients.push(res);
+        if (!this.notifPollTimer)
+            this.startNotifPoll();
+        req.on("close", () => {
+            this.notifSSEClients = this.notifSSEClients.filter((c) => c !== res);
+            if (this.notifSSEClients.length === 0)
+                this.stopNotifPoll();
+        });
+    }
+    broadcastNotifSSE(data) {
+        const msg = `data: ${JSON.stringify(data)}\n\n`;
+        this.notifSSEClients = this.notifSSEClients.filter((c) => {
+            try {
+                c.write(msg);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    startNotifPoll() {
+        this.stopNotifPoll();
+        const tick = async () => {
+            const hub = this.resolveHubConnection();
+            if (!hub)
+                return;
+            try {
+                const data = (await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/notifications?unread=1"));
+                const count = data?.unreadCount ?? 0;
+                if (count !== this.lastKnownNotifCount) {
+                    this.lastKnownNotifCount = count;
+                    this.broadcastNotifSSE({ type: "update", unreadCount: count });
+                }
+            }
+            catch { /* ignore */ }
+        };
+        tick();
+        this.notifPollTimer = setInterval(tick, 3000);
+    }
+    stopNotifPoll() {
+        if (this.notifPollTimer) {
+            clearInterval(this.notifPollTimer);
+            this.notifPollTimer = undefined;
+        }
+    }
+    startHubHeartbeat() {
+        this.stopHubHeartbeat();
+        const sendHeartbeat = async () => {
+            try {
+                const hub = this.resolveHubConnection();
+                if (!hub) {
+                    const persisted = this.store.getClientHubConnection();
+                    if (persisted?.hubUrl && persisted?.userToken) {
+                        await (0, hub_1.hubRequestJson)(persisted.hubUrl, persisted.userToken, "/api/v1/hub/heartbeat", { method: "POST" });
+                    }
+                    return;
+                }
+                await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/heartbeat", { method: "POST" });
+            }
+            catch { /* best-effort */ }
+        };
+        sendHeartbeat();
+        this.hubHeartbeatTimer = setInterval(sendHeartbeat, ViewerServer.HUB_HEARTBEAT_INTERVAL_MS);
+    }
+    stopHubHeartbeat() {
+        if (this.hubHeartbeatTimer) {
+            clearInterval(this.hubHeartbeatTimer);
+            this.hubHeartbeatTimer = undefined;
+        }
+    }
     getLocalIPs() {
         const nets = node_os_1.default.networkInterfaces();
         const ips = [];
@@ -2520,7 +2725,7 @@ class ViewerServer {
         }
     }
     handleSaveConfig(req, res) {
-        this.readBody(req, (body) => {
+        this.readBody(req, async (body) => {
             try {
                 const newCfg = JSON.parse(body);
                 const cfgPath = this.getOpenClawConfigPath();
@@ -2545,6 +2750,10 @@ class ViewerServer {
                 if (!entry.config)
                     entry.config = {};
                 const config = entry.config;
+                const oldSharing = config.sharing;
+                const oldSharingRole = oldSharing?.role;
+                const oldSharingEnabled = Boolean(oldSharing?.enabled);
+                const oldClientHubAddress = String(oldSharing?.client?.hubAddress || "");
                 if (newCfg.embedding)
                     config.embedding = newCfg.embedding;
                 if (newCfg.summarizer)
@@ -2578,6 +2787,33 @@ class ViewerServer {
                             catch { }
                         }
                     }
+                    const newRole = merged.role;
+                    const newEnabled = Boolean(merged.enabled);
+                    // Detect disabling sharing or switching away from hub mode
+                    const wasHub = oldSharingEnabled && oldSharingRole === "hub";
+                    const isHub = newEnabled && newRole === "hub";
+                    if (wasHub && !isHub) {
+                        await this.notifyHubShutdown();
+                        this.stopHubHeartbeat();
+                        this.log.info("Hub shutting down: notified connected clients");
+                    }
+                    // Detect disabling sharing or switching away from client mode
+                    const wasClient = oldSharingEnabled && oldSharingRole === "client";
+                    const isClient = newEnabled && newRole === "client";
+                    if (wasClient && !isClient) {
+                        this.notifyHubLeave();
+                        this.store.clearClientHubConnection();
+                        this.log.info("Cleared client hub connection (sharing disabled or role changed)");
+                    }
+                    // Detect switching to a different Hub while still in client mode
+                    if (wasClient && isClient) {
+                        const newClientAddr = String(merged.client?.hubAddress || "");
+                        if (newClientAddr && oldClientHubAddress && (0, hub_1.normalizeHubUrl)(newClientAddr) !== (0, hub_1.normalizeHubUrl)(oldClientHubAddress)) {
+                            this.notifyHubLeave();
+                            this.store.clearClientHubConnection();
+                            this.log.info("Cleared client hub connection (switched to different Hub)");
+                        }
+                    }
                     if (merged.role === "hub") {
                         merged.client = { hubAddress: "", userToken: "", teamToken: "" };
                     }
@@ -2589,6 +2825,12 @@ class ViewerServer {
                 node_fs_1.default.mkdirSync(node_path_1.default.dirname(cfgPath), { recursive: true });
                 node_fs_1.default.writeFileSync(cfgPath, JSON.stringify(raw, null, 2), "utf-8");
                 this.log.info("Plugin config updated via Viewer");
+                this.stopHubHeartbeat();
+                // When switching to client mode, immediately send join request
+                const finalSharing = config.sharing;
+                if (finalSharing?.role === "client" && oldSharingRole !== "client") {
+                    this.autoJoinOnSave(finalSharing).catch(e => this.log.warn(`Auto-join on save failed: ${e}`));
+                }
                 this.jsonResponse(res, { ok: true });
             }
             catch (e) {
@@ -2598,6 +2840,92 @@ class ViewerServer {
             }
         });
     }
+    async autoJoinOnSave(sharing) {
+        const clientCfg = sharing.client;
+        const hubAddress = String(clientCfg?.hubAddress || "");
+        const teamToken = String(clientCfg?.teamToken || "");
+        if (!hubAddress || !teamToken)
+            return;
+        const hubUrl = (0, hub_1.normalizeHubUrl)(hubAddress);
+        const os = await Promise.resolve().then(() => __importStar(require("os")));
+        const nickname = String(clientCfg?.nickname || "");
+        const username = nickname || os.userInfo().username || "user";
+        const hostname = os.hostname() || "unknown";
+        const result = await (0, hub_1.hubRequestJson)(hubUrl, "", "/api/v1/hub/join", {
+            method: "POST",
+            body: JSON.stringify({ teamToken, username, deviceName: hostname }),
+        });
+        this.store.setClientHubConnection({
+            hubUrl,
+            userId: String(result.userId || ""),
+            username,
+            userToken: result.userToken || "",
+            role: "member",
+            connectedAt: Date.now(),
+        });
+        this.log.info(`Auto-join on save: status=${result.status}, userId=${result.userId}`);
+        if (result.userToken) {
+            this.startHubHeartbeat();
+        }
+    }
+    async notifyHubLeave() {
+        try {
+            const hub = this.resolveHubConnection();
+            if (hub) {
+                await (0, hub_1.hubRequestJson)(hub.hubUrl, hub.userToken, "/api/v1/hub/leave", { method: "POST" });
+                this.log.info("Notified Hub of voluntary leave");
+                return;
+            }
+            const persisted = this.store.getClientHubConnection();
+            if (persisted?.hubUrl && persisted?.userToken) {
+                await (0, hub_1.hubRequestJson)(persisted.hubUrl, persisted.userToken, "/api/v1/hub/leave", { method: "POST" });
+                this.log.info("Notified Hub of voluntary leave (persisted connection)");
+            }
+        }
+        catch (e) {
+            this.log.warn(`Failed to notify Hub of leave: ${e}`);
+        }
+    }
+    async notifyHubShutdown() {
+        try {
+            const sharing = this.ctx?.config.sharing;
+            if (!sharing || sharing.role !== "hub")
+                return;
+            const hubPort = sharing.hub?.port ?? 18800;
+            const authPath = node_path_1.default.join(this.dataDir, "hub-auth.json");
+            let adminToken;
+            try {
+                const authData = JSON.parse(node_fs_1.default.readFileSync(authPath, "utf8"));
+                adminToken = authData?.bootstrapAdminToken;
+            }
+            catch {
+                return;
+            }
+            if (!adminToken)
+                return;
+            const users = this.store.listHubUsers("active");
+            const { v4: uuidv4 } = require("uuid");
+            for (const u of users) {
+                try {
+                    this.store.insertHubNotification({
+                        id: uuidv4(),
+                        userId: u.id,
+                        type: "hub_shutdown",
+                        resource: "hub",
+                        title: "Hub is shutting down",
+                        message: "The Hub server is shutting down. You may be disconnected.",
+                    });
+                }
+                catch (e) {
+                    this.log.warn(`Failed to insert shutdown notification for user ${u.id}: ${e}`);
+                }
+            }
+            this.log.info(`Hub shutdown: notified ${users.length} approved user(s)`);
+        }
+        catch (e) {
+            this.log.warn(`notifyHubShutdown error: ${e}`);
+        }
+    }
     handleUpdateUsername(req, res) {
         this.readBody(req, async (body) => {
             if (!this.ctx)
@@ -3072,7 +3400,7 @@ class ViewerServer {
     // ─── Migration: scan OpenClaw built-in memory ───
     getOpenClawHome() {
         const home = process.env.HOME || process.env.USERPROFILE || "";
-        return node_path_1.default.join(home, ".openclaw");
+        return process.env.OPENCLAW_STATE_DIR || node_path_1.default.join(home, ".openclaw");
     }
     handleCleanupPolluted(res) {
         try {