openclaw-cortex-memory 0.1.0-Alpha.2 → 0.1.0-Alpha.4

package/README.md

@@ -23,36 +23,37 @@ OpenClaw 长期记忆插件，提供跨会话检索、事件存储、规则反
 
 ### 安装步骤
 
-快速安装（推荐，npm 发布版）：
+快速安装（推荐，显式来源）：
 
 ```bash
 cd ~/openclaw
-pnpm openclaw plugins install openclaw-cortex-memory@alpha
+pnpm openclaw plugins install clawhub:openclaw-cortex-memory
 pnpm openclaw plugins enable openclaw-cortex-memory
-pnpm openclaw gateway restart
 ```
 
-后续更新：
+npm 安装方式：
 
 ```bash
 cd ~/openclaw
 pnpm openclaw plugins install openclaw-cortex-memory@alpha
-pnpm openclaw gateway restart
+pnpm openclaw plugins enable openclaw-cortex-memory
 ```
 
-安装前如果 `openclaw.json` 已经提前写了 `allow/slots/entries` 指向本插件，先临时移除，安装后再加回，避免安装前校验报 `plugin not found`。
-
-### 本地打包安装（源码模式）
+后续更新：
 
 ```bash
-git clone https://github.com/deki18/openclaw-cortex-memory.git ~/openclaw-cortex-memory-src
-cd ~/openclaw-cortex-memory-src
-npm install && npm run build && npm pack
 cd ~/openclaw
-pnpm openclaw plugins install ~/openclaw-cortex-memory-src/openclaw-cortex-memory-0.1.0-Alpha.1.tgz
-pnpm openclaw gateway restart
+pnpm openclaw plugins uninstall openclaw-cortex-memory
+pnpm openclaw plugins install clawhub:openclaw-cortex-memory
+pnpm openclaw plugins enable openclaw-cortex-memory
 ```
 
+说明：
+- 推荐显式安装来源，减少 ClawHub-first 时代的来源歧义。
+- 使用 `plugins install` 的安装记录方式，避免 `loaded without install/load-path provenance`。
+- 保持 `plugins.allow` 显式包含 `openclaw-cortex-memory`，避免运行时把插件判定为未绑定信任源。
+
+
 ### 本地开发模式（无安装记录）
 
 ```bash
@@ -71,6 +72,7 @@ npm install
 ```json
 {
   "plugins": {
+    "allow": ["openclaw-cortex-memory"],
     "slots": { "memory": "openclaw-cortex-memory" },
     "entries": {
       "openclaw-cortex-memory": {
@@ -194,10 +196,12 @@ npx cortex-memory help                # 查看命令帮助
 
 ## 注意事项
 
-1. **API Key 安全**：使用环境变量 `${OPENAI_API_KEY}` 而非硬编码
+1. **API Key 安全**：使用 `${EMBEDDING_API_KEY}`、`${LLM_API_KEY}`、`${RERANKER_API_KEY}` 等环境变量而非硬编码
 2. **向量维度**：必须与嵌入模型匹配，如 `text-embedding-3-large` 为 3072
 3. **重排序**：可选配置 `reranker` 以提升检索精度
-4. **单栈运行**：当前版本为纯 TS，无 Python 运行时依赖
+4. **外部传输**：检索与反思会调用你配置的 embedding/llm/reranker endpoint，请使用可信服务并最小化密钥权限
+5. **会话数据**：启用 `autoSync` 时会读取 OpenClaw 会话文件并写入本地记忆目录，生产环境建议先小范围验证
+6. **单栈运行**：当前版本为纯 TS，无 Python 运行时依赖
 
 ## 许可证
 

package/SKILL.md

@@ -8,9 +8,9 @@ metadata:
       "emoji": "🧠",
       "os": ["darwin", "linux", "win32"],
       "requires": {
-        "env": ["OPENAI_API_KEY"]
+        "env": ["EMBEDDING_API_KEY", "LLM_API_KEY", "RERANKER_API_KEY"]
       },
-      "primaryEnv": "OPENAI_API_KEY"
+      "primaryEnv": "EMBEDDING_API_KEY"
     }
   }
 ---
@@ -36,7 +36,16 @@ metadata:
 
 ### 安装
 
-快速安装（推荐，npm 发布版）：
+快速安装（推荐，显式来源）：
+
+```bash
+cd ~/openclaw
+pnpm openclaw plugins install clawhub:openclaw-cortex-memory
+pnpm openclaw plugins enable openclaw-cortex-memory
+pnpm openclaw gateway restart
+```
+
+若尚未在 ClawHub 发布，使用 npm 回退安装：
 
 ```bash
 cd ~/openclaw
@@ -49,11 +58,16 @@ pnpm openclaw gateway restart
 
 ```bash
 cd ~/openclaw
-pnpm openclaw plugins install openclaw-cortex-memory@alpha
+pnpm openclaw plugins uninstall openclaw-cortex-memory
+pnpm openclaw plugins install clawhub:openclaw-cortex-memory
+pnpm openclaw plugins enable openclaw-cortex-memory
 pnpm openclaw gateway restart
 ```
 
-安装前如果 `openclaw.json` 已经提前写了 `allow/slots/entries` 指向本插件，先临时移除，安装后再加回，避免安装前校验报 `plugin not found`。
+说明：
+- 推荐显式安装来源，减少 ClawHub-first 时代的来源歧义。
+- 使用 `plugins install` 的安装记录方式，避免 `loaded without install/load-path provenance`。
+- 保持 `plugins.allow` 显式包含 `openclaw-cortex-memory`，避免运行时把插件判定为未绑定信任源。
 
 ### 本地打包安装（源码模式）
 
@@ -62,7 +76,7 @@ git clone https://github.com/deki18/openclaw-cortex-memory.git ~/openclaw-cortex
 cd ~/openclaw-cortex-memory-src
 npm install && npm run build && npm pack
 cd ~/openclaw
-pnpm openclaw plugins install ~/openclaw-cortex-memory-src/openclaw-cortex-memory-0.1.0-Alpha.1.tgz
+pnpm openclaw plugins install ~/openclaw-cortex-memory-src/openclaw-cortex-memory-0.1.0-Alpha.4.tgz
 pnpm openclaw gateway restart
 ```
 
@@ -82,6 +96,7 @@ npm install
 ```json
 {
   "plugins": {
+    "allow": ["openclaw-cortex-memory"],
     "slots": { "memory": "openclaw-cortex-memory" },
     "entries": {
       "openclaw-cortex-memory": {
@@ -265,4 +280,4 @@ openclaw gateway restart
 ## 依赖
 
 - Node.js >= 22
-- OPENAI_API_KEY（或兼容 API 配置）
+- EMBEDDING_API_KEY、LLM_API_KEY、RERANKER_API_KEY（或兼容 API 配置）

package/dist/index.d.ts

@@ -64,10 +64,7 @@ interface OpenClawPluginApi {
             args?: Record<string, unknown>;
             context: ToolContext;
         }) => Promise<ToolResult>;
-        handler?: (params: {
-            args?: Record<string, unknown>;
-            context: ToolContext;
-        }) => Promise<ToolResult>;
+        handler?: (...params: unknown[]) => Promise<ToolResult>;
     }): void;
     unregisterTool?(name: string): void;
     registerHook(hook: {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -96,6 +96,7 @@ const defaultConfig = {
 let autoSearchCacheBySession = new Map();
 const AUTO_SEARCH_CACHE_TTL = 60000;
 const MAX_AUTO_SEARCH_CACHE_SESSIONS = 200;
+const HOOK_GUARD_TIMEOUT_MS = 2000;
 let config = null;
 let logger;
 let pythonProcess = null;
@@ -150,6 +151,33 @@ function getSessionCachedAutoSearch(sessionId) {
         ageSeconds: Math.floor((Date.now() - cache.timestamp) / 1000),
     };
 }
+function isInternalSession(sessionId) {
+    if (!sessionId)
+        return false;
+    return sessionId.startsWith("slug-generator-") || sessionId.startsWith("fallback:");
+}
+async function runWithTimeout(task, timeoutMs, label) {
+    let timeoutHandle = null;
+    try {
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => resolve(null), timeoutMs);
+        });
+        const result = await Promise.race([task, timeoutPromise]);
+        if (result === null) {
+            logger.warn(`${label} timed out after ${timeoutMs}ms; skipped to protect gateway responsiveness`);
+        }
+        return result;
+    }
+    catch (error) {
+        logger.warn(`${label} failed: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+    finally {
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+    }
+}
 function resolveEngine() {
     if (!config) {
         throw new Error("Configuration not loaded");
@@ -164,11 +192,14 @@ function resolveEngine() {
         projectRoot,
         dbPath: config.dbPath,
         logger,
+        embedding: config.embedding,
+        reranker: config.reranker,
     });
     const writeStore = (0, write_store_1.createWriteStore)({
         projectRoot,
         dbPath: config.dbPath,
         logger,
+        embedding: config.embedding,
     });
     const sessionSync = (0, session_sync_1.createSessionSync)({
         projectRoot,
@@ -192,6 +223,7 @@ function resolveEngine() {
         dbPath: config.dbPath,
         logger,
         ruleStore,
+        llm: config.llm,
     });
     memoryEngine = (0, ts_engine_1.createTsEngine)({
         readStore,
@@ -257,6 +289,15 @@ function sanitizeForLogging(obj) {
     }
     return sanitized;
 }
+function logLifecycle(event, details = {}) {
+    const payload = sanitizeForLogging({
+        event,
+        plugin: PLUGIN_ID,
+        ts: new Date().toISOString(),
+        ...details,
+    });
+    logger.info(`[Lifecycle] ${JSON.stringify(payload)}`);
+}
 function asRecord(value) {
     if (typeof value === "object" && value !== null) {
         return value;
@@ -415,13 +456,19 @@ function findProjectRoot() {
     throw new Error("Cannot find project root directory");
 }
 function findOpenClawConfig() {
+    const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || "";
+    const stateDir = process.env.OPENCLAW_STATE_DIR || "";
+    const basePath = process.env.OPENCLAW_BASE_PATH || "";
+    const homePath = process.env.USERPROFILE || process.env.HOME || "";
     const possiblePaths = [
+        explicitConfigPath,
+        stateDir ? path.join(stateDir, "openclaw.json") : "",
+        basePath ? path.join(basePath, "openclaw.json") : "",
         path.join(process.cwd(), "openclaw.json"),
-        path.join(process.env.USERPROFILE || process.env.HOME || "", ".openclaw", "openclaw.json"),
-        path.join(process.env.OPENCLAW_BASE_PATH || "", "openclaw.json"),
+        homePath ? path.join(homePath, ".openclaw", "openclaw.json") : "",
     ];
     for (const p of possiblePaths) {
-        if (fs.existsSync(p)) {
+        if (p && fs.existsSync(p)) {
             return p;
         }
     }
@@ -1365,10 +1412,18 @@ async function onTimerPythonHandler(payload, _context) {
     }
 }
 async function onMessageHandler(payload, context) {
-    await resolveEngine().onMessage(payload, context);
+    const sessionId = resolveSessionId(context, payload);
+    if (isInternalSession(sessionId)) {
+        return;
+    }
+    await runWithTimeout(resolveEngine().onMessage(payload, context), HOOK_GUARD_TIMEOUT_MS, "onMessage hook");
 }
 async function onSessionEndHandler(payload, context) {
-    await resolveEngine().onSessionEnd(payload, context);
+    const sessionId = resolveSessionId(context, payload);
+    if (isInternalSession(sessionId)) {
+        return;
+    }
+    await runWithTimeout(resolveEngine().onSessionEnd(payload, context), HOOK_GUARD_TIMEOUT_MS, "onSessionEnd hook");
 }
 async function onTimerHandler(payload, context) {
     await resolveEngine().onTimer(payload, context);
@@ -1536,13 +1591,30 @@ function registerTools() {
 function registerToolCompat(tool) {
     if (!api)
         return;
-    const execute = async (params) => tool.execute({ args: params?.args || {}, context: params.context });
+    const execute = async (params) => tool.execute({
+        args: params?.args || {},
+        context: params.context,
+    });
+    const handler = async (...params) => {
+        const first = params[0];
+        const second = params[1];
+        if (first && typeof first === "object" && "context" in first) {
+            return execute({
+                args: first.args || {},
+                context: first.context,
+            });
+        }
+        return execute({
+            args: first || {},
+            context: (second || {}),
+        });
+    };
     api.registerTool({
         name: tool.name,
         description: tool.description,
         parameters: tool.parameters,
         execute,
-        handler: execute,
+        handler,
     });
 }
 function unregisterTools() {
@@ -1649,6 +1721,7 @@ async function enable() {
         return;
     }
     logger.info("Enabling Cortex Memory plugin...");
+    logLifecycle("enable_start");
     try {
         unregisterFallbackTools();
         if (shouldUsePythonRuntime()) {
@@ -1660,10 +1733,12 @@ async function enable() {
         registerHooks();
         startAutoReflectScheduler();
         logger.info("Cortex Memory plugin enabled successfully");
+        logLifecycle("enable_success", { registeredTools: registeredTools.length, registeredHooks: registeredHooks.length });
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         logger.error(`Failed to enable Cortex Memory plugin: ${message}`);
+        logLifecycle("enable_failed", { error: message });
         throw error;
     }
 }
@@ -1673,6 +1748,7 @@ async function disable() {
         return;
     }
     logger.info("Disabling Cortex Memory plugin...");
+    logLifecycle("disable_start");
     unregisterHooks();
     unregisterTools();
     unregisterFallbackTools();
@@ -1685,8 +1761,10 @@ async function disable() {
     if (config?.fallbackToBuiltin && builtinMemory) {
         logger.info("Falling back to OpenClaw builtin memory system");
         registerFallbackTools();
+        logLifecycle("fallback_enabled", { fallbackTools: registeredFallbackTools.length });
     }
     logger.info("Cortex Memory plugin disabled successfully");
+    logLifecycle("disable_success", { fallbackEnabled: registeredFallbackTools.length > 0 });
 }
 function registerFallbackTools() {
     if (!api || !builtinMemory)
@@ -1754,6 +1832,7 @@ function getStatus() {
 }
 async function unregister() {
     logger.info("Unregistering Cortex Memory plugin...");
+    logLifecycle("unregister_start");
     stopConfigWatcher();
     stopAutoReflectScheduler();
     unregisterHooks();
@@ -1780,6 +1859,7 @@ async function unregister() {
     stopAutoReflectScheduler();
     configPath = null;
     logger.info("Cortex Memory plugin unregistered successfully");
+    logLifecycle("unregister_success");
 }
 function register(pluginApi, userConfig) {
     if (isInitializing || isRegistered) {
@@ -1852,6 +1932,11 @@ function register(pluginApi, userConfig) {
     isRegistered = true;
     logger.info("Cortex Memory plugin registered successfully");
     logger.info(`Cortex Memory engine mode: ${resolveEngine().mode}`);
+    logLifecycle("register_success", {
+        engineMode: config.engineMode,
+        enabled: isEnabled,
+        hasBuiltinFallback: Boolean(builtinMemory),
+    });
     if (isEnabled) {
         registerTools();
         registerHooks();
@@ -1865,11 +1950,13 @@ function register(pluginApi, userConfig) {
                 logger.info("Falling back to builtin memory");
                 isEnabled = false;
                 registerFallbackTools();
+                logLifecycle("fallback_after_init_error", { fallbackTools: registeredFallbackTools.length, error: message });
             }
         });
     }
     else if (config?.fallbackToBuiltin && builtinMemory) {
         registerFallbackTools();
+        logLifecycle("fallback_registered_on_start", { fallbackTools: registeredFallbackTools.length });
     }
 }
 async function initializeAsync() {