openclaw-memory-alibaba-mysql 0.1.2 → 0.1.4

package/config.ts

@@ -26,24 +26,52 @@ export type MemoryConfig = {
 export const MEMORY_CATEGORIES = ["preference", "fact", "decision", "entity", "other"] as const;
 export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
 
-const DEFAULT_MODEL = "text-embedding-3-small";
+const DEFAULT_MODEL = "text-embedding-v3";
+const DEFAULT_BASE_URL = "https://dashscope.aliyuncs.com/compatible-mode/v1";
 const DEFAULT_TABLE_NAME = "openclaw_memories";
 export const DEFAULT_CAPTURE_MAX_CHARS = 500;
 
 const EMBEDDING_DIMENSIONS: Record<string, number> = {
+  // DashScope (Alibaba Cloud)
+  "text-embedding-v3": 1024,
+  "text-embedding-v2": 1536,
+  // OpenAI
   "text-embedding-3-small": 1536,
   "text-embedding-3-large": 3072,
+  "text-embedding-ada-002": 1536,
+  // Cohere (via OpenAI-compatible endpoint)
+  "embed-english-v3.0": 1024,
+  "embed-multilingual-v3.0": 1024,
+  "embed-english-light-v3.0": 384,
+  "embed-multilingual-light-v3.0": 384,
+  // Jina
+  "jina-embeddings-v3": 1024,
+  "jina-embeddings-v2-base-en": 768,
+  "jina-embeddings-v2-base-zh": 768,
+  // BGE (via Ollama / local)
+  "bge-large-zh-v1.5": 1024,
+  "bge-large-en-v1.5": 1024,
+  "bge-m3": 1024,
+  // Nomic (via Ollama)
+  "nomic-embed-text": 768,
+  // Google
+  "text-embedding-004": 768,
 };
 
-export function vectorDimsForModel(model: string): number {
-  const dims = EMBEDDING_DIMENSIONS[model];
-  if (!dims) {
-    throw new Error(
-      `Unknown embedding model "${model}": cannot infer dimensions. ` +
-        `Please set embedding.dimensions explicitly.`,
-    );
-  }
-  return dims;
+const FLEX_DIMS_MODELS = new Set([
+  "text-embedding-v3",
+  "text-embedding-3-small",
+  "text-embedding-3-large",
+  "jina-embeddings-v3",
+]);
+
+export function vectorDimsForModel(model: string, explicit?: number): number {
+  if (explicit && explicit > 0) return explicit;
+  return EMBEDDING_DIMENSIONS[model] ?? 1024;
+}
+
+export function modelSupportsFlexDimensions(model: string): boolean {
+  return FLEX_DIMS_MODELS.has(model);
 }
 
 function resolveEnvVars(value: string): string {
@@ -84,7 +112,7 @@ function parseMysqlConfig(raw: unknown): MysqlConnectionConfig {
     user: requireString(m, "user", "mysql"),
     password: resolveEnvVars(requireString(m, "password", "mysql")),
     database: requireString(m, "database", "mysql"),
-    ssl: m.ssl !== false,
+    ssl: m.ssl === true,
   };
 }
 
@@ -96,16 +124,13 @@ function parseEmbeddingConfig(raw: unknown): EmbeddingConfig {
   assertAllowedKeys(e, ["apiKey", "model", "baseUrl", "dimensions"], "embedding");
 
   const model = typeof e.model === "string" ? e.model : DEFAULT_MODEL;
-
-  if (typeof e.dimensions !== "number") {
-    vectorDimsForModel(model);
-  }
+  const explicitDims = typeof e.dimensions === "number" ? e.dimensions : undefined;
 
   return {
     apiKey: resolveEnvVars(requireString(e, "apiKey", "embedding")),
     model,
-    baseUrl: typeof e.baseUrl === "string" ? resolveEnvVars(e.baseUrl) : undefined,
-    dimensions: typeof e.dimensions === "number" ? e.dimensions : undefined,
+    baseUrl: typeof e.baseUrl === "string" ? resolveEnvVars(e.baseUrl) : DEFAULT_BASE_URL,
+    dimensions: explicitDims,
   };
 }
 
@@ -138,7 +163,7 @@ export const memoryConfigSchema = {
       mysql: parseMysqlConfig(cfg.mysql),
       embedding: parseEmbeddingConfig(cfg.embedding),
       autoRecall: cfg.autoRecall !== false,
-      autoCapture: cfg.autoCapture === true,
+      autoCapture: cfg.autoCapture !== false,
       captureMaxChars: captureMaxChars ?? DEFAULT_CAPTURE_MAX_CHARS,
       tableName,
     };

package/index.ts

@@ -15,6 +15,7 @@ import {
   type MemoryCategory,
   memoryConfigSchema,
   vectorDimsForModel,
+  modelSupportsFlexDimensions,
 } from "./config.js";
 import { MemoryDB } from "./db.js";
 
@@ -24,6 +25,7 @@ import { MemoryDB } from "./db.js";
 
 class Embeddings {
   private client: OpenAI;
+  private sendDimensions: boolean;
 
   constructor(
     apiKey: string,
@@ -32,6 +34,7 @@ class Embeddings {
     private dimensions?: number,
   ) {
     this.client = new OpenAI({ apiKey, baseURL: baseUrl });
+    this.sendDimensions = modelSupportsFlexDimensions(model);
   }
 
   async embed(text: string): Promise<number[]> {
@@ -39,7 +42,7 @@ class Embeddings {
       model: this.model,
       input: text,
     };
-    if (this.dimensions) {
+    if (this.sendDimensions && this.dimensions) {
       params.dimensions = this.dimensions;
     }
     const response = await this.client.embeddings.create(params);
@@ -162,9 +165,9 @@ const memoryPlugin = {
     const cfg = memoryConfigSchema.parse(api.pluginConfig);
     const { model, dimensions, apiKey, baseUrl } = cfg.embedding;
 
-    const vectorDim = dimensions ?? vectorDimsForModel(model);
+    const vectorDim = vectorDimsForModel(model, dimensions);
     const db = new MemoryDB(cfg.mysql, cfg.tableName, vectorDim);
-    const embeddings = new Embeddings(apiKey, model, baseUrl, dimensions);
+    const embeddings = new Embeddings(apiKey, model, baseUrl, vectorDim);
 
     api.logger.info(
       `openclaw-memory-alibaba-mysql: plugin registered (host: ${cfg.mysql.host}, table: ${cfg.tableName}, lazy init)`,
@@ -277,7 +280,7 @@ const memoryPlugin = {
           });
 
           return {
-            content: [{ type: "text", text: `Stored: "${text.slice(0, 100)}..."` }],
+            content: [{ type: "text", text: `Stored: "${text.length > 100 ? text.slice(0, 100) + "..." : text}"` }],
             details: { action: "created", id: entry.id },
           };
         },
@@ -381,7 +384,7 @@ const memoryPlugin = {
             return;
           }
 
-          api.logger.info?.(
+          api.logger.info(
             `openclaw-memory-alibaba-mysql: injecting ${results.length} memories into context`,
           );
 

package/openclaw.plugin.json

@@ -34,22 +34,21 @@
     "embedding.apiKey": {
       "label": "Embedding API Key",
       "sensitive": true,
-      "placeholder": "sk-proj-... or ${OPENAI_API_KEY}"
+      "placeholder": "sk-... or ${DASHSCOPE_API_KEY}"
     },
     "embedding.model": {
       "label": "Embedding Model",
-      "placeholder": "text-embedding-3-small"
+      "placeholder": "text-embedding-v3"
     },
     "embedding.baseUrl": {
       "label": "Embedding Base URL",
-      "placeholder": "https://api.openai.com/v1",
-      "help": "DashScope: https://dashscope.aliyuncs.com/compatible-mode/v1",
+      "placeholder": "https://dashscope.aliyuncs.com/compatible-mode/v1",
       "advanced": true
     },
     "embedding.dimensions": {
       "label": "Dimensions",
-      "placeholder": "1536",
-      "help": "Vector dimensions (required for non-standard models)",
+      "placeholder": "1024",
+      "help": "Vector dimensions (auto-detected from model if not set)",
       "advanced": true
     },
     "autoCapture": {
@@ -87,7 +86,7 @@
           "user": { "type": "string" },
           "password": { "type": "string" },
           "database": { "type": "string" },
-          "ssl": { "type": "boolean", "default": true }
+          "ssl": { "type": "boolean", "default": false }
         }
       },
       "embedding": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-memory-alibaba-mysql",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "OpenClaw memory plugin using Alibaba Cloud RDS MySQL vector storage",
   "type": "module",
   "license": "MIT",