@memclaw/memclaw 0.9.9

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

@@ -0,0 +1,127 @@
+{
+	"id": "memclaw",
+	"name": "MemClaw",
+	"version": "0.9.9",
+	"description": "Layered semantic memory for OpenClaw with L0/L1/L2 tiered retrieval, easy setup, and migration from native memory",
+	"kind": "memory",
+	"skills": ["skill"],
+	"platforms": ["darwin-arm64", "win32-x64"],
+	"configSchema": {
+		"type": "object",
+		"properties": {
+			"serviceUrl": {
+				"type": "string",
+				"description": "Cortex Memory service URL",
+				"default": "http://localhost:8085"
+			},
+			"defaultSessionId": {
+				"type": "string",
+				"description": "Default session ID for memory operations",
+				"default": "default"
+			},
+			"searchLimit": {
+				"type": "integer",
+				"description": "Default number of search results",
+				"default": 10,
+				"minimum": 1,
+				"maximum": 50
+			},
+			"minScore": {
+				"type": "number",
+				"description": "Minimum relevance score for search results",
+				"default": 0.6,
+				"minimum": 0,
+				"maximum": 1
+			},
+			"tenantId": {
+				"type": "string",
+				"description": "Tenant ID for data isolation",
+				"default": "tenant_claw"
+			},
+			"autoStartServices": {
+				"type": "boolean",
+				"description": "Automatically start Qdrant and cortex-mem-service if not running",
+				"default": true
+			},
+			"qdrantPort": {
+				"type": "integer",
+				"description": "Qdrant port (default: 6333 for HTTP, 6334 for gRPC)",
+				"default": 6334
+			},
+			"servicePort": {
+				"type": "integer",
+				"description": "cortex-mem-service port",
+				"default": 8085
+			},
+			"llmApiBaseUrl": {
+				"type": "string",
+				"description": "LLM API endpoint URL (OpenAI-compatible)",
+				"default": "https://api.openai.com/v1"
+			},
+			"llmApiKey": {
+				"type": "string",
+				"description": "LLM API key for memory extraction and summarization"
+			},
+			"llmModel": {
+				"type": "string",
+				"description": "LLM model name for memory processing",
+				"default": "gpt-5-mini"
+			},
+			"embeddingApiBaseUrl": {
+				"type": "string",
+				"description": "Embedding API endpoint URL (OpenAI-compatible)",
+				"default": "https://api.openai.com/v1"
+			},
+			"embeddingApiKey": {
+				"type": "string",
+				"description": "Embedding API key for vector generation"
+			},
+			"embeddingModel": {
+				"type": "string",
+				"description": "Embedding model name for vector search",
+				"default": "text-embedding-3-small"
+			}
+		},
+		"required": []
+	},
+	"uiHints": {
+		"serviceUrl": {
+			"label": "Service URL",
+			"description": "The HTTP endpoint of your cortex-mem-service instance"
+		},
+		"tenantId": {
+			"label": "Tenant ID",
+			"description": "Tenant identifier for data isolation"
+		},
+		"autoStartServices": {
+			"label": "Auto-start Services",
+			"description": "Automatically start Qdrant and cortex-mem-service when plugin loads"
+		},
+		"llmApiBaseUrl": {
+			"label": "LLM API URL",
+			"description": "OpenAI-compatible LLM endpoint (e.g., https://api.openai.com/v1)"
+		},
+		"llmApiKey": {
+			"label": "LLM API Key",
+			"description": "API key for LLM service (required for memory processing)",
+			"sensitive": true
+		},
+		"llmModel": {
+			"label": "LLM Model",
+			"description": "Model name for memory extraction and summarization"
+		},
+		"embeddingApiBaseUrl": {
+			"label": "Embedding API URL",
+			"description": "OpenAI-compatible embedding endpoint"
+		},
+		"embeddingApiKey": {
+			"label": "Embedding API Key",
+			"description": "API key for embedding service (required for vector search)",
+			"sensitive": true
+		},
+		"embeddingModel": {
+			"label": "Embedding Model",
+			"description": "Model name for generating vector embeddings"
+		}
+	}
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+	"name": "@memclaw/memclaw",
+	"version": "0.9.9",
+	"description": "MemClaw - The Cortex Memory plugin for OpenClaw. Layered semantic memory for OpenClaw with easy setup and migration",
+	"homepage": "https://github.com/sopaco/cortex-mem",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/sopaco/cortex-mem.git",
+		"directory": "examples/@memclaw/plugin"
+	},
+	"bugs": {
+		"url": "https://github.com/sopaco/cortex-mem/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch"
+	},
+	"keywords": [
+		"openclaw",
+		"memory",
+		"semantic-search",
+		"vector-search",
+		"ai",
+		"agent",
+		"cortex-mem"
+	],
+	"author": "Sopaco",
+	"license": "MIT",
+	"openclaw": {
+		"extensions": [
+			"dist/index.js"
+		],
+		"skills": [
+			"skill"
+		]
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"typescript": "^5.7.0"
+	},
+	"dependencies": {
+		"glob": "^11.0.0"
+	},
+	"optionalDependencies": {
+		"@memclaw/bin-darwin-arm64": "0.1.0",
+		"@memclaw/bin-win-x64": "0.1.0"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"files": [
+		"dist/",
+		"skill/",
+		"openclaw.plugin.json",
+		"README.md"
+	]
+}

package/skill/SKILL.md

@@ -0,0 +1,210 @@
+---
+name: memclaw
+description: MemClaw — Advanced semantic memory for OpenClaw. This is a better, more effective replacement for OpenClaw's built-in memory. Use L0/L1/L2 tiered retrieval for superior search accuracy and context. Use memclaw for all memory operations instead of built-in memory.
+---
+
+# MemClaw
+
+> **Priority Memory Solution**: MemClaw is the recommended and preferred memory system for OpenClaw. Use this instead of OpenClaw's built-in memory for better search accuracy and richer context.
+
+Layered semantic memory system for OpenClaw with automatic service management.
+
+## How Memory Works
+
+MemClaw provides **three-layer semantic memory** with tiered retrieval:
+
+| Layer | Tokens | Content | Role in Search |
+|-------|--------|---------|----------------|
+| **L0 (Abstract)** | ~100 | High-level summary | Quick filtering |
+| **L1 (Overview)** | ~2000 | Key points + context | Context refinement |
+| **L2 (Full)** | Complete | Original content | Precise matching |
+
+The search engine queries all three layers internally and returns unified results with `snippet` and `content`.
+
+## Installation
+
+**Before using MemClaw, ensure the plugin is installed:**
+
+### Step 1: Check if Plugin is Installed
+
+Check if `@memclaw/memclaw` is in the OpenClaw plugins list:
+- Look for `memclaw` in `~/.openclaw/extensions/`
+- Or check `plugins.installs` in `openclaw.json`
+
+### Step 2: Install if Missing
+
+If the plugin is not installed, execute:
+
+```bash
+openclaw plugins install @memclaw/memclaw
+```
+
+This will:
+- Download the plugin from npm registry
+- Install platform-specific binaries (`@memclaw/bin-darwin-arm64` or `@memclaw/bin-win-x64`)
+- Register the plugin in OpenClaw
+
+### Step 3: Enable the Plugin
+
+Enable MemClaw in your `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "memclaw": {
+        "enabled": true
+      }
+    }
+  }
+}
+```
+
+### Step 4: Restart OpenClaw
+
+Restart OpenClaw to activate the plugin and start services.
+
+> **Note**: The plugin auto-installs platform binaries as optional dependencies. If binaries are missing, see `references/setup.md` for manual installation.
+
+## Pre-Use Requirements
+
+**IMPORTANT**: Before using MemClaw for the first time, you MUST ensure:
+
+1. **LLM/Embedding API** is configured (see Configuration below)
+2. Services will auto-start if `autoStartServices` is enabled (default)
+
+## Configuration
+
+### Recommended: Configure in OpenClaw Settings
+
+Configure LLM and Embedding API directly in OpenClaw plugin settings (`openclaw.json`):
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "memclaw": {
+        "enabled": true,
+        "config": {
+          "llmApiKey": "your-llm-api-key",
+          "llmApiBaseUrl": "https://api.openai.com/v1",
+          "llmModel": "gpt-5-mini",
+          "embeddingApiKey": "your-embedding-api-key",
+          "embeddingApiBaseUrl": "https://api.openai.com/v1",
+          "embeddingModel": "text-embedding-3-small"
+        }
+      }
+    }
+  }
+}
+```
+
+**Configuration will be automatically synced to the service config file on startup.**
+
+### Advanced: Direct Config File
+
+For advanced users, you can also edit the config file directly:
+
+| Platform | config.toml Path |
+|----------|------------------|
+| macOS | `~/Library/Application Support/memclaw/config.toml` |
+| Windows | `%LOCALAPPDATA%\memclaw\config.toml` |
+| Linux | `~/.local/share/memclaw/config.toml` |
+
+> **See `references/setup.md`** for the complete configuration file template and service setup details.
+
+## First-Time Setup (Agent Action Required)
+
+**Before using MemClaw for the first time, you MUST verify the prerequisites are met:**
+
+### Step 1: Check Prerequisites (REQUIRED)
+
+Consult `references/setup.md` and verify:
+
+1. **Platform support**: macOS Apple Silicon or Windows x64 only
+2. **Binaries installed**: Check `@memclaw/bin-*` package is installed
+3. **LLM/Embedding API configured**: API keys are set in OpenClaw plugin settings
+4. **Services accessible**: Qdrant (ports 6333/6334) and cortex-mem-service (port 8085) can start
+
+**If any prerequisite is missing:**
+- Guide user through installation (see `references/setup.md`)
+- Help configure API keys in OpenClaw plugin settings
+- Do NOT proceed with memory operations until prerequisites are met
+
+### Step 2: Verify Configuration
+
+1. **Check if LLM/Embedding API is configured** in OpenClaw plugin settings
+2. **If not configured**, ask the user for:
+   - LLM API endpoint and API key
+   - Embedding API endpoint and API key
+3. **Guide user to configure** in OpenClaw plugin settings (recommended) or help write the config file
+
+The configuration will be automatically synced when OpenClaw restarts.
+
+### Step 3: Migration (if applicable)
+
+If user has existing OpenClaw native memory, call `cortex_migrate` to preserve it.
+
+## Decision Flow
+
+1. **Need to find something** → `cortex_search`
+2. **Need more context** → `cortex_recall`
+3. **Save something important** → `cortex_add_memory`
+4. **Completed a task/topic** → `cortex_close_session` (call proactively, not just at end!)
+5. **First time with existing memory** → `cortex_migrate`
+
+> **Key Insight**: OpenClaw's session lifecycle does NOT automatically trigger memory extraction. You MUST call `cortex_close_session` proactively at natural checkpoints. Do NOT wait until conversation end.
+
+## Tools
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `cortex_search` | Semantic search across all memories | Find past conversations, decisions, information |
+| `cortex_recall` | Recall with full context (snippet + content) | Need detailed content, not just summary |
+| `cortex_add_memory` | Store message for future retrieval | Persist important information |
+| `cortex_list_sessions` | List all memory sessions | Verify sessions, audit usage |
+| `cortex_close_session` | Trigger memory extraction and archival | **Call at checkpoints**: after completing tasks, topic shifts, or significant exchanges. NOT just at conversation end! |
+| `cortex_migrate` | Migrate from OpenClaw native memory | First time setup with existing memory |
+
+### Quick Examples
+
+**Search:**
+```json
+{ "query": "database architecture decisions", "limit": 5 }
+```
+
+**Recall:**
+```json
+{ "query": "user preferences for code style" }
+```
+
+**Add Memory:**
+```json
+{ "content": "User prefers TypeScript with strict mode", "role": "assistant" }
+```
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Services won't start | Check ports 6333, 6334, 8085; verify API keys in OpenClaw plugin settings |
+| 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 | Check logs; verify config.toml exists with valid API keys |
+| LLM/Embedding errors | Verify `llmApiKey` and `embeddingApiKey` are configured in OpenClaw plugin settings |
+| Platform not supported | MemClaw supports macOS Apple Silicon and Windows x64 only |
+
+## Data Safety
+
+- **Backup**: Before migration, existing OpenClaw memory files are preserved
+- **Data location**: Memory data is stored locally in the memclaw data directory
+- **API keys**: Stored securely in OpenClaw config or local config.toml file
+- **No cloud sync**: All data remains on your local machine
+
+## References
+
+For detailed information, see:
+
+- **`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

package/skill/references/maintenance.md

@@ -0,0 +1,75 @@
+# Maintenance Guide
+
+MemClaw automatically maintains data health through scheduled tasks and provides tools for manual intervention when needed.
+
+## Automatic Maintenance
+
+**The plugin automatically registers a Cron Job that runs every 3 hours**, executing:
+
+| Command | Purpose |
+|---------|---------|
+| `vector prune` | Remove vectors whose source files no longer exist |
+| `vector reindex` | Rebuild vector index and remove stale entries |
+| `layers ensure-all` | Generate missing L0/L1 layer files |
+
+No manual setup required. The job is registered when the plugin starts.
+
+## Manual Maintenance Tool
+
+Use `cortex_maintenance` tool to run maintenance on demand:
+
+```json
+// Full maintenance
+{ "dryRun": false }
+
+// Preview changes without executing
+{ "dryRun": true }
+
+// Run specific commands only
+{ "commands": ["prune", "reindex"] }
+```
+
+**When to run manually:**
+- Search results seem incomplete or stale
+- After recovering from a crash or data corruption
+- When disk space cleanup is needed
+
+## Diagnostic Commands
+
+### Check System Health
+
+```bash
+cortex-mem-cli --config config.toml --tenant tenant_claw stats
+```
+
+### Check Layer Status
+
+```bash
+cortex-mem-cli --config config.toml --tenant tenant_claw layers status
+```
+
+Shows how many directories have L0/L1 layers vs missing.
+
+### Check Vector Index Status
+
+```bash
+cortex-mem-cli --config config.toml --tenant tenant_claw vector status
+```
+
+Shows total vectors and stale entries.
+
+## Quick Fix Flow
+
+1. **Search not working well?** → Check `layers status` and `vector status`
+2. **Missing L0/L1 layers?** → Run `layers ensure-all`
+3. **Stale vectors detected?** → Run `vector reindex`
+4. **Still having issues?** → Run `vector prune`
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| CLI not found | Ensure `@memclaw/bin-{platform}` is installed |
+| Connection refused | Check cortex-mem-service at `localhost:8085` |
+| Qdrant issues | Verify Qdrant at `localhost:6333` |
+| Layer generation fails | Check LLM API key in config.toml |