@modelstudio/modelstudio-memory-for-openclaw 1.0.1 → 1.0.3

package/README.md

@@ -58,7 +58,7 @@ openclaw modelstudio-memory stats
         config: {
           // 必需配置
           "apiKey": "your-dashscope-api-key",
-          "userId": "user_001",
+          "userId": "openclaw_memory",
           
           // 可选配置（以下为默认值）
           "baseUrl": "https://dashscope.aliyuncs.com/api/v2/apps/memory",
@@ -81,7 +81,7 @@ openclaw modelstudio-memory stats
 | 配置项 | 类型 | 必需 | 默认值 | 说明 |
 |--------|------|------|--------|------|
 | `apiKey` | `string` | ✅ | - | DashScope API Key（在 openclaw.json 中配置） |
-| `userId` | `string` | ✅ | - | 用户 ID，用于隔离不同用户的记忆 |
+| `userId` | `string` | ❌ | `openclaw_memory` | 用户 ID，用于隔离不同用户的记忆 |
 | `baseUrl` | `string` | ❌ | `https://dashscope.aliyuncs.com/api/v2/apps/memory` | API endpoint（私有部署时填写完整 URL） |
 | `autoCapture` | `boolean` | ❌ | `true` | 是否自动捕获对话 |
 | `autoRecall` | `boolean` | ❌ | `true` | 是否自动召回记忆 |
@@ -95,6 +95,8 @@ openclaw modelstudio-memory stats
 
 在 [阿里云百炼控制台](https://help.aliyun.com/zh/model-studio/get-api-key) 获取 DashScope API Key，并在 `openclaw.json` 的 `config.apiKey` 中配置。
 
+**提示**：若安装后未配置 apiKey，插件仍会加载。当用户使用记忆功能（如询问「我之前说过什么」）时，Agent 会提示用户配置 apiKey。
+
 ## 使用方法
 
 ### 自动记忆（推荐）

package/index.ts

@@ -98,17 +98,9 @@ const modelstudioMemoryConfigSchema = {
     const cfg = value as Record<string, unknown>;
     assertAllowedKeys(cfg, ALLOWED_KEYS, "modelstudio-memory-for-openclaw config");
 
-    // apiKey is required (plain text in openclaw.json)
+    // apiKey: allow empty at parse time; tools return config prompt when missing
     const apiKey = typeof cfg.apiKey === "string" ? cfg.apiKey : "";
-    if (!apiKey) {
-      throw new Error("apiKey is required for modelstudio-memory-for-openclaw");
-    }
-
-    // userId is required
-    const userId = typeof cfg.userId === "string" ? cfg.userId : "";
-    if (!userId) {
-      throw new Error("userId is required for modelstudio-memory-for-openclaw");
-    }
+    const userId = typeof cfg.userId === "string" && cfg.userId ? cfg.userId : "openclaw_memory";
 
     return {
       apiKey,
@@ -365,6 +357,9 @@ function stripInjectedContext(text: string): string {
   return text.replace(/<relevant-memories>[\s\S]*?<\/relevant-memories>\s*/g, "").trim();
 }
 
+const CONFIG_REQUIRED_MESSAGE =
+  "Memory plugin is not configured. Please add apiKey and userId to ~/.openclaw/openclaw.json under plugins.entries.modelstudio-memory-for-openclaw.config";
+
 // ============================================================================
 // Plugin Definition
 // ============================================================================
@@ -385,6 +380,12 @@ const modelstudioMemoryPlugin = {
       api.logger
     );
 
+    if (!cfg.apiKey) {
+      const msg =
+        "[modelstudio-memory] apiKey not configured. Memory features disabled. Add apiKey to ~/.openclaw/openclaw.json under plugins.entries.modelstudio-memory-for-openclaw.config";
+      api.logger.warn(msg);
+      console.warn(msg);
+    }
     api.logger.info(
       `modelstudio-memory: registered (user: ${cfg.userId}, autoCapture: ${cfg.autoCapture}, autoRecall: ${cfg.autoRecall})`
     );
@@ -405,6 +406,12 @@ const modelstudioMemoryPlugin = {
           ),
         }),
         async execute(_id, params) {
+          if (!cfg.apiKey) {
+            return {
+              content: [{ type: "text", text: CONFIG_REQUIRED_MESSAGE }],
+              isError: true,
+            };
+          }
           try {
             const limit = Math.min(
               Math.max(1, params.limit ?? cfg.topK),
@@ -476,6 +483,12 @@ const modelstudioMemoryPlugin = {
           content: Type.String({ description: "Content to store" }),
         }),
         async execute(_id, params) {
+          if (!cfg.apiKey) {
+            return {
+              content: [{ type: "text", text: CONFIG_REQUIRED_MESSAGE }],
+              isError: true,
+            };
+          }
           try {
             const result = await client.addCustomContent(params.content);
 
@@ -521,6 +534,12 @@ const modelstudioMemoryPlugin = {
           ),
         }),
         async execute(_id, params) {
+          if (!cfg.apiKey) {
+            return {
+              content: [{ type: "text", text: CONFIG_REQUIRED_MESSAGE }],
+              isError: true,
+            };
+          }
           try {
             const page = Math.max(1, params.page ?? 1);
             const pageSize = Math.min(100, Math.max(1, params.pageSize ?? 10));
@@ -581,6 +600,12 @@ const modelstudioMemoryPlugin = {
           index: Type.Optional(Type.Number({ description: "Delete Nth memory (1-based)" })),
         }),
         async execute(_id, params) {
+          if (!cfg.apiKey) {
+            return {
+              content: [{ type: "text", text: CONFIG_REQUIRED_MESSAGE }],
+              isError: true,
+            };
+          }
           try {
             let targetId = params.memoryId;
 
@@ -698,6 +723,12 @@ const modelstudioMemoryPlugin = {
     // ========== autoRecall ==========
     if (cfg.autoRecall) {
       api.on("before_agent_start", async (event) => {
+        if (!cfg.apiKey) {
+          return {
+            prependSystemContext:
+              "Note: Memory plugin is not configured (apiKey missing). Long-term memory is disabled. Ask the user to add apiKey to ~/.openclaw/openclaw.json under plugins.entries.modelstudio-memory-for-openclaw.config and restart the gateway.",
+          };
+        }
         const prompt = extractTextContent(event.prompt);
         if (!prompt || prompt.length < cfg.recallMinPromptLength) {
           return;
@@ -731,7 +762,7 @@ const modelstudioMemoryPlugin = {
     // ========== autoCapture ==========
     if (cfg.autoCapture) {
       api.on("agent_end", async (event) => {
-        if (!event.success || !event.messages) {
+        if (!cfg.apiKey || !event.success || !event.messages) {
           return;
         }
 
@@ -806,6 +837,10 @@ const modelstudioMemoryPlugin = {
           .argument("<query>", "Search query")
           .option("--limit <n>", "Max results", String(cfg.topK))
           .action(async (query: string, opts: { limit: string }) => {
+            if (!cfg.apiKey) {
+              console.error(CONFIG_REQUIRED_MESSAGE);
+              return;
+            }
             try {
               const limit = Math.min(100, Math.max(1, parseInt(opts.limit, 10) || cfg.topK));
               const cleanQuery = extractTextContent(query) || query.trim();
@@ -840,6 +875,10 @@ const modelstudioMemoryPlugin = {
           .command("stats")
           .description("Show memory statistics")
           .action(async () => {
+            if (!cfg.apiKey) {
+              console.error(CONFIG_REQUIRED_MESSAGE);
+              return;
+            }
             try {
               const result = await client.listMemory(1, 1);
               console.log(`User: ${cfg.userId}`);
@@ -859,6 +898,10 @@ const modelstudioMemoryPlugin = {
           .option("--page <n>", "Page number", "1")
           .option("--size <n>", "Page size", "10")
           .action(async (opts: { page: string; size: string }) => {
+            if (!cfg.apiKey) {
+              console.error(CONFIG_REQUIRED_MESSAGE);
+              return;
+            }
             try {
               const page = Math.max(1, parseInt(opts.page, 10) || 1);
               const size = Math.min(100, Math.max(1, parseInt(opts.size, 10) || 10));

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "modelstudio-memory-for-openclaw",
   "description": "阿里云百炼长期记忆服务，提供自动记忆捕获和召回能力",
   "kind": "memory",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -14,7 +14,7 @@
       },
       "userId": {
         "type": "string",
-        "description": "用户 ID，用于隔离不同用户的记忆"
+        "description": "用户 ID，用于隔离不同用户的记忆（默认 'openclaw_memory'）"
       },
       "baseUrl": {
         "type": "string",
@@ -66,7 +66,7 @@
     },
     "userId": {
       "label": "用户 ID",
-      "placeholder": "user_001"
+      "placeholder": "openclaw_memory"
     },
     "baseUrl": {
       "label": "API Endpoint",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelstudio/modelstudio-memory-for-openclaw",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "阿里云百炼长期记忆服务 OpenClaw 插件",
   "license": "Apache-2.0",