@memclaw/plugin 0.9.1 → 0.9.3

package/dist/src/config.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Configuration management for MemClaw
+ *
+ * Handles platform-specific config paths, config file generation,
+ * and auto-opening config files for user editing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigDir = getConfigDir;
+exports.getDataDir = getDataDir;
+exports.getConfigPath = getConfigPath;
+exports.generateConfigTemplate = generateConfigTemplate;
+exports.ensureConfigExists = ensureConfigExists;
+exports.openConfigFile = openConfigFile;
+exports.parseConfig = parseConfig;
+exports.validateConfig = validateConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+// Platform-specific paths
+function getConfigDir() {
+    const platform = process.platform;
+    if (platform === "win32") {
+        return path.join(process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), "memclaw");
+    }
+    else if (platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Application Support", "memclaw");
+    }
+    else {
+        return path.join(os.homedir(), ".config", "memclaw");
+    }
+}
+function getDataDir() {
+    const platform = process.platform;
+    if (platform === "win32") {
+        return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"), "memclaw", "data");
+    }
+    else if (platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Application Support", "memclaw", "data");
+    }
+    else {
+        return path.join(os.homedir(), ".local", "share", "memclaw", "data");
+    }
+}
+function getConfigPath() {
+    return path.join(getConfigDir(), "config.toml");
+}
+function generateConfigTemplate() {
+    const dataDir = getDataDir().replace(/\\/g, "/");
+    return `# MemClaw Configuration
+#
+# This file was auto-generated. Please fill in the required values below.
+# Required fields are marked with [REQUIRED]
+
+# Qdrant Vector Database Configuration
+[qdrant]
+url = "http://localhost:6334"
+collection_name = "memclaw"
+timeout_secs = 30
+
+# LLM Configuration [REQUIRED for memory processing]
+[llm]
+# Your LLM API endpoint (OpenAI-compatible)
+api_base_url = "https://api.openai.com/v1"
+# Your API key [REQUIRED]
+api_key = ""
+# Model for memory extraction and layer generation
+model_efficient = "gpt-4o-mini"
+temperature = 0.1
+max_tokens = 4096
+
+# Embedding Configuration [REQUIRED for vector search]
+[embedding]
+# Your embedding API endpoint (OpenAI-compatible)
+api_base_url = "https://api.openai.com/v1"
+# Your API key [REQUIRED - can be same as llm.api_key]
+api_key = ""
+model_name = "text-embedding-3-small"
+batch_size = 10
+timeout_secs = 30
+
+# Service Configuration
+[server]
+host = "localhost"
+port = 8085
+
+# Cortex Memory Settings
+[cortex]
+data_dir = "${dataDir}"
+enable_intent_analysis = false
+`;
+}
+function ensureConfigExists() {
+    const configDir = getConfigDir();
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    if (!fs.existsSync(configPath)) {
+        const template = generateConfigTemplate();
+        fs.writeFileSync(configPath, template, "utf-8");
+        return { created: true, path: configPath };
+    }
+    return { created: false, path: configPath };
+}
+function openConfigFile(configPath) {
+    return new Promise((resolve, reject) => {
+        const platform = process.platform;
+        let command;
+        let args = [];
+        if (platform === "win32") {
+            command = "cmd";
+            args = ["/c", "start", '""', configPath];
+        }
+        else if (platform === "darwin") {
+            command = "open";
+            args = [configPath];
+        }
+        else {
+            command = "xdg-open";
+            args = [configPath];
+        }
+        const proc = (0, child_process_1.spawn)(command, args, { detached: true, stdio: "ignore" });
+        proc.on("error", (err) => {
+            reject(err);
+        });
+        proc.unref();
+        resolve();
+    });
+}
+function parseConfig(configPath) {
+    const content = fs.readFileSync(configPath, "utf-8");
+    const config = {};
+    let currentSection = "";
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        // Skip comments and empty lines
+        if (trimmed.startsWith("#") || trimmed === "")
+            continue;
+        // Section header
+        const sectionMatch = trimmed.match(/^\[(\w+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            config[currentSection] = {};
+            continue;
+        }
+        // Key-value pair
+        const kvMatch = trimmed.match(/^(\w+)\s*=\s*"([^"]*)"(?:\s*$|\s*#)/) ||
+            trimmed.match(/^(\w+)\s*=\s*(\d+(?:\.\d+)?)(?:\s*$|\s*#)/) ||
+            trimmed.match(/^(\w+)\s*=\s*(true|false)(?:\s*$|\s*#)/);
+        if (kvMatch && currentSection) {
+            const key = kvMatch[1];
+            let value = kvMatch[2];
+            // Convert to appropriate type
+            if (value === "true")
+                value = true;
+            else if (value === "false")
+                value = false;
+            else if (/^\d+$/.test(value))
+                value = parseInt(value, 10);
+            else if (/^\d+\.\d+$/.test(value))
+                value = parseFloat(value);
+            config[currentSection] = config[currentSection] || {};
+            config[currentSection][key] = value;
+        }
+    }
+    // Apply defaults
+    const dataDir = getDataDir();
+    return {
+        qdrant: {
+            url: "http://localhost:6334",
+            collection_name: "memclaw",
+            timeout_secs: 30,
+            ...(config.qdrant || {}),
+        },
+        llm: {
+            api_base_url: "https://api.openai.com/v1",
+            api_key: "",
+            model_efficient: "gpt-5-mini",
+            temperature: 0.1,
+            max_tokens: 4096,
+            ...(config.llm || {}),
+        },
+        embedding: {
+            api_base_url: "https://api.openai.com/v1",
+            api_key: "",
+            model_name: "text-embedding-3-small",
+            batch_size: 10,
+            timeout_secs: 30,
+            ...(config.embedding || {}),
+        },
+        server: {
+            host: "localhost",
+            port: 8085,
+            ...(config.server || {}),
+        },
+        cortex: {
+            data_dir: dataDir,
+            enable_intent_analysis: false,
+            ...(config.cortex || {}),
+        },
+    };
+}
+function validateConfig(config) {
+    const errors = [];
+    if (!config.llm.api_key || config.llm.api_key === "") {
+        errors.push("llm.api_key is required");
+    }
+    if (!config.embedding.api_key || config.embedding.api_key === "") {
+        // Allow using llm.api_key for embedding if not specified
+        if (config.llm.api_key && config.llm.api_key !== "") {
+            config.embedding.api_key = config.llm.api_key;
+        }
+        else {
+            errors.push("embedding.api_key is required");
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/migrate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Migration script for OpenClaw native memory to MemClaw
+ *
+ * Migrates:
+ * - memory/YYYY-MM-DD.md → session timeline files
+ * - MEMORY.md → users/{tenant}/preferences.md
+ */
+interface MigrationResult {
+    dailyLogsMigrated: number;
+    memoryMdMigrated: boolean;
+    sessionsCreated: string[];
+    errors: string[];
+}
+/**
+ * Main migration function
+ */
+export declare function migrateFromOpenClaw(log?: (msg: string) => void): Promise<MigrationResult>;
+/**
+ * Check if migration is possible
+ */
+export declare function canMigrate(): {
+    possible: boolean;
+    reason: string;
+};
+export {};
+//# sourceMappingURL=migrate.d.ts.map

package/dist/src/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,UAAU,eAAe;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgPD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAelE"}

package/dist/src/migrate.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * Migration script for OpenClaw native memory to MemClaw
+ *
+ * Migrates:
+ * - memory/YYYY-MM-DD.md → session timeline files
+ * - MEMORY.md → users/{tenant}/preferences.md
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateFromOpenClaw = migrateFromOpenClaw;
+exports.canMigrate = canMigrate;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const glob_1 = require("glob");
+const config_js_1 = require("./config.js");
+const binaries_js_1 = require("./binaries.js");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+// Migration configuration
+const MIGRATION_TENANT = 'tenant_claw';
+const DEFAULT_ROLE = 'user';
+/**
+ * Detect OpenClaw workspace directory
+ */
+function findOpenClawWorkspace() {
+    const homeDir = os.homedir();
+    const workspacePath = path.join(homeDir, '.openclaw', 'workspace');
+    if (fs.existsSync(workspacePath)) {
+        return workspacePath;
+    }
+    return null;
+}
+/**
+ * Split content into paragraphs (not just lines)
+ */
+function splitIntoParagraphs(content) {
+    return content
+        .split(/\n\s*\n/)
+        .map(p => p.trim())
+        .filter(p => p.length > 0 && !p.startsWith('#')); // Skip headers
+}
+/**
+ * Generate L2 content for a single paragraph
+ */
+function generateL2Content(paragraph, sessionId, date, index) {
+    // Generate a deterministic timestamp based on index
+    const hour = String(index % 24).padStart(2, '0');
+    const minute = String((index * 7) % 60).padStart(2, '0');
+    const second = String((index * 13) % 60).padStart(2, '0');
+    const timestamp = `${date}T${hour}:${minute}:${second}Z`;
+    const msgId = `${date.replace(/-/g, '')}_${String(index).padStart(4, '0')}`;
+    return `---
+id: "${msgId}"
+role: "${DEFAULT_ROLE}"
+timestamp: "${timestamp}"
+thread_id: "${sessionId}"
+---
+${paragraph}`;
+}
+/**
+ * Migrate daily logs from OpenClaw native memory to MemClaw
+ */
+async function migrateDailyLogs(ocWorkspace, dataDir, log) {
+    const memoryDir = path.join(ocWorkspace, 'memory');
+    const count = 0;
+    const sessions = [];
+    const errors = [];
+    if (!fs.existsSync(memoryDir)) {
+        log?.('No memory directory found in OpenClaw workspace');
+        return { count: 0, sessions: [], errors: [] };
+    }
+    // Find all daily log files
+    const dailyLogPattern = path.join(memoryDir, '*.md').replace(/\\/g, '/');
+    const files = await (0, glob_1.glob)(dailyLogPattern);
+    const dailyLogs = files.filter(f => {
+        const basename = path.basename(f);
+        return /^\d{4}-\d{2}-\d{2}\.md$/.test(basename);
+    });
+    log?.(`Found ${dailyLogs.length} daily log files to migrate`);
+    for (const logPath of dailyLogs) {
+        try {
+            const date = path.basename(logPath, '.md'); // 2026-03-13
+            const [year, month, day] = date.split('-');
+            const sessionId = `migrated-oc-${date}`;
+            const timelineDir = path.join(dataDir, 'sessions', MIGRATION_TENANT, sessionId, 'timeline', year, month, day);
+            // Create directory
+            fs.mkdirSync(timelineDir, { recursive: true });
+            // Read and split content
+            const content = fs.readFileSync(logPath, 'utf-8');
+            const paragraphs = splitIntoParagraphs(content);
+            // Write each paragraph as L2 file
+            for (let i = 0; i < paragraphs.length; i++) {
+                const para = paragraphs[i];
+                const hour = String(i % 24).padStart(2, '0');
+                const minute = String((i * 7) % 60).padStart(2, '0');
+                const second = String((i * 13) % 60).padStart(2, '0');
+                const msgId = `${date.replace(/-/g, '')}_${String(i).padStart(4, '0')}`;
+                const l2Content = generateL2Content(para, sessionId, date, i);
+                const filename = `${hour}_${minute}_${second}_${msgId}.md`;
+                fs.writeFileSync(path.join(timelineDir, filename), l2Content, 'utf-8');
+            }
+            sessions.push(sessionId);
+            log?.(`Migrated ${date}: ${paragraphs.length} messages`);
+        }
+        catch (err) {
+            const errorMsg = `Failed to migrate ${logPath}: ${err}`;
+            errors.push(errorMsg);
+            log?.(`Error: ${errorMsg}`);
+        }
+    }
+    return {
+        count: dailyLogs.length,
+        sessions,
+        errors,
+    };
+}
+/**
+ * Migrate MEMORY.md to user preferences
+ */
+async function migrateMemoryMd(ocWorkspace, dataDir, log) {
+    const memoryMdPath = path.join(ocWorkspace, 'MEMORY.md');
+    if (!fs.existsSync(memoryMdPath)) {
+        log?.('No MEMORY.md found');
+        return { migrated: false };
+    }
+    try {
+        const userDir = path.join(dataDir, 'users', MIGRATION_TENANT);
+        fs.mkdirSync(userDir, { recursive: true });
+        const content = fs.readFileSync(memoryMdPath, 'utf-8');
+        const targetPath = path.join(userDir, 'preferences.md');
+        // Add header to indicate migration source
+        const migratedContent = `<!--
+Migrated from OpenClaw native MEMORY.md
+Original path: ${memoryMdPath}
+Migration date: ${new Date().toISOString()}
+-->
+${content}`;
+        fs.writeFileSync(targetPath, migratedContent, 'utf-8');
+        log?.('Migrated MEMORY.md to user preferences');
+        return { migrated: true };
+    }
+    catch (err) {
+        const error = `Failed to migrate MEMORY.md: ${err}`;
+        log?.(`Error: ${error}`);
+        return { migrated: false, error };
+    }
+}
+/**
+ * Generate L0/L1 layers using cortex-mem-cli
+ */
+async function generateLayers(configPath, tenant, log) {
+    log?.('Generating L0/L1 layers...');
+    const cliPath = (0, binaries_js_1.getCliPath)();
+    if (!cliPath) {
+        log?.('cortex-mem-cli not found, skipping layer generation');
+        return;
+    }
+    try {
+        const { stdout, stderr } = await execAsync(`"${cliPath}" --config "${configPath}" --tenant ${tenant} layers ensure-all`, { timeout: 300000 } // 5 minutes
+        );
+        if (stdout)
+            log?.(stdout);
+        if (stderr)
+            log?.(stderr);
+        log?.('Layer generation completed');
+    }
+    catch (err) {
+        log?.(`Layer generation warning: ${err}`);
+        // Don't throw - this is not critical for migration
+    }
+}
+/**
+ * Generate vector index using cortex-mem-cli
+ */
+async function generateVectorIndex(configPath, tenant, log) {
+    log?.('Generating vector index...');
+    const cliPath = (0, binaries_js_1.getCliPath)();
+    if (!cliPath) {
+        log?.('cortex-mem-cli not found, skipping vector index generation');
+        return;
+    }
+    try {
+        const { stdout, stderr } = await execAsync(`"${cliPath}" --config "${configPath}" --tenant ${tenant} vector reindex`, { timeout: 600000 } // 10 minutes
+        );
+        if (stdout)
+            log?.(stdout);
+        if (stderr)
+            log?.(stderr);
+        log?.('Vector index generation completed');
+    }
+    catch (err) {
+        log?.(`Vector index warning: ${err}`);
+        // Don't throw - this is not critical for migration
+    }
+}
+/**
+ * Main migration function
+ */
+async function migrateFromOpenClaw(log) {
+    const result = {
+        dailyLogsMigrated: 0,
+        memoryMdMigrated: false,
+        sessionsCreated: [],
+        errors: [],
+    };
+    log?.('Starting OpenClaw memory migration...');
+    // Find OpenClaw workspace
+    const ocWorkspace = findOpenClawWorkspace();
+    if (!ocWorkspace) {
+        const error = 'OpenClaw workspace not found at ~/.openclaw/workspace';
+        result.errors.push(error);
+        log?.(error);
+        return result;
+    }
+    log?.(`Found OpenClaw workspace: ${ocWorkspace}`);
+    const dataDir = (0, config_js_1.getDataDir)();
+    const configPath = (0, config_js_1.getConfigPath)();
+    // Migrate daily logs
+    const dailyResult = await migrateDailyLogs(ocWorkspace, dataDir, log);
+    result.dailyLogsMigrated = dailyResult.count;
+    result.sessionsCreated = dailyResult.sessions;
+    result.errors.push(...dailyResult.errors);
+    // Migrate MEMORY.md
+    const memoryMdResult = await migrateMemoryMd(ocWorkspace, dataDir, log);
+    result.memoryMdMigrated = memoryMdResult.migrated;
+    if (memoryMdResult.error) {
+        result.errors.push(memoryMdResult.error);
+    }
+    // Generate layers and index
+    if (result.dailyLogsMigrated > 0 || result.memoryMdMigrated) {
+        await generateLayers(configPath, MIGRATION_TENANT, log);
+        await generateVectorIndex(configPath, MIGRATION_TENANT, log);
+    }
+    log?.(`Migration completed: ${result.dailyLogsMigrated} daily logs, MEMORY.md: ${result.memoryMdMigrated}`);
+    return result;
+}
+/**
+ * Check if migration is possible
+ */
+function canMigrate() {
+    const ocWorkspace = findOpenClawWorkspace();
+    if (!ocWorkspace) {
+        return { possible: false, reason: 'OpenClaw workspace not found' };
+    }
+    const memoryDir = path.join(ocWorkspace, 'memory');
+    const memoryMd = path.join(ocWorkspace, 'MEMORY.md');
+    if (!fs.existsSync(memoryDir) && !fs.existsSync(memoryMd)) {
+        return { possible: false, reason: 'No memory files found in OpenClaw workspace' };
+    }
+    return { possible: true, reason: 'OpenClaw memory found and ready for migration' };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/src/migrate.js.map

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

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
 	"id": "memclaw",
 	"name": "MemClaw",
-	"version": "0.9.1",
+	"version": "0.9.3",
 	"description": "Layered semantic memory for OpenClaw with L0/L1/L2 tiered retrieval, easy setup, and migration from native memory",
 	"kind": "memory",
 	"skills": ["skill"],

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@memclaw/plugin",
-	"version": "0.9.1",
-	"description": "MemClaw - The Cortex Memory' plugin for OpenClaw. Layered semantic memory for OpenClaw with easy setup and migration",
+	"version": "0.9.3",
+	"description": "MemClaw - The Cortex Memory plugin for OpenClaw. Layered semantic memory for OpenClaw with easy setup and migration",
 	"publishConfig": {
 		"access": "public"
 	},

package/skill/SKILL.md

@@ -21,7 +21,22 @@ MemClaw provides **three-layer semantic memory** with tiered retrieval:
 
 The search engine queries all three layers internally and returns unified results with `snippet` and `content`.
 
-## Quick Decision Flow
+## Pre-Use Requirements
+
+**IMPORTANT**: Before using MemClaw for the first time, you MUST ensure:
+
+1. **Qdrant** is running on port 6333/6334
+2. **cortex-mem-service** is running on port 8085 with `--data-dir` and valid `config.toml`
+3. **LLM/Embedding API keys** are configured in `config.toml`
+
+**Manual Configuration Required**: Users must manually configure the following in `config.toml`:
+- `llm.api_key` — LLM API key for memory processing
+- `embedding.api_key` — Embedding API key for vector search
+- `llm.api_base_url` / `embedding.api_base_url` — API endpoints (if not using OpenAI default)
+
+> **See `references/setup.md`** for complete installation, service setup, and configuration instructions.
+
+## Decision Flow
 
 1. **Need to find something** → `cortex_search`
 2. **Need more context** → `cortex_recall`
@@ -64,11 +79,14 @@ The search engine queries all three layers internally and returns unified result
 | Services won't start | Check ports 6333, 6334, 8085; verify `api_key` in config.toml |
 | Search returns no results | Run `cortex_list_sessions` to verify; lower `min_score` threshold |
 | Migration fails | Ensure OpenClaw workspace at `~/.openclaw/workspace` |
+| cortex-mem-service fails | Ensure `--data-dir` is set and `config.toml` exists in that directory |
+| LLM/Embedding errors | Verify `llm.api_key` and `embedding.api_key` are configured in `config.toml` |
+| Platform not supported | MemClaw supports macOS Apple Silicon and Windows x64 only |
 
 ## References
 
 For detailed information, see:
 
-- **`references/setup.md`** — Installation and configuration guide
+- **`references/setup.md`** — Installation, service setup, and configuration guide
 - **`references/tools.md`** — Detailed tool parameters and examples
-- **`references/maintenance.md`** — CLI commands for data maintenance and optimization
+- **`references/maintenance.md`** — CLI commands for data maintenance and optimization