@memclaw/memclaw 0.9.18 → 0.9.19

package/dist/index.js

@@ -38,7 +38,7 @@ function memclawPlugin(api) {
 exports.plugin = {
     id: 'memclaw',
     name: 'MemClaw',
-    version: '0.9.18',
+    version: '0.9.19',
     configSchema: {
         type: 'object',
         properties: {

package/openclaw.plugin.json

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

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@memclaw/memclaw",
-	"version": "0.9.18",
+	"version": "0.9.19",
 	"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",
+		"url": "git+https://github.com/sopaco/cortex-mem.git",
 		"directory": "examples/@memclaw/plugin"
 	},
 	"bugs": {
@@ -48,7 +48,7 @@
 		"glob": "^11.0.0"
 	},
 	"optionalDependencies": {
-		"@memclaw/bin-darwin-arm64": "0.1.0",
+		"@memclaw/bin-darwin-arm64": "0.1.2",
 		"@memclaw/bin-win-x64": "0.1.0"
 	},
 	"engines": {

package/skills/memclaw/SKILL.md

@@ -23,7 +23,7 @@ See [security.md](./references/security.md) for details on data handling, storag
 
 ## Configuration
 
-All configuration is managed through OpenClaw plugin settings. However, when the plugin is first used, incomplete configuration items may cause it to fail. If the plugin or tools cannot be used, proactively inform the user and assist in completing the necessary configurations. For details, refer to the 'Troubleshooting' section in the skill of `memclaw-maintance`.
+All configuration is managed through OpenClaw plugin settings. However, when the plugin is first used, incomplete configuration items may cause it to fail. If the plugin or tools cannot be used, proactively inform the user and assist in completing the necessary configurations. For details, refer to the 'Troubleshooting' section below.
 
 ## Tool Selection Guide
 
@@ -215,11 +215,47 @@ Recommended workflow:
 3. Use matches with requested layers
 ```
 
+## Troubleshooting
+
+If MemClaw is not working properly, follow these steps:
+
+### Step 1: Check Plugin Configuration
+
+Open OpenClaw settings and verify MemClaw plugin configuration:
+
+1. Open `openclaw.json` or navigate to Settings → Plugins → MemClaw
+2. Ensure all required fields are correctly filled, especially the configuration sections related to LLM and Embedding.
+3. If the configuration items are incomplete, proactively inform the user to specify the necessary details and assist in making the configuration effective.
+4. Save changes and **restart OpenClaw Gateway** for changes to take effect
+
+### Step 2: Restart OpenClaw Gateway
+
+After making configuration changes and saved, **you MUST restart OpenClaw Gateway** for the changes to take effect.
+
+### Step 3: Verify Services
+
+If issues persist after restart:
+- Run `cortex_ls` to check if the service is responding
+- Check if Qdrant and cortex-mem-service are running (auto-start should handle this)
+
+| Issue | Solution |
+|-------|----------|
+| No search results | Run `cortex_list_sessions` to verify; lower `min_score` threshold; ensure memories have been stored |
+| Service connection errors | Verify `serviceUrl` is correct; check if services are running |
+| LLM/Embedding errors | Verify API URLs and credentials in plugin configuration; restart OpenClaw Gateway after changes |
+
+Check that Qdrant and cortex-mem-service are accessible:
+> Note: MemClaw does not require users to install any Docker environment. All dependencies are prepared during the openclaw's memclaw plugin installation.
+
+| Service | Port | Health Check |
+|---------|------|--------------|
+| Qdrant | 6333 (HTTP), 6334 (gRPC) | HTTP GET to `http://localhost:6333` should return Qdrant version info |
+| cortex-mem-service | 8085 | HTTP GET to `http://localhost:8085/health` should return `{"status":"ok"}` |
+
 ## Memory Structure
 
 See [memory-structure.md](./references/memory-structure.md) for complete documentation of:
 - URI structure and dimensions
-- Three-layer architecture (L0/L1/L2)
 - Session memory and timeline organization
 - User and agent memory categories
 - session_id configuration
@@ -229,4 +265,4 @@ See [memory-structure.md](./references/memory-structure.md) for complete documen
 - [tools.md](./references/tools.md) - Detailed tool documentation
 - [best-practices.md](./references/best-practices.md) - Advanced patterns
 - [security.md](./references/security.md) - Security and trust information
-- [memory-structure.md](./references/memory-structure.md) - Complete memory structure documentation
+- [memory-structure.md](./references/memory-structure.md) - Complete memory structure documentation

package/skills/memclaw-maintance/SKILL.md

@@ -62,13 +62,12 @@ Enable MemClaw in `openclaw.json`:
 
 **API keys are required to use MemClaw.**
 
-1. Open OpenClaw settings (`openclaw.json` or via UI)
-2. Navigate to Plugins → MemClaw → Configuration
-3. Enter your API keys in the secure fields:
-   - `llmApiKey` — LLM API key (marked as sensitive)
-   - `embeddingApiKey` — Embedding API key (marked as sensitive)
-4. Optional: Customize API endpoints and model names
-5. Save and restart OpenClaw
+Open OpenClaw settings and verify MemClaw plugin configuration:
+
+1. Open `openclaw.json` or navigate to Settings → Plugins → MemClaw
+2. Ensure all required fields are correctly filled, especially the configuration sections related to LLM and Embedding.
+3. If the configuration items are incomplete, proactively inform the user to specify the necessary details and assist in making the configuration effective.
+4. Save changes and **restart OpenClaw Gateway** for changes to take effect
 
 **Configuration Example:**
 

package/skills/memclaw-maintance/references/troubleshooting.md

@@ -38,9 +38,12 @@ Common MemClaw issues and their solutions.
 **Symptoms**: Service behavior doesn't change after modifying configuration
 
 **Solutions**:
-1. Ensure configuration file was saved
-2. Restart OpenClaw to apply changes
-3. Check configuration file syntax for errors (JSON format)
+Open OpenClaw settings and verify MemClaw plugin configuration:
+
+1. Open `openclaw.json` or navigate to Settings → Plugins → MemClaw
+2. Ensure all required fields are correctly filled, especially the configuration sections related to LLM and Embedding.
+3. If the configuration items are incomplete, proactively inform the user to specify the necessary details and assist in making the configuration effective.
+4. Save changes and **restart OpenClaw Gateway** for changes to take effect
 
 ## Service Issues
 
@@ -131,4 +134,4 @@ If the above solutions don't resolve your issue:
    - OpenClaw version
    - MemClaw plugin version
    - Relevant log snippets
-   - Steps to reproduce
+   - Steps to reproduce