@memtensor/memos-local-openclaw-plugin 1.0.4-beta.15 → 1.0.4-beta.17

package/index.ts

@@ -180,7 +180,7 @@ const memosLocalPlugin = {
     }
 
     let pluginCfg = (api.pluginConfig ?? {}) as Record<string, unknown>;
-    const stateDir = api.resolvePath("~/.openclaw");
+    const stateDir = process.env.OPENCLAW_STATE_DIR || api.resolvePath("~/.openclaw");
 
     // Fallback: read config from file if not provided by OpenClaw
     const configPath = path.join(stateDir, "state", "memos-local", "config.json");
@@ -1314,7 +1314,8 @@ Groups: ${groupNames.length > 0 ? groupNames.join(", ") : "(none)"}`,
 
     // ─── Tool: memory_viewer ───
 
-    const viewerPort = (pluginCfg as any).viewerPort ?? 18799;
+    const gatewayPort = (api.config as any)?.gateway?.port ?? 18789;
+    const viewerPort = (pluginCfg as any).viewerPort ?? (gatewayPort + 10);
 
     api.registerTool(
       {
@@ -2297,6 +2298,8 @@ Groups: ${groupNames.length > 0 ? groupNames.join(", ") : "(none)"}`,
 
     // ─── Memory Viewer (web UI) ───
 
+    const derivedHubPort = gatewayPort + 11;
+
     const viewer = new ViewerServer({
       store,
       embedder,
@@ -2304,10 +2307,10 @@ Groups: ${groupNames.length > 0 ? groupNames.join(", ") : "(none)"}`,
       log: ctx.log,
       dataDir: stateDir,
       ctx,
+      defaultHubPort: derivedHubPort,
     });
-
     const hubServer = ctx.config.sharing?.enabled && ctx.config.sharing.role === "hub"
-      ? new HubServer({ store, log: ctx.log, config: ctx.config, dataDir: stateDir, embedder })
+      ? new HubServer({ store, log: ctx.log, config: ctx.config, dataDir: stateDir, embedder, defaultHubPort: derivedHubPort })
       : null;
 
     // ─── Service lifecycle ───

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "memos-local-openclaw-plugin",
   "name": "MemOS Local Memory",
-  "description": "Full-write local conversation memory with hybrid search (RRF + MMR + recency). Provides memory_search, memory_get, task_summary, memory_timeline, memory_viewer for layered retrieval.",
+  "description": "Full-write local conversation memory with hybrid search (RRF + MMR + recency), task summarization, skill evolution, and team sharing (Hub-Client). Provides memory_search, memory_get, task_summary, skill_search, task_share, network_skill_pull, network_team_info, memory_viewer for layered retrieval and team collaboration.",
   "kind": "memory",
   "version": "0.1.12",
   "skills": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memtensor/memos-local-openclaw-plugin",
-  "version": "1.0.4-beta.15",
+  "version": "1.0.4-beta.17",
   "description": "MemOS Local memory plugin for OpenClaw — full-write, hybrid-recall, progressive retrieval",
   "type": "module",
   "main": "index.ts",

package/src/hub/server.ts

@@ -14,6 +14,7 @@ type HubServerOptions = {
   config: MemosLocalConfig;
   dataDir: string;
   embedder?: Embedder;
+  defaultHubPort?: number;
 };
 
 type HubAuthState = {
@@ -79,18 +80,31 @@ export class HubServer {
       }
     });
 
+    const MAX_PORT_RETRIES = 3;
+    let hubPort = this.port;
     await new Promise<void>((resolve, reject) => {
-      const onError = (err: Error) => {
-        this.server?.off("listening", onListening);
-        reject(err);
+      let retries = 0;
+      const onError = (err: NodeJS.ErrnoException) => {
+        if (err.code === "EADDRINUSE" && retries < MAX_PORT_RETRIES) {
+          retries++;
+          hubPort = this.port + retries;
+          this.opts.log.warn(`Hub port ${hubPort - 1} in use, trying ${hubPort}`);
+          this.server!.listen(hubPort, "0.0.0.0");
+        } else {
+          this.server?.off("listening", onListening);
+          reject(err);
+        }
       };
       const onListening = () => {
         this.server?.off("error", onError);
+        if (hubPort !== this.port) {
+          this.opts.log.info(`Hub started on fallback port ${hubPort} (configured: ${this.port})`);
+        }
         resolve();
       };
-      this.server!.once("error", onError);
+      this.server!.on("error", onError);
       this.server!.once("listening", onListening);
-      this.server!.listen(this.port, "0.0.0.0");
+      this.server!.listen(hubPort, "0.0.0.0");
     });
 
     const bootstrap = this.userManager.ensureBootstrapAdmin(
@@ -109,19 +123,37 @@ export class HubServer {
     this.initOnlineTracking();
     this.offlineCheckTimer = setInterval(() => this.checkOfflineUsers(), HubServer.OFFLINE_CHECK_INTERVAL_MS);
 
-    return `http://127.0.0.1:${this.port}`;
+    return `http://127.0.0.1:${hubPort}`;
   }
 
   async stop(): Promise<void> {
     if (this.offlineCheckTimer) { clearInterval(this.offlineCheckTimer); this.offlineCheckTimer = undefined; }
     if (!this.server) return;
+
+    try {
+      const activeUsers = this.opts.store.listHubUsers("active");
+      const ownerId = this.authState.bootstrapAdminUserId || "";
+      for (const u of activeUsers) {
+        if (u.id === ownerId) continue;
+        try {
+          this.opts.store.insertHubNotification({
+            id: randomUUID(), userId: u.id, type: "hub_shutdown",
+            resource: "system", title: `Team server "${this.teamName}" has been shut down by the admin.`,
+          });
+        } catch { /* best-effort */ }
+      }
+    } catch { /* best-effort */ }
+
     const server = this.server;
     this.server = undefined;
     await new Promise<void>((resolve) => server.close(() => resolve()));
   }
 
   private get port(): number {
-    return this.opts.config.sharing?.hub?.port ?? 18800;
+    const configured = this.opts.config.sharing?.hub?.port;
+    const derived = this.opts.defaultHubPort;
+    if (derived && (!configured || configured === 18800)) return derived;
+    return configured ?? 18800;
   }
 
   private get teamName(): string {
@@ -320,6 +352,22 @@ export class HubServer {
       return this.json(res, 200, { status: user.status });
     }
 
+    if (req.method === "POST" && routePath === "/api/v1/hub/withdraw-pending") {
+      const body = await this.readJson(req);
+      if (!body || body.teamToken !== this.teamToken) {
+        return this.json(res, 403, { error: "invalid_team_token" });
+      }
+      const userId = String(body.userId || "");
+      if (!userId) return this.json(res, 400, { error: "missing_user_id" });
+      const user = this.opts.store.getHubUser(userId);
+      if (!user) return this.json(res, 200, { ok: true });
+      if (user.status === "pending") {
+        this.userManager.markUserLeft(userId);
+        this.opts.log.info(`Hub: user "${user.username}" (${userId}) withdrew pending application`);
+      }
+      return this.json(res, 200, { ok: true });
+    }
+
     // All endpoints below require authentication + rate limiting
     const auth = this.authenticate(req);
     if (!auth) return this.json(res, 401, { error: "unauthorized" });
@@ -336,7 +384,7 @@ export class HubServer {
     if (req.method === "POST" && routePath === "/api/v1/hub/leave") {
       this.userManager.markUserLeft(auth.userId);
       this.knownOnlineUsers.delete(auth.userId);
-      this.notifyAdmins("user_offline", "user", auth.username, auth.userId);
+      this.notifyAdmins("user_left", "user", auth.username, auth.userId);
       this.opts.log.info(`Hub: user "${auth.username}" (${auth.userId}) left voluntarily, status set to "left"`);
       return this.json(res, 200, { ok: true });
     }
@@ -441,6 +489,13 @@ export class HubServer {
       const updatedUser = { ...user, role: newRole as "admin" | "member" };
       this.opts.store.upsertHubUser(updatedUser);
       this.opts.log.info(`Hub: admin "${auth.userId}" changed role of "${userId}" to "${newRole}"`);
+      try {
+        const notifType = newRole === "admin" ? "role_promoted" : "role_demoted";
+        this.opts.store.insertHubNotification({
+          id: randomUUID(), userId, type: notifType,
+          resource: "user", title: `Your role in team "${this.teamName}" has been changed to ${newRole}.`,
+        });
+      } catch { /* best-effort */ }
       return this.json(res, 200, { ok: true, role: newRole });
     }
 
@@ -478,9 +533,16 @@ export class HubServer {
       if (!userId) return this.json(res, 400, { error: "missing_user_id" });
       if (userId === auth.userId) return this.json(res, 400, { error: "cannot_remove_self" });
       if (userId === this.authState.bootstrapAdminUserId) return this.json(res, 403, { error: "cannot_remove_owner", message: "The hub owner cannot be removed" });
+      try {
+        this.opts.store.insertHubNotification({
+          id: randomUUID(), userId, type: "membership_removed",
+          resource: "user", title: `You have been removed from team "${this.teamName}" by the admin.`,
+        });
+      } catch { /* best-effort */ }
       const cleanResources = body?.cleanResources === true;
       const deleted = this.opts.store.deleteHubUser(userId, cleanResources);
       if (!deleted) return this.json(res, 404, { error: "not_found" });
+      this.knownOnlineUsers.delete(userId);
       this.opts.log.info(`Hub: admin "${auth.userId}" removed user "${userId}" (cleanResources=${cleanResources})`);
       return this.json(res, 200, { ok: true });
     }

package/src/ingest/providers/index.ts

@@ -49,8 +49,8 @@ function normalizeEndpointForProvider(
 function loadOpenClawFallbackConfig(log: Logger): SummarizerConfig | undefined {
   try {
     const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-    const ocHome = process.env.OPENCLAW_STATE_DIR || path.join(home, ".openclaw");
-    const cfgPath = path.join(ocHome, "openclaw.json");
+    const cfgPath = process.env.OPENCLAW_CONFIG_PATH
+      || path.join(process.env.OPENCLAW_STATE_DIR || path.join(home, ".openclaw"), "openclaw.json");
     if (!fs.existsSync(cfgPath)) return undefined;
 
     const raw = JSON.parse(fs.readFileSync(cfgPath, "utf-8"));

package/src/shared/llm-call.ts

@@ -37,7 +37,8 @@ function defaultEndpointForProvider(provider: SummaryProvider, baseUrl: string):
 export function loadOpenClawFallbackConfig(log: Logger): SummarizerConfig | undefined {
   try {
     const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-    const cfgPath = path.join(home, ".openclaw", "openclaw.json");
+    const cfgPath = process.env.OPENCLAW_CONFIG_PATH
+      || path.join(process.env.OPENCLAW_STATE_DIR || path.join(home, ".openclaw"), "openclaw.json");
     if (!fs.existsSync(cfgPath)) return undefined;
 
     const raw = JSON.parse(fs.readFileSync(cfgPath, "utf-8"));