@memclaw/memclaw 0.9.9 → 0.9.11

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
 	"id": "memclaw",
 	"name": "MemClaw",
-	"version": "0.9.9",
+	"version": "0.9.11",
 	"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,6 +1,6 @@
 {
 	"name": "@memclaw/memclaw",
-	"version": "0.9.9",
+	"version": "0.9.11",
 	"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": {

package/skill/SKILL.md

@@ -28,8 +28,10 @@ The search engine queries all three layers internally and returns unified result
 ### 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`
+- Look for `memclaw` in `{claw-data-dir}/extensions/`
+- Or check `plugins.installs` in your Claw config file
+
+> **Note**: `{claw-data-dir}` is typically `~/.openclaw` for standard OpenClaw. Use your actual Claw data directory for custom versions.
 
 ### Step 2: Install if Missing
 
@@ -64,7 +66,23 @@ Enable MemClaw in your `openclaw.json`:
 
 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.
+## Binary File Locations
+
+The platform-specific binaries (Qdrant, cortex-mem-service, cortex-mem-cli) are installed in:
+
+| Platform | Binary Path |
+|----------|-------------|
+| macOS | `{claw-data-dir}/extensions/memclaw/node_modules/@memclaw/bin-darwin-arm64/bin/` |
+| Windows | `{claw-data-dir}\extensions\memclaw\node_modules\@memclaw\bin-win-x64\bin\` |
+
+> **Note**: `{claw-data-dir}` is typically `~/.openclaw` for standard OpenClaw. For custom or modified versions, check your Claw's actual data directory name.
+
+**Binaries included:**
+- `qdrant` / `qdrant.exe` — Vector database
+- `cortex-mem-service` / `cortex-mem-service.exe` — Memory service
+- `cortex-mem-cli` / `cortex-mem-cli.exe` — CLI tool
+
+> **Note**: The plugin auto-starts these services. You don't need to run them manually.
 
 ## Pre-Use Requirements
 

package/skill/references/maintenance.md

@@ -1,42 +1,81 @@
 # Maintenance Guide
 
-MemClaw automatically maintains data health through scheduled tasks and provides tools for manual intervention when needed.
+Periodic maintenance commands for MemClaw data health.
 
-## Automatic Maintenance
+## CLI Tool Location
 
-**The plugin automatically registers a Cron Job that runs every 3 hours**, executing:
+The `cortex-mem-cli` tool is installed with the platform-specific binary package:
 
-| 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 |
+| Platform | CLI Path |
+|----------|----------|
+| macOS | `{claw-data-dir}/extensions/memclaw/node_modules/@memclaw/bin-darwin-arm64/bin/cortex-mem-cli` |
+| Windows | `{claw-data-dir}\extensions\memclaw\node_modules\@memclaw\bin-win-x64\bin\cortex-mem-cli.exe` |
 
-No manual setup required. The job is registered when the plugin starts.
+> **Note**: `{claw-data-dir}` is typically `~/.openclaw` for standard OpenClaw. Use your actual Claw data directory for custom versions.
 
-## Manual Maintenance Tool
+## Maintenance Commands
 
-Use `cortex_maintenance` tool to run maintenance on demand:
+All commands require `--config` and `--tenant` parameters:
 
-```json
-// Full maintenance
-{ "dryRun": false }
+```bash
+cortex-mem-cli --config <config-path> --tenant tenant_claw <command>
+```
 
-// Preview changes without executing
-{ "dryRun": true }
+Config file location:
+- macOS: `~/Library/Application Support/memclaw/config.toml`
+- Windows: `%LOCALAPPDATA%\memclaw\config.toml`
+
+### Vector Maintenance
+
+```bash
+# Remove dangling vectors (source files no longer exist)
+cortex-mem-cli --config config.toml --tenant tenant_claw vector prune
+
+# Preview without making changes
+cortex-mem-cli --config config.toml --tenant tenant_claw vector prune --dry-run
+
+# Rebuild vector index
+cortex-mem-cli --config config.toml --tenant tenant_claw vector reindex
+```
+
+### Layer Maintenance
+
+```bash
+# Generate missing L0/L1 layer files
+cortex-mem-cli --config config.toml --tenant tenant_claw layers ensure-all
 
-// Run specific commands only
-{ "commands": ["prune", "reindex"] }
+# Regenerate oversized abstracts
+cortex-mem-cli --config config.toml --tenant tenant_claw layers regenerate-oversized
 ```
 
-**When to run manually:**
-- Search results seem incomplete or stale
-- After recovering from a crash or data corruption
-- When disk space cleanup is needed
+## Scheduled Maintenance
+
+**You can set up a scheduled task in OpenClaw to run maintenance automatically:**
+
+### Option 1: OpenClaw Cron Job
+
+Create a Cron Job in OpenClaw that runs every 3 hours:
+
+1. **Schedule**: `0 */3 * * *`
+2. **Task**: Execute maintenance commands using the CLI tool
+3. **Commands**:
+   ```
+   cortex-mem-cli --config <config-path> --tenant tenant_claw vector prune
+   cortex-mem-cli --config <config-path> --tenant tenant_claw vector reindex
+   cortex-mem-cli --config <config-path> --tenant tenant_claw layers ensure-all
+   ```
+
+### Option 2: Manual Tool Invocation
+
+Use the `cortex_maintenance` tool for on-demand maintenance:
+
+```json
+{ "dryRun": false }
+```
 
 ## Diagnostic Commands
 
-### Check System Health
+### Check System Status
 
 ```bash
 cortex-mem-cli --config config.toml --tenant tenant_claw stats
@@ -48,16 +87,12 @@ cortex-mem-cli --config config.toml --tenant tenant_claw stats
 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
+### Check Vector 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`
@@ -69,7 +104,7 @@ Shows total vectors and stale entries.
 
 | Issue | Solution |
 |-------|----------|
-| CLI not found | Ensure `@memclaw/bin-{platform}` is installed |
+| CLI not found | Check the binary path in `{claw-data-dir}/extensions/memclaw/node_modules/@memclaw/bin-{platform}/bin/` |
 | 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 |

package/skill/references/setup.md

@@ -29,6 +29,34 @@ MemClaw binaries (Qdrant, cortex-mem-service, cortex-mem-cli) are distributed vi
 
 These packages are installed automatically as optional dependencies when installing `@memclaw/memclaw`.
 
+### Binary Locations After Installation
+
+When installed via OpenClaw (`openclaw plugins install @memclaw/memclaw`), binaries are located at:
+
+| Platform | Path |
+|----------|------|
+| macOS | `{claw-data-dir}/extensions/memclaw/node_modules/@memclaw/bin-darwin-arm64/bin/` |
+| Windows | `{claw-data-dir}\extensions\memclaw\node_modules\@memclaw\bin-win-x64\bin\` |
+
+> **Note**: `{claw-data-dir}` is typically `~/.openclaw` for standard OpenClaw. For custom or modified Claw versions, replace with your actual Claw data directory (e.g., `~/.claw`, `~/.myclaw`, etc.).
+
+**Binaries included:**
+- `qdrant` (or `qdrant.exe`) — Vector database server
+- `cortex-mem-service` (or `cortex-mem-service.exe`) — Memory extraction service
+- `cortex-mem-cli` (or `cortex-mem-cli.exe`) — Command-line maintenance tool
+
+### Verify Binary Installation
+
+Check if binaries exist:
+
+```bash
+# macOS (adjust claw-data-dir as needed)
+ls ~/.openclaw/extensions/memclaw/node_modules/@memclaw/bin-darwin-arm64/bin/
+
+# Windows (adjust claw-data-dir as needed)
+dir %USERPROFILE%\.openclaw\extensions\memclaw\node_modules\@memclaw\bin-win-x64\bin\
+```
+
 ### Manual Binary Installation
 
 If binaries are not installed, run:
@@ -103,7 +131,7 @@ api_base_url = "https://your-llm-provider.com/v1"
 api_key = "your-api-key-here"
 model_efficient = "gpt-5-mini"
 temperature = 0.1
-max_tokens = 4096
+max_tokens = 65536
 
 # Embedding Configuration [REQUIRED]
 [embedding]