diff --git a/examples/@memclaw/README.md b/examples/@memclaw/README.md new file mode 100644 index 0000000..3ab4631 --- /dev/null +++ b/examples/@memclaw/README.md @@ -0,0 +1,21 @@ +# MemClaw Project Independence Announcement + +## About @memclaw + +MemClaw has become a mature project in the ClawHub community and has now been **moved to an independent repository for maintenance**. + +## New Project Location + +🔗 **Official Repository**: https://github.com/sopaco/memclaw + +## Note + +This `@memclaw` example has been separated from the Cortex Memory project. All future development, updates, and maintenance will be carried out in the independent repository. This example in the Cortex Memory repository will be kept as a historical reference but will no longer receive synchronized updates. + +## Next Steps + +- Visit https://github.com/sopaco/memclaw for the latest version +- Submit Issues or PRs in the independent repository for any questions or suggestions +- Continue to follow updates of other Cortex Memory components + +Thank you for your understanding and support! \ No newline at end of file diff --git a/examples/@memclaw/bin-darwin-arm64/.gitattributes b/examples/@memclaw/bin-darwin-arm64/.gitattributes deleted file mode 100644 index ca2fc43..0000000 --- a/examples/@memclaw/bin-darwin-arm64/.gitattributes +++ /dev/null @@ -1 +0,0 @@ -bin/* filter=lfs diff=lfs merge=lfs -text diff --git a/examples/@memclaw/bin-darwin-arm64/.gitignore b/examples/@memclaw/bin-darwin-arm64/.gitignore deleted file mode 100644 index 91cda48..0000000 --- a/examples/@memclaw/bin-darwin-arm64/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -# Dependencies -node_modules/ - -# Build artifacts -*.tsbuildinfo diff --git a/examples/@memclaw/bin-darwin-arm64/bin/README.md b/examples/@memclaw/bin-darwin-arm64/bin/README.md deleted file mode 100644 index fcddc68..0000000 --- a/examples/@memclaw/bin-darwin-arm64/bin/README.md +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:ba0958e1dcbda5b347b783c1f524312a026d1919027385e2195b24c75653ed2e -size 560 diff --git a/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-cli b/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-cli deleted file mode 100755 index 1218b0c..0000000 --- a/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-cli +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:05ee450a4bcf870a97cc9415b47444cdf63b868d65913a91d75115fb7cf1774f -size 18273216 diff --git a/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-service b/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-service deleted file mode 100755 index 3d6889e..0000000 --- a/examples/@memclaw/bin-darwin-arm64/bin/cortex-mem-service +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:c5eeb9abdafa84cae81eff6fd0209164177f5247b06ed97fb65c72122006a748 -size 18432032 diff --git a/examples/@memclaw/bin-darwin-arm64/bin/qdrant b/examples/@memclaw/bin-darwin-arm64/bin/qdrant deleted file mode 100644 index d5626d2..0000000 --- a/examples/@memclaw/bin-darwin-arm64/bin/qdrant +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:dccb9eb8fac8a8bb3cad10ade931c4f61ceeed4723c6442193ffe2e970b9c844 -size 64870688 diff --git a/examples/@memclaw/bin-darwin-arm64/package.json b/examples/@memclaw/bin-darwin-arm64/package.json deleted file mode 100644 index 3e8b32a..0000000 --- a/examples/@memclaw/bin-darwin-arm64/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "@memclaw/bin-darwin-arm64", - "version": "0.1.9", - "description": "MemClaw binaries for macOS Apple Silicon", - "publishConfig": { - "access": "public" - }, - "os": [ - "darwin" - ], - "cpu": [ - "arm64" - ], - "files": [ - "bin/" - ], - "author": "Sopaco", - "license": "MIT", - "repository": { - "type": "git", - "url": "git+https://github.com/sopaco/cortex-mem.git", - "directory": "examples/@memclaw/bin-darwin-arm64" - } -} diff --git a/examples/@memclaw/bin-linux-x64/.gitattributes b/examples/@memclaw/bin-linux-x64/.gitattributes deleted file mode 100644 index ca2fc43..0000000 --- a/examples/@memclaw/bin-linux-x64/.gitattributes +++ /dev/null @@ -1 +0,0 @@ -bin/* filter=lfs diff=lfs merge=lfs -text diff --git a/examples/@memclaw/bin-linux-x64/.gitignore b/examples/@memclaw/bin-linux-x64/.gitignore deleted file mode 100644 index 91cda48..0000000 --- a/examples/@memclaw/bin-linux-x64/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -# Dependencies -node_modules/ - -# Build artifacts -*.tsbuildinfo diff --git a/examples/@memclaw/bin-linux-x64/bin/README.md b/examples/@memclaw/bin-linux-x64/bin/README.md deleted file mode 100644 index 3c062a8..0000000 --- a/examples/@memclaw/bin-linux-x64/bin/README.md +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:be1f882d79722f7ec7a2f43dac9e0d62377c508046503c4432f71840ca3dc684 -size 722 diff --git a/examples/@memclaw/bin-linux-x64/bin/cortex-mem-cli b/examples/@memclaw/bin-linux-x64/bin/cortex-mem-cli deleted file mode 100755 index fc41e36..0000000 --- a/examples/@memclaw/bin-linux-x64/bin/cortex-mem-cli +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:78765d40320710d6a810d0df998f1a2a1527180938191465a88b1ccbd995d33d -size 21907552 diff --git a/examples/@memclaw/bin-linux-x64/bin/cortex-mem-service b/examples/@memclaw/bin-linux-x64/bin/cortex-mem-service deleted file mode 100755 index dcc0989..0000000 --- a/examples/@memclaw/bin-linux-x64/bin/cortex-mem-service +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:04901c7918a3803fa2452c8ca45a01f827ab39af965c56cdcd151f4e0b0eaac0 -size 22087824 diff --git a/examples/@memclaw/bin-linux-x64/bin/qdrant b/examples/@memclaw/bin-linux-x64/bin/qdrant deleted file mode 100755 index 19d7bad..0000000 --- a/examples/@memclaw/bin-linux-x64/bin/qdrant +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:81a2f53592b6561bd1399ee219d1b853a528448fbe2be0515d2ebad1c953ef45 -size 78777440 diff --git a/examples/@memclaw/bin-linux-x64/package.json b/examples/@memclaw/bin-linux-x64/package.json deleted file mode 100644 index 9a057ef..0000000 --- a/examples/@memclaw/bin-linux-x64/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "@memclaw/bin-linux-x64", - "version": "0.1.9", - "description": "MemClaw binaries for Linux x64", - "publishConfig": { - "access": "public" - }, - "os": [ - "linux" - ], - "cpu": [ - "x64" - ], - "files": [ - "bin/" - ], - "author": "Sopaco", - "license": "MIT", - "repository": { - "type": "git", - "url": "git+https://github.com/sopaco/cortex-mem.git", - "directory": "examples/@memclaw/bin-linux-x64" - } -} diff --git a/examples/@memclaw/bin-win-x64/.gitattributes b/examples/@memclaw/bin-win-x64/.gitattributes deleted file mode 100644 index 5135af0..0000000 --- a/examples/@memclaw/bin-win-x64/.gitattributes +++ /dev/null @@ -1 +0,0 @@ -*.exe filter=lfs diff=lfs merge=lfs -text diff --git a/examples/@memclaw/bin-win-x64/.gitignore b/examples/@memclaw/bin-win-x64/.gitignore deleted file mode 100644 index 91cda48..0000000 --- a/examples/@memclaw/bin-win-x64/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -# Dependencies -node_modules/ - -# Build artifacts -*.tsbuildinfo diff --git a/examples/@memclaw/bin-win-x64/bin/README.md b/examples/@memclaw/bin-win-x64/bin/README.md deleted file mode 100644 index 62324ee..0000000 --- a/examples/@memclaw/bin-win-x64/bin/README.md +++ /dev/null @@ -1,22 +0,0 @@ -# MemClaw Binaries for Windows x64 - -Place the following binaries in this directory: - -- `qdrant.exe` - Qdrant vector database -- `cortex-mem-service.exe` - Cortex Memory HTTP service -- `cortex-mem-cli.exe` - Cortex Memory CLI tool - -## Build from source - -```powershell -# In cortex-mem project root -cargo build --release --target x86_64-pc-windows-msvc - -# Copy binaries -copy target\x86_64-pc-windows-msvc\release\cortex-mem-service.exe bin\ -copy target\x86_64-pc-windows-msvc\release\cortex-mem-cli.exe bin\ -``` - -## Download Qdrant - -Download from: https://github.com/qdrant/qdrant/releases diff --git a/examples/@memclaw/bin-win-x64/bin/cortex-mem-cli.exe b/examples/@memclaw/bin-win-x64/bin/cortex-mem-cli.exe deleted file mode 100644 index 631e96f..0000000 --- a/examples/@memclaw/bin-win-x64/bin/cortex-mem-cli.exe +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:56d3a4d37310804ac9f992a0b2f5f03638fdfd4ab89eec8898699faa03a2f880 -size 16896000 diff --git a/examples/@memclaw/bin-win-x64/bin/cortex-mem-service.exe b/examples/@memclaw/bin-win-x64/bin/cortex-mem-service.exe deleted file mode 100644 index 7bff226..0000000 --- a/examples/@memclaw/bin-win-x64/bin/cortex-mem-service.exe +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:68ebefe6c5eab8b8c5869468aa75cd549c690cfeae930ee7ac7dd61a449062a0 -size 17227264 diff --git a/examples/@memclaw/bin-win-x64/bin/qdrant.exe b/examples/@memclaw/bin-win-x64/bin/qdrant.exe deleted file mode 100644 index 7941560..0000000 --- a/examples/@memclaw/bin-win-x64/bin/qdrant.exe +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:cbebdfbf4c38d469755a83df7109b3c9fb42e6f1f1e9177e2e6ede4e8f85511e -size 79816704 diff --git a/examples/@memclaw/bin-win-x64/package.json b/examples/@memclaw/bin-win-x64/package.json deleted file mode 100644 index da3a1a3..0000000 --- a/examples/@memclaw/bin-win-x64/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "@memclaw/bin-win-x64", - "version": "0.1.7", - "description": "MemClaw binaries for Windows x64", - "publishConfig": { - "access": "public" - }, - "os": [ - "win32" - ], - "cpu": [ - "x64" - ], - "files": [ - "bin/" - ], - "author": "Sopaco", - "license": "MIT", - "repository": { - "type": "git", - "url": "git+https://github.com/sopaco/cortex-mem.git", - "directory": "examples/@memclaw/bin-win-x64" - } -} diff --git a/examples/@memclaw/plugin/.gitignore b/examples/@memclaw/plugin/.gitignore deleted file mode 100644 index b44d1f7..0000000 --- a/examples/@memclaw/plugin/.gitignore +++ /dev/null @@ -1,6 +0,0 @@ -node_modules/ -bun.lock -pnpm.lock -npm.lock -yarn.lock -skills/lagacy diff --git a/examples/@memclaw/plugin/README.md b/examples/@memclaw/plugin/README.md deleted file mode 100644 index 324d95a..0000000 --- a/examples/@memclaw/plugin/README.md +++ /dev/null @@ -1,428 +0,0 @@ -# MemClaw - -[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) - -Layered semantic memory plugin for OpenClaw with L0/L1/L2 tiered retrieval, automatic service management, and migration support from OpenClaw native memory. - -## Overview - -MemClaw is an OpenClaw plugin that provides advanced semantic memory capabilities using Cortex Memory's tiered memory architecture. It stores, searches, and recalls memories with intelligent layer-based retrieval that balances speed and context. - -## Features - -- **Three-Layer Memory Architecture**: L0 (abstract), L1 (overview), and L2 (full) layers for intelligent retrieval -- **Automatic Service Management**: Auto-starts Qdrant vector database and cortex-mem-service -- **Semantic Search**: Vector-based similarity search across all memory layers -- **Session Management**: Create, list, and close memory sessions -- **Migration Support**: One-click migration from OpenClaw native memory -- **Easy Configuration**: Configure LLM/Embedding directly through OpenClaw plugin settings -- **Cross-Platform**: Supports Windows x64, macOS Apple Silicon, and Linux x64 - -## Architecture - -### Memory Layers - -| Layer | Tokens | Content | Role | -|-------|--------|---------|------| -| **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`. - -### System Components - -``` -OpenClaw + MemClaw Plugin - │ - ├── cortex_search → Layered semantic search - ├── cortex_recall → Recall with context - ├── cortex_add_memory → Store memories - ├── cortex_commit_session → Commit & extract - ├── cortex_migrate → Migrate existing memory - ├── cortex_maintenance → Periodic maintenance - ├── cortex_ls → Browse memory filesystem - ├── cortex_get_abstract → L0 quick preview - ├── cortex_get_overview → L1 moderate detail - ├── cortex_get_content → L2 full content - └── cortex_explore → Smart exploration - │ - ▼ - cortex-mem-service (port 8085) - │ - ▼ - Qdrant (port 6334) -``` - -## Installation - -### Requirements - -| Requirement | Details | -|-------------|---------| -| **Platforms** | Windows x64, macOS Apple Silicon, Linux x64 | -| **Node.js** | ≥ 20.0.0 | -| **OpenClaw** | Installed and configured | - -### Install Plugin - -```bash -openclaw plugins install @memclaw/memclaw -``` - -### Local Development Installation - -For developers who want to use a local version of memclaw or develop the plugin: - -```bash -# Clone the repository -git clone https://github.com/sopaco/cortex-mem.git -cd cortex-mem/examples/@memclaw/plugin - -# Install dependencies -bun install - -# Build the plugin -bun run build -``` - -**Option A: Use plugins.load.paths** - -```json -{ - "plugins": { - "load": { - "paths": ["/path/to/cortex-mem/examples/@memclaw/plugin"] - }, - "entries": { - "memclaw": { "enabled": true } - } - } -} -``` - -**Option B: Symlink to extensions directory** - -```bash -mkdir -p ~/.openclaw/extensions -ln -sf "$(pwd)" ~/.openclaw/extensions/memclaw -``` - -Then enable in `openclaw.json`: - -```json -{ - "plugins": { - "entries": { - "memclaw": { "enabled": true } - } - } -} -``` - -After making code changes, rebuild with `bun run build` and restart OpenClaw. - -## Configuration - -### Plugin Configuration - -Configure MemClaw directly through OpenClaw plugin settings in `openclaw.json`: - -```json -{ - "plugins": { - "entries": { - "memclaw": { - "enabled": true, - "config": { - "serviceUrl": "http://localhost:8085", - "tenantId": "tenant_claw", - "autoStartServices": true, - "llmApiBaseUrl": "https://api.openai.com/v1", - "llmApiKey": "your-llm-api-key", - "llmModel": "gpt-5-mini", - "embeddingApiBaseUrl": "https://api.openai.com/v1", - "embeddingApiKey": "your-embedding-api-key", - "embeddingModel": "text-embedding-3-small" - } - } - } - }, - "agents": { - "defaults": { - "memorySearch": { "enabled": false } - } - } -} -``` - -> **Note**: Set `memorySearch.enabled: false` to disable OpenClaw's built-in memory search and use MemClaw instead. - -### Configuration Options - -| Option | Type | Default | Description | -|--------|------|---------|-------------| -| `serviceUrl` | string | `http://localhost:8085` | Cortex Memory service URL | -| `tenantId` | string | `tenant_claw` | Tenant ID for data isolation | -| `autoStartServices` | boolean | `true` | Auto-start Qdrant and service | -| `defaultSessionId` | string | `default` | Default session for memory operations | -| `searchLimit` | number | `10` | Default number of search results | -| `minScore` | number | `0.6` | Minimum relevance score (0-1) | -| `qdrantPort` | number | `6334` | Qdrant port (gRPC) | -| `servicePort` | number | `8085` | cortex-mem-service port | -| `llmApiBaseUrl` | string | `https://api.openai.com/v1` | LLM API endpoint URL | -| `llmApiKey` | string | - | LLM API key (required) | -| `llmModel` | string | `gpt-5-mini` | LLM model name | -| `embeddingApiBaseUrl` | string | `https://api.openai.com/v1` | Embedding API endpoint URL | -| `embeddingApiKey` | string | - | Embedding API key (required) | -| `embeddingModel` | string | `text-embedding-3-small` | Embedding model name | - -### Configuration via UI - -You can also configure the plugin through OpenClaw UI: - -1. Open OpenClaw Settings (`openclaw.json` or via UI) -2. Navigate to Plugins → MemClaw → Configuration -3. Fill in the required fields for LLM and Embedding -4. Save and **restart OpenClaw Gateway** for changes to take effect - -## Available Tools - -### cortex_search - -Layered semantic search with fine-grained control over returned content. - -**Key Parameters:** -- `return_layers`: `["L0"]` (default, ~100 tokens), `["L0","L1"]` (~2100 tokens), `["L0","L1","L2"]` (full) - -```json -{ - "query": "database architecture decisions", - "limit": 5, - "min_score": 0.6, - "return_layers": ["L0"] -} -``` - -For more context, use `return_layers: ["L0","L1"]`. For full content, use `["L0","L1","L2"]`. - -### cortex_recall - -Recall memories with more context (snippet + full content). - -```json -{ - "query": "user preferences for code style", - "limit": 10 -} -``` - -### cortex_add_memory - -Store a message for future retrieval with optional metadata. - -```json -{ - "content": "User prefers TypeScript with strict mode", - "role": "assistant", - "session_id": "default", - "metadata": { - "tags": ["preference", "typescript"], - "importance": "high" - } -} -``` - -**Parameters:** -- `content`: The message content (required) -- `role`: `"user"`, `"assistant"`, or `"system"` (default: user) -- `session_id`: Session/thread ID (uses default if not specified) -- `metadata`: Optional metadata like tags, importance, or custom fields - - - -### cortex_commit_session - -Commit a session and trigger memory extraction pipeline (takes 30-60 seconds). - -```json -{ - "session_id": "default" -} -``` - -> **Important**: Call this tool proactively at natural checkpoints, not just when the conversation ends. Ideal timing: after completing important tasks, topic transitions, or accumulating enough conversation content. - -### cortex_ls - -List directory contents to browse the memory space like a virtual filesystem. - -```json -{ - "uri": "cortex://session", - "recursive": false, - "include_abstracts": false -} -``` - -**Parameters:** -- `uri`: Directory URI to list (default: `cortex://session`) -- `recursive`: List all subdirectories recursively -- `include_abstracts`: Show L0 abstracts for quick preview - -**Common URIs:** -- `cortex://session` - List all sessions -- `cortex://session/{session_id}` - Browse a specific session -- `cortex://session/{session_id}/timeline` - View timeline messages -- `cortex://user/{user_id}/preferences` - View user preferences (extracted memories) -- `cortex://user/{user_id}/entities` - View user entities (people, projects, etc.) -- `cortex://agent/{agent_id}/cases` - View agent problem-solution cases - -### cortex_get_abstract - -Get L0 abstract layer (~100 tokens) for quick relevance checking. - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -Use this to quickly determine if content is relevant before reading more. - -### cortex_get_overview - -Get L1 overview layer (~2000 tokens) with core information and context. - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -Use when you need more detail than the abstract but not the full content. - -### cortex_get_content - -Get L2 full content layer - the complete original content. - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -Use only when you need the complete, unprocessed content. - -### cortex_explore - -Smart exploration combining search and browsing for guided discovery. - -```json -{ - "query": "authentication flow", - "start_uri": "cortex://session", - "return_layers": ["L0"] -} -``` - -Returns an exploration path with relevance scores and matching results. - -### cortex_migrate - -Migrate from OpenClaw native memory to MemClaw. Run once during initial setup. - -### cortex_maintenance - -Perform periodic maintenance on MemClaw data (prune, reindex, ensure-all layers). - -```json -{ - "dryRun": false, - "commands": ["prune", "reindex", "ensure-all"] -} -``` - -**Parameters:** -- `dryRun`: Preview changes without executing (default: false) -- `commands`: Which maintenance commands to run (default: all) - -This tool runs automatically every 3 hours. Call manually when search results seem incomplete or stale. - -## Quick Decision Flow - -``` -┌─────────────────────────────────────────────────────────────────┐ -│ How to Access Memories │ -├─────────────────────────────────────────────────────────────────┤ -│ │ -│ Do you know WHERE the information is? │ -│ │ │ -│ ├── YES ──► Use Direct Tiered Access │ -│ │ cortex_ls → cortex_get_abstract/overview/content│ -│ │ │ -│ └── NO ──► Do you know WHAT you're looking for? │ -│ │ │ -│ ├── YES ──► Use Semantic Search │ -│ │ cortex_search │ -│ │ │ -│ └── NO ──► Use Exploration │ -│ cortex_explore │ -│ │ -└─────────────────────────────────────────────────────────────────┘ -``` - -| Scenario | Tool | -|----------|------| -| Find information across all sessions | `cortex_search` | -| Browse memory structure | `cortex_ls` | -| Quick relevance check for URI | `cortex_get_abstract` | -| Get more details on relevant URI | `cortex_get_overview` | -| Need exact full content | `cortex_get_content` | -| Explore with purpose | `cortex_explore` | -| Save important information | `cortex_add_memory` | -| Complete a task/topic | `cortex_commit_session` | -| First-time use with existing memories | `cortex_migrate` | -| Data maintenance | `cortex_maintenance` | - -For detailed guidance on tool selection, session lifecycle, and best practices, see the [Skills Documentation](skills/memclaw/SKILL.md). - -## Troubleshooting - -### Plugin Not Working - -### Services Won't Start - -1. Check that ports 6333, 6334, 8085 are available -2. Verify LLM and Embedding credentials are configured correctly -3. Run `openclaw skills` to check plugin status - -### Migration Fails - -1. Ensure OpenClaw workspace exists at `~/.openclaw/workspace` -2. Verify memory files exist in `~/.openclaw/workspace/memory/` - -## CLI Reference - -For advanced users, use the cortex-mem-cli directly: - -```bash -# List sessions -cortex-mem-cli --config config.toml --tenant tenant_claw session list - -# Ensure all layers are generated -cortex-mem-cli --config config.toml --tenant tenant_claw layers ensure-all - -# Rebuild vector index -cortex-mem-cli --config config.toml --tenant tenant_claw vector reindex -``` - -## Documentation - -- **[Skills Documentation](skills/memclaw/SKILL.md)** — Agent skill guide with troubleshooting -- **[Best Practices](skills/memclaw/references/best-practices.md)** — Tool selection, session lifecycle, search strategies -- **[Tools Reference](skills/memclaw/references/tools.md)** — Detailed tool parameters and examples - -## License - -MIT diff --git a/examples/@memclaw/plugin/README_zh.md b/examples/@memclaw/plugin/README_zh.md deleted file mode 100644 index 93b7399..0000000 --- a/examples/@memclaw/plugin/README_zh.md +++ /dev/null @@ -1,426 +0,0 @@ -# MemClaw - -[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) - -OpenClaw 的分层语义记忆插件，支持 L0/L1/L2 三层检索、自动服务管理，以及从 OpenClaw 原生记忆迁移。 - -## 概述 - -MemClaw 是一个 OpenClaw 插件，利用 Cortex Memory 的分层记忆架构提供高级语义记忆能力。它通过智能的分层检索来存储、搜索和召回记忆，在速度和上下文之间取得平衡。 - -## 特性 - -- **三层记忆架构**：L0（摘要）、L1（概览）和 L2（完整）三层，实现智能检索 -- **自动服务管理**：自动启动 Qdrant 向量数据库和 cortex-mem-service -- **语义搜索**：基于向量相似度的全层级记忆搜索 -- **会话管理**：创建、列出和关闭记忆会话 -- **迁移支持**：一键从 OpenClaw 原生记忆迁移 -- **便捷配置**：直接通过 OpenClaw 插件设置配置 LLM/Embedding -- **跨平台**：支持 Windows x64、macOS Apple Silicon 和 Linux x64 - -## 架构 - -### 记忆层级 - -| 层级 | Token 数量 | 内容 | 作用 | -|------|-----------|------|------| -| **L0（摘要）** | ~100 | 高层摘要 | 快速筛选 | -| **L1（概览）** | ~2000 | 要点 + 上下文 | 上下文精炼 | -| **L2（完整）** | 完整 | 原始内容 | 精确匹配 | - -搜索引擎内部查询所有三个层级，返回包含 `snippet` 和 `content` 的统一结果。 - -### 系统组件 - -``` -OpenClaw + MemClaw Plugin - │ - ├── cortex_search → 分层语义搜索 - ├── cortex_recall → 召回上下文 - ├── cortex_add_memory → 存储记忆 - ├── cortex_commit_session → 提交并提取 - ├── cortex_migrate → 迁移现有记忆 - ├── cortex_maintenance → 定期维护 - ├── cortex_ls → 浏览记忆文件系统 - ├── cortex_get_abstract → L0 快速预览 - ├── cortex_get_overview → L1 中等详情 - ├── cortex_get_content → L2 完整内容 - └── cortex_explore → 智能探索 - │ - ▼ - cortex-mem-service (端口 8085) - │ - ▼ - Qdrant (端口 6334) -``` - -## 安装 - -### 环境要求 - -| 要求 | 详情 | -|------|------| -| **平台** | Windows x64, macOS Apple Silicon | -| **Node.js** | ≥ 20.0.0 | -| **OpenClaw** | 已安装并配置 | - -### 安装插件 - -```bash -openclaw plugins install @memclaw/memclaw -``` - -### 本地开发安装 - -开发者如需使用本地版本或开发插件： - -```bash -# 克隆仓库 -git clone https://github.com/sopaco/cortex-mem.git -cd cortex-mem/examples/@memclaw/plugin - -# 安装依赖 -bun install - -# 构建插件 -bun run build -``` - -**方式 A：使用 plugins.load.paths** - -```json -{ - "plugins": { - "load": { - "paths": ["/path/to/cortex-mem/examples/@memclaw/plugin"] - }, - "entries": { - "memclaw": { "enabled": true } - } - } -} -``` - -**方式 B：符号链接到扩展目录** - -```bash -mkdir -p ~/.openclaw/extensions -ln -sf "$(pwd)" ~/.openclaw/extensions/memclaw -``` - -然后在 `openclaw.json` 中启用： - -```json -{ - "plugins": { - "entries": { - "memclaw": { "enabled": true } - } - } -} -``` - -代码修改后，执行 `bun run build` 重新构建，然后重启 OpenClaw。 - -## 配置 - -### 插件配置 - -直接通过 `openclaw.json` 中的 OpenClaw 插件设置配置 MemClaw： - -```json -{ - "plugins": { - "entries": { - "memclaw": { - "enabled": true, - "config": { - "serviceUrl": "http://localhost:8085", - "tenantId": "tenant_claw", - "autoStartServices": true, - "llmApiBaseUrl": "https://api.openai.com/v1", - "llmApiKey": "your-llm-api-key", - "llmModel": "gpt-5-mini", - "embeddingApiBaseUrl": "https://api.openai.com/v1", - "embeddingApiKey": "your-embedding-api-key", - "embeddingModel": "text-embedding-3-small" - } - } - } - }, - "agents": { - "defaults": { - "memorySearch": { "enabled": false } - } - } -} -``` - -> **注意**：设置 `memorySearch.enabled: false` 以禁用 OpenClaw 内置记忆搜索，改用 MemClaw。 - -### 配置选项 - -| 选项 | 类型 | 默认值 | 描述 | -|------|------|--------|------| -| `serviceUrl` | string | `http://localhost:8085` | Cortex Memory 服务 URL | -| `tenantId` | string | `tenant_claw` | 租户 ID，用于数据隔离 | -| `autoStartServices` | boolean | `true` | 自动启动 Qdrant 和服务 | -| `defaultSessionId` | string | `default` | 记忆操作的默认会话 | -| `searchLimit` | number | `10` | 默认搜索结果数量 | -| `minScore` | number | `0.6` | 最小相关度分数 (0-1) | -| `qdrantPort` | number | `6334` | Qdrant 端口 (gRPC) | -| `servicePort` | number | `8085` | cortex-mem-service 端口 | -| `llmApiBaseUrl` | string | `https://api.openai.com/v1` | LLM API 端点 URL | -| `llmApiKey` | string | - | LLM API 密钥（必填） | -| `llmModel` | string | `gpt-5-mini` | LLM 模型名称 | -| `embeddingApiBaseUrl` | string | `https://api.openai.com/v1` | Embedding API 端点 URL | -| `embeddingApiKey` | string | - | Embedding API 密钥（必填） | -| `embeddingModel` | string | `text-embedding-3-small` | Embedding 模型名称 | - -### 通过 UI 配置 - -你也可以通过 OpenClaw UI 配置插件： - -1. 打开 OpenClaw 设置（`openclaw.json` 或通过 UI） -2. 导航到 插件 → MemClaw → 配置 -3. 填写 LLM 和 Embedding 相关的必填字段 -4. 保存并**重启 OpenClaw Gateway** 使配置生效 - -## 可用工具 - -### cortex_search - -分层语义搜索，支持精细控制返回内容。 - -**关键参数：** -- `return_layers`: `["L0"]` (默认，约 100 tokens), `["L0","L1"]` (约 2100 tokens), `["L0","L1","L2"]` (完整内容) - -```json -{ - "query": "数据库架构决策", - "limit": 5, - "min_score": 0.6, - "return_layers": ["L0"] -} -``` - -如需更多上下文，使用 `return_layers: ["L0","L1"]`。如需完整内容，使用 `["L0","L1","L2"]`。 - -### cortex_recall - -召回带有更多上下文的记忆（摘要 + 完整内容）。 - -```json -{ - "query": "用户代码风格偏好", - "limit": 10 -} -``` - -### cortex_add_memory - -存储消息以供后续检索，支持可选的元数据。 - -```json -{ - "content": "用户偏好 TypeScript 严格模式", - "role": "assistant", - "session_id": "default", - "metadata": { - "tags": ["preference", "typescript"], - "importance": "high" - } -} -``` - -**参数说明：** -- `content`: 消息内容（必填） -- `role`: `"user"`、`"assistant"` 或 `"system"`（默认：user） -- `session_id`: 会话/线程 ID（不指定则使用默认值） -- `metadata`: 可选元数据，如标签、重要性或自定义字段 - -### cortex_commit_session - -提交会话并触发记忆提取管道（耗时 30-60 秒）。 - -```json -{ - "session_id": "default" -} -``` - -> **重要提示**：请在自然的检查点主动调用此工具，不要等到对话结束。理想时机：完成重要任务后、话题转换时、或积累足够对话内容后。 - -### cortex_ls - -列出目录内容，像浏览虚拟文件系统一样浏览记忆空间。 - -```json -{ - "uri": "cortex://session", - "recursive": false, - "include_abstracts": false -} -``` - -**参数说明：** -- `uri`: 要列出的目录 URI（默认：`cortex://session`） -- `recursive`: 是否递归列出子目录 -- `include_abstracts`: 是否显示 L0 摘要以快速预览 - -**常用 URI：** -- `cortex://session` - 列出所有会话 -- `cortex://session/{session_id}` - 浏览特定会话 -- `cortex://session/{session_id}/timeline` - 查看时间线消息 -- `cortex://user/{user_id}/preferences` - 查看用户偏好（提取的记忆） -- `cortex://user/{user_id}/entities` - 查看用户实体（人物、项目等） -- `cortex://agent/{agent_id}/cases` - 查看 Agent 问题解决案例 - -### cortex_get_abstract - -获取 L0 摘要层（约 100 tokens），用于快速相关性检查。 - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -用于在阅读更多内容前快速判断内容是否相关。 - -### cortex_get_overview - -获取 L1 概览层（约 2000 tokens），包含核心信息和上下文。 - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -当摘要不够详细但不需要完整内容时使用。 - -### cortex_get_content - -获取 L2 完整内容层 - 完整的原始内容。 - -```json -{ - "uri": "cortex://session/abc123/timeline/2024-01-15_001.md" -} -``` - -仅在需要完整、未处理的内容时使用。 - -### cortex_explore - -智能探索，结合搜索和浏览进行引导式发现。 - -```json -{ - "query": "认证流程", - "start_uri": "cortex://session", - "return_layers": ["L0"] -} -``` - -返回带有相关性分数的探索路径和匹配结果。 - -### cortex_migrate - -从 OpenClaw 原生记忆迁移到 MemClaw。初始设置时运行一次即可。 - -### cortex_maintenance - -对 MemClaw 数据执行定期维护（清理、重建索引、确保所有层级生成）。 - -```json -{ - "dryRun": false, - "commands": ["prune", "reindex", "ensure-all"] -} -``` - -**参数说明：** -- `dryRun`: 预览更改但不执行（默认：false） -- `commands`: 要运行的维护命令（默认：全部） - -此工具每 3 小时自动运行一次。当搜索结果不完整或过时时可手动调用。 - -## 快速决策流程 - -``` -┌─────────────────────────────────────────────────────────────────┐ -│ 如何访问记忆 │ -├─────────────────────────────────────────────────────────────────┤ -│ │ -│ 你知道信息在哪里吗？ │ -│ │ │ -│ ├── 是 ──► 使用直接分层访问 │ -│ │ cortex_ls → cortex_get_abstract/overview/content│ -│ │ │ -│ └── 否 ──► 你知道在找什么吗？ │ -│ │ │ -│ ├── 是 ──► 使用语义搜索 │ -│ │ cortex_search │ -│ │ │ -│ └── 否 ──► 使用智能探索 │ -│ cortex_explore │ -│ │ -└─────────────────────────────────────────────────────────────────┘ -``` - -| 场景 | 工具 | -|------|------| -| 跨所有会话查找信息 | `cortex_search` | -| 浏览记忆结构 | `cortex_ls` | -| 快速检查 URI 相关性 | `cortex_get_abstract` | -| 获取相关 URI 的更多详情 | `cortex_get_overview` | -| 需要完整原始内容 | `cortex_get_content` | -| 有目的地探索 | `cortex_explore` | -| 保存重要信息 | `cortex_add_memory` | -| 完成任务/话题 | `cortex_commit_session` | -| 首次使用且有现有记忆 | `cortex_migrate` | -| 数据维护 | `cortex_maintenance` | - -更多关于工具选择、会话生命周期和最佳实践的详细指南，请参阅 [技能文档](skills/memclaw/SKILL.md)。 - -## 故障排查 - -### 插件无法工作 - -### 服务无法启动 - -1. 检查端口 6333、6334、8085 是否可用 -2. 验证 LLM 和 Embedding 凭证是否正确配置 -3. 运行 `openclaw skills` 检查插件状态 - -### 迁移失败 - -1. 确保 OpenClaw 工作区存在于 `~/.openclaw/workspace` -2. 验证记忆文件存在于 `~/.openclaw/workspace/memory/` - -## CLI 参考 - -高级用户可直接使用 cortex-mem-cli： - -```bash -# 列出会话 -cortex-mem-cli --config config.toml --tenant tenant_claw session list - -# 确保所有层级已生成 -cortex-mem-cli --config config.toml --tenant tenant_claw layers ensure-all - -# 重建向量索引 -cortex-mem-cli --config config.toml --tenant tenant_claw vector reindex -``` - -## 文档 - -- **[技能文档](skills/memclaw/SKILL.md)** — Agent 技能指南，含故障排查 -- **[最佳实践](skills/memclaw/references/best-practices.md)** — 工具选择、会话生命周期、搜索策略 -- **[工具参考](skills/memclaw/references/tools.md)** — 详细工具参数和示例 - -## 许可证 - -MIT diff --git a/examples/@memclaw/plugin/SECURITY.md b/examples/@memclaw/plugin/SECURITY.md deleted file mode 100644 index a421db0..0000000 --- a/examples/@memclaw/plugin/SECURITY.md +++ /dev/null @@ -1,90 +0,0 @@ -# Security Information - -This document describes security considerations for the MemClaw plugin. - -## Data Flow - -``` -User Input → OpenClaw → MemClaw Plugin → cortex-mem-service (localhost:8085) - │ - ▼ - Qdrant (localhost:6334) - │ - ▼ - Local Storage -``` - -**Key Points:** -- All data processing happens **locally** on your machine -- No data is sent to external servers except your configured LLM/Embedding providers -- API keys are only transmitted to your configured API endpoints - -## Credentials - -### Required Credentials - -| Credential | Purpose | Storage Location | -|------------|---------|------------------| -| `llmApiKey` | Memory extraction and summarization | OpenClaw plugin config (marked `sensitive: true`) | -| `embeddingApiKey` | Vector embedding generation | OpenClaw plugin config (marked `sensitive: true`) | - -### Credential Security - -- API keys are stored in `openclaw.json` with the `sensitive` flag -- Keys are **never** logged or transmitted except to your configured API provider -- Keys are **never** sent to the MemClaw developers or any third party - -## Binary Packages - -### What's Included - -MemClaw uses platform-specific binary packages distributed via npm: - -| Package | Platform | Contents | -|---------|----------|----------| -| `@memclaw/bin-darwin-arm64` | macOS Apple Silicon | Qdrant, cortex-mem-service, cortex-mem-cli | -| `@memclaw/bin-win-x64` | Windows x64 | Qdrant, cortex-mem-service, cortex-mem-cli | -| `@memclaw/bin-linux-x64` | Linux x64 | Qdrant, cortex-mem-service, cortex-mem-cli | - -### Verification - -To verify binary packages: - -```bash -# Check package integrity via npm -npm view @memclaw/bin-darwin-arm64 -npm view @memclaw/bin-win-x64 -npm view @memclaw/bin-linux-x64 - -# Inspect package contents -npm pack @memclaw/bin-darwin-arm64 -tar -tzf memclaw-bin-darwin-arm64-*.tgz -``` - -### Source Code - -The source code for building these binaries is available in the main repository: -- Repository: https://github.com/sopaco/cortex-mem -- Build scripts: `cortex-mem-core/`, `cortex-mem-service/` - -## Network Security - -### Ports Used - -| Service | Port | Protocol | Purpose | -|---------|------|----------|---------| -| Qdrant HTTP | 6333 | TCP | REST API, health checks | -| Qdrant gRPC | 6334 | TCP | Vector operations | -| cortex-mem-service | 8085 | TCP | Memory service API | - -### Firewall Configuration - -If you use a firewall, ensure: -- Ports 6333, 6334, 8085 are allowed for **localhost only** -- External connections to these ports are blocked - -### Localhost Only - -All services bind to `localhost` (127.0.0.1) by default: -- No external network access is required -- Services are not accessible from other machines diff --git a/examples/@memclaw/plugin/dist/index.d.ts b/examples/@memclaw/plugin/dist/index.d.ts deleted file mode 100644 index d444215..0000000 --- a/examples/@memclaw/plugin/dist/index.d.ts +++ /dev/null @@ -1,100 +0,0 @@ -/** - * MemClaw - Layered Semantic Memory for OpenClaw - * - * Provides: - * - L0/L1/L2 tiered memory retrieval - * - Automatic service startup (Qdrant + cortex-mem-service) - * - Migration from OpenClaw native memory - * - * Installation: - * openclaw plugins install memclaw - * - * Configuration (in openclaw.json): - * { - * "plugins": { - * "entries": { - * "memclaw": { - * "enabled": true, - * "config": { - * "serviceUrl": "http://localhost:8085", - * "tenantId": "tenant_claw", - * "autoStartServices": true - * } - * } - * } - * } - * } - */ -export type { CortexMemClient } from './src/client.js'; -export type { MemClawConfig } from './src/config.js'; -interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} -interface ToolDefinition { - name: string; - description: string; - parameters: object; - execute: (_id: string, params: Record) => Promise; - optional?: boolean; -} -interface PluginAPI { - pluginConfig?: Record; - registerTool(tool: ToolDefinition, opts?: { - optional?: boolean; - }): void; - registerService(service: { - id: string; - start: () => Promise; - stop: () => Promise; - }): void; - logger: PluginLogger; -} -export default function memclawPlugin(api: PluginAPI): { - id: string; - name: string; - version: string; -}; -export declare const plugin: { - id: string; - name: string; - version: string; - configSchema: { - type: string; - properties: { - serviceUrl: { - type: string; - default: string; - }; - defaultSessionId: { - type: string; - default: string; - }; - searchLimit: { - type: string; - default: number; - }; - minScore: { - type: string; - default: number; - }; - tenantId: { - type: string; - default: string; - }; - autoStartServices: { - type: string; - default: boolean; - }; - }; - required: never[]; - }; - register(api: PluginAPI): { - id: string; - name: string; - version: string; - }; -}; -//# sourceMappingURL=index.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/index.d.ts.map b/examples/@memclaw/plugin/dist/index.d.ts.map deleted file mode 100644 index b78986e..0000000 --- a/examples/@memclaw/plugin/dist/index.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,SAAS;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,OAAO,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;CACrB;AAGD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAG,EAAE,SAAS;;;;EAEnD;AAGD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBJ,SAAS;;;;;CAGvB,CAAC"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/index.js b/examples/@memclaw/plugin/dist/index.js deleted file mode 100644 index 265bcae..0000000 --- a/examples/@memclaw/plugin/dist/index.js +++ /dev/null @@ -1,58 +0,0 @@ -"use strict"; -/** - * MemClaw - Layered Semantic Memory for OpenClaw - * - * Provides: - * - L0/L1/L2 tiered memory retrieval - * - Automatic service startup (Qdrant + cortex-mem-service) - * - Migration from OpenClaw native memory - * - * Installation: - * openclaw plugins install memclaw - * - * Configuration (in openclaw.json): - * { - * "plugins": { - * "entries": { - * "memclaw": { - * "enabled": true, - * "config": { - * "serviceUrl": "http://localhost:8085", - * "tenantId": "tenant_claw", - * "autoStartServices": true - * } - * } - * } - * } - * } - */ -Object.defineProperty(exports, "__esModule", { value: true }); -exports.plugin = void 0; -exports.default = memclawPlugin; -const plugin_impl_js_1 = require("./plugin-impl.js"); -// Default export - main plugin function -function memclawPlugin(api) { - return (0, plugin_impl_js_1.createPlugin)(api); -} -// Named export - object style registration -exports.plugin = { - id: 'memclaw', - name: 'MemClaw', - version: '0.9.29', - configSchema: { - type: 'object', - properties: { - serviceUrl: { type: 'string', default: 'http://localhost:8085' }, - defaultSessionId: { type: 'string', default: 'default' }, - searchLimit: { type: 'integer', default: 10 }, - minScore: { type: 'number', default: 0.6 }, - tenantId: { type: 'string', default: 'tenant_claw' }, - autoStartServices: { type: 'boolean', default: true } - }, - required: [] - }, - register(api) { - return (0, plugin_impl_js_1.createPlugin)(api); - } -}; -//# sourceMappingURL=index.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/index.js.map b/examples/@memclaw/plugin/dist/index.js.map deleted file mode 100644 index a1beff1..0000000 --- a/examples/@memclaw/plugin/dist/index.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAoCH,gCAEC;AApCD,qDAAgD;AAiChD,wCAAwC;AACxC,SAAwB,aAAa,CAAC,GAAc;IACnD,OAAO,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,2CAA2C;AAC9B,QAAA,MAAM,GAAG;IACrB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE;YAChE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;YACxD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;YAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YACpD,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;SACrD;QACD,QAAQ,EAAE,EAAE;KACZ;IACD,QAAQ,CAAC,GAAc;QACtB,OAAO,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD,CAAC"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/plugin-impl.d.ts b/examples/@memclaw/plugin/dist/plugin-impl.d.ts deleted file mode 100644 index 436c697..0000000 --- a/examples/@memclaw/plugin/dist/plugin-impl.d.ts +++ /dev/null @@ -1,43 +0,0 @@ -/** - * MemClaw Plugin Implementation - * - * Provides layered semantic memory for OpenClaw with: - * - Automatic service startup - * - Memory tools (search, recall, add, close) - * - Tiered access (L0/L1/L2) - * - Filesystem browsing - * - Smart exploration - * - Migration from OpenClaw native memory - */ -interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} -interface PluginAPI { - pluginConfig?: Record; - registerTool(tool: ToolDefinition, opts?: { - optional?: boolean; - }): void; - registerService(service: { - id: string; - start: () => Promise; - stop: () => Promise; - }): void; - logger: PluginLogger; -} -interface ToolDefinition { - name: string; - description: string; - parameters: object; - execute: (_id: string, params: Record) => Promise; - optional?: boolean; -} -export declare function createPlugin(api: PluginAPI): { - id: string; - name: string; - version: string; -}; -export {}; -//# sourceMappingURL=plugin-impl.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/plugin-impl.d.ts.map b/examples/@memclaw/plugin/dist/plugin-impl.d.ts.map deleted file mode 100644 index 686c640..0000000 --- a/examples/@memclaw/plugin/dist/plugin-impl.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"plugin-impl.d.ts","sourceRoot":"","sources":["../plugin-impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA6CH,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,SAAS;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,OAAO,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;CACrB;AAED,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AA0XD,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS;;;;EAgqB1C"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/plugin-impl.js b/examples/@memclaw/plugin/dist/plugin-impl.js deleted file mode 100644 index 34059e0..0000000 --- a/examples/@memclaw/plugin/dist/plugin-impl.js +++ /dev/null @@ -1,949 +0,0 @@ -"use strict"; -/** - * MemClaw Plugin Implementation - * - * Provides layered semantic memory for OpenClaw with: - * - Automatic service startup - * - Memory tools (search, recall, add, close) - * - Tiered access (L0/L1/L2) - * - Filesystem browsing - * - Smart exploration - * - Migration from OpenClaw native memory - */ -Object.defineProperty(exports, "__esModule", { value: true }); -exports.createPlugin = createPlugin; -const client_js_1 = require("./src/client.js"); -const config_js_1 = require("./src/config.js"); -const binaries_js_1 = require("./src/binaries.js"); -const migrate_js_1 = require("./src/migrate.js"); -const agents_md_injector_js_1 = require("./src/agents-md-injector.js"); -// Tool schemas -const toolSchemas = { - cortex_search: { - name: 'cortex_search', - description: `Layered semantic search across ALL memories using L0/L1/L2 tiered retrieval. - -**Key Features:** -- Tiered retrieval: L0 (abstract) -> L1 (overview) -> L2 (full content) -- Token-efficient: Control exactly which layers to return - -**When to use:** -- Finding past conversations, decisions, or any historical info -- Omit scope to search across ALL dimensions (recommended for most cases) -- Use scope="cortex://user/default" only when specifically looking for user profile data - -**Parameters:** -- return_layers: ["L0"] (default, ~100 tokens), ["L0","L1"] (~2100 tokens), ["L0","L1","L2"] (full)`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'The search query - can be natural language or keywords' - }, - scope: { - type: 'string', - description: `Optional. Omit to search ALL memories (recommended). -Use "cortex://user/default" only when specifically looking for user profile/preferences.` - }, - limit: { - type: 'integer', - description: 'Maximum number of results to return (default: 10)', - default: 10 - }, - min_score: { - type: 'number', - description: 'Minimum relevance score threshold (0-1, default: 0.6)', - default: 0.6 - }, - return_layers: { - type: 'array', - items: { - type: 'string', - enum: ['L0', 'L1', 'L2'] - }, - description: 'Which layers to return. Default: ["L0"]. Use ["L0","L1"] for more context, ["L0","L1","L2"] for full content.', - default: ['L0'] - } - }, - required: ['query'] - } - }, - cortex_recall: { - name: 'cortex_recall', - description: `Recall memories with full context (L0 snippet + L2 content). - -Equivalent to cortex_search with return_layers=["L0","L2"]. -Use cortex_search directly for more control over layers. - -**Tip**: Omit scope to search all memories (recommended).`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'The search query' - }, - scope: { - type: 'string', - description: `Optional. Omit to search ALL memories (recommended). -Use "cortex://user/default" only when specifically looking for user profile data.` - }, - limit: { - type: 'integer', - description: 'Maximum number of results (default: 10)', - default: 10 - } - }, - required: ['query'] - } - }, - cortex_add_memory: { - name: 'cortex_add_memory', - description: `Add a message to memory for a specific session. - -This stores the message and automatically triggers: -- Vector embedding for semantic search -- L0/L1 layer generation (async) - -**Metadata support:** -You can attach metadata like tags, importance, or custom fields. - -Use this to persist important information that should be searchable later.`, - inputSchema: { - type: 'object', - properties: { - content: { - type: 'string', - description: 'The content to store in memory' - }, - role: { - type: 'string', - enum: ['user', 'assistant', 'system'], - description: 'Role of the message sender (default: user)', - default: 'user' - }, - session_id: { - type: 'string', - description: 'Session/thread ID (uses default if not specified)' - }, - metadata: { - type: 'object', - description: 'Optional metadata (tags, importance, custom fields)', - additionalProperties: true - } - }, - required: ['content'] - } - }, - cortex_commit_session: { - name: 'cortex_commit_session', - description: `Commit accumulated conversation content and trigger memory extraction. - -**IMPORTANT - Call this tool proactively and periodically, NOT just at conversation end.** - -This commits the session and triggers the complete memory processing pipeline: -1. Extracts structured memories (user preferences, entities, decisions) -2. Generates complete L0/L1 layer summaries -3. Indexes all extracted memories into the vector database - -**When to call this tool:** -- After completing a significant task or topic discussion -- After the user has shared important preferences or decisions -- When the conversation topic shifts to something new -- After accumulating substantial conversation content (every 10-20 exchanges) -- Before ending a conversation session - -**Do NOT wait until the very end of conversation** - the user may forget or the session may end abruptly. - -**Guidelines:** -- Call this tool at natural checkpoints in the conversation -- Avoid calling too frequently (not after every message) -- A good rhythm: once per significant topic completion -- This is a long-running operation (30-60s) but runs asynchronously`, - inputSchema: { - type: 'object', - properties: { - session_id: { - type: 'string', - description: 'Session/thread ID to commit (uses default if not specified)' - } - } - } - }, - // ==================== Filesystem Tools ==================== - cortex_ls: { - name: 'cortex_ls', - description: `List directory contents to browse the memory space like a virtual filesystem. - -This allows you to explore the hierarchical structure of memories: -- cortex://session - List all sessions -- cortex://session/{session_id} - Browse a specific session's contents -- cortex://session/{session_id}/timeline - View timeline messages -- cortex://user/{user_id}/preferences - View user preferences (extracted memories) -- cortex://user/{user_id}/entities - View user entities (people, projects, etc.) -- cortex://agent/{agent_id}/cases - View agent problem-solution cases - -**Parameters:** -- recursive: List all subdirectories recursively -- include_abstracts: Show L0 abstracts for each file (for quick preview) - -Use this when: -- Semantic search doesn't find what you need -- You want to understand the overall memory layout -- You need to manually navigate to find specific information`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Directory URI to list (default: cortex://session)', - default: 'cortex://session' - }, - recursive: { - type: 'boolean', - description: 'Whether to recursively list subdirectories', - default: false - }, - include_abstracts: { - type: 'boolean', - description: 'Whether to include L0 abstracts for each file', - default: false - } - } - } - }, - // ==================== Tiered Access Tools ==================== - cortex_get_abstract: { - name: 'cortex_get_abstract', - description: `Get L0 abstract layer (~100 tokens) for quick relevance checking. - -Abstracts are short summaries ideal for quickly determining if content is relevant -before committing to reading more. Use this to minimize token consumption. - -Use when: -- You found a URI from cortex_ls and want to quickly check relevance -- You need to filter many candidates before deep reading -- You want the most token-efficient preview`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file or directory)' - } - }, - required: ['uri'] - } - }, - cortex_get_overview: { - name: 'cortex_get_overview', - description: `Get L1 overview layer (~2000 tokens) with core information and context. - -Overviews contain key points and contextual information. Use this when: -- The abstract was relevant but you need more details -- You want to understand the gist without full content -- You need moderate detail for decision making`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file or directory)' - } - }, - required: ['uri'] - } - }, - cortex_get_content: { - name: 'cortex_get_content', - description: `Get L2 full content layer - the complete original content. - -Use this ONLY when you need the complete, unprocessed content. -This returns the full content which may be large. - -Use when: -- You need exact details or quotes -- Abstract and overview don't provide enough information -- You need to see the original, unsummarized content`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file only)' - } - }, - required: ['uri'] - } - }, - // ==================== Exploration Tool ==================== - cortex_explore: { - name: 'cortex_explore', - description: `Smart exploration of memory space, combining search and browsing. - -This tool performs a guided exploration: -1. Searches within a specified scope (start_uri) -2. Returns an exploration path showing relevance scores -3. Returns matching results with requested layers - -**When to use:** -- When you need to "wander" through memories with a purpose -- When you want to discover related content in a specific area -- When combining keyword hints with semantic discovery - -**Parameters:** -- start_uri: Where to begin exploration (default: cortex://session) -- return_layers: Which layers to include in matches`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'Exploration query - what to look for' - }, - start_uri: { - type: 'string', - description: 'Starting URI for exploration', - default: 'cortex://session' - }, - return_layers: { - type: 'array', - items: { - type: 'string', - enum: ['L0', 'L1', 'L2'] - }, - description: 'Which layers to return in matches', - default: ['L0'] - } - }, - required: ['query'] - } - }, - // ==================== Migration & Maintenance ==================== - cortex_migrate: { - name: 'cortex_migrate', - description: `Migrate memories from OpenClaw's native memory system to MemClaw. - -This will: -1. Find your OpenClaw memory files (memory/*.md and MEMORY.md) -2. Convert them to MemClaw's L2 format -3. Generate L0/L1 layers and vector index - -Use this once during initial setup to preserve your existing memories.`, - inputSchema: { - type: 'object', - properties: {} - } - }, - cortex_maintenance: { - name: 'cortex_maintenance', - description: `Perform periodic maintenance on MemClaw data. - -This executes: -1. vector prune - Remove vectors whose source files no longer exist -2. vector reindex - Rebuild vector index and remove stale entries -3. layers ensure-all - Generate missing L0/L1 layer files - -**This tool is typically called automatically by a scheduled Cron job.** -You can also call it manually when: -- Search results seem incomplete or stale -- After recovering from a crash or data corruption -- When disk space cleanup is needed - -**Parameters:** -- dryRun: Preview changes without executing (default: false) -- commands: Which commands to run (default: all)`, - inputSchema: { - type: 'object', - properties: { - dryRun: { - type: 'boolean', - description: 'Preview changes without executing', - default: false - }, - commands: { - type: 'array', - items: { - type: 'string', - enum: ['prune', 'reindex', 'ensure-all'] - }, - description: 'Which maintenance commands to run', - default: ['prune', 'reindex', 'ensure-all'] - } - } - } - } -}; -// Maintenance interval: 3 hours -const MAINTENANCE_INTERVAL_MS = 3 * 60 * 60 * 1000; -function createPlugin(api) { - const config = (api.pluginConfig ?? {}); - const serviceUrl = config.serviceUrl ?? 'http://localhost:8085'; - const defaultSessionId = config.defaultSessionId ?? 'default'; - const searchLimit = config.searchLimit ?? 10; - const minScore = config.minScore ?? 0.6; - const tenantId = config.tenantId ?? 'tenant_claw'; - const autoStartServices = config.autoStartServices ?? true; - const enhanceClawAgent = config.enhanceClawAgent ?? true; - const client = new client_js_1.CortexMemClient(serviceUrl); - let servicesStarted = false; - let maintenanceTimer = null; - const log = (msg) => api.logger.info(`[memclaw] ${msg}`); - log('Initializing MemClaw plugin...'); - // Ensure config file exists - const { created, path: configPath } = (0, config_js_1.ensureConfigExists)(); - if (created) { - log(`Created configuration file: ${configPath}`); - log('Opening configuration file for editing...'); - (0, config_js_1.openConfigFile)(configPath).catch((err) => { - api.logger.warn(`[memclaw] Could not open config file: ${err}`); - api.logger.warn(`[memclaw] Please manually edit: ${configPath}`); - }); - api.logger.info(` -╔══════════════════════════════════════════════════════════╗ -║ MemClaw First Run ║ -║ ║ -║ A configuration file has been created: ║ -║ ${configPath.padEnd(52)}║ -║ ║ -║ Please fill in the required fields: ║ -║ - llm.api_key (your LLM API key) ║ -║ - embedding.api_key (your embedding API key) ║ -║ ║ -║ Save the file and restart OpenClaw to apply changes. ║ -╚══════════════════════════════════════════════════════════╝ - `); - } - // Register service lifecycle - api.registerService({ - id: 'memclaw', - start: async () => { - // Skip service startup if config was just created (first run) - // User needs to fill in API keys first - if (created) { - log('First run detected. Please complete configuration and restart OpenClaw.'); - return; - } - if (!autoStartServices) { - log('Auto-start disabled, skipping service startup'); - return; - } - // Sync plugin config to config.toml if LLM/Embedding settings provided - const pluginProvidedConfig = { - llmApiBaseUrl: config.llmApiBaseUrl, - llmApiKey: config.llmApiKey, - llmModel: config.llmModel, - embeddingApiBaseUrl: config.embeddingApiBaseUrl, - embeddingApiKey: config.embeddingApiKey, - embeddingModel: config.embeddingModel - }; - const syncResult = (0, config_js_1.updateConfigFromPlugin)(pluginProvidedConfig); - if (syncResult.updated) { - log(`Synced LLM/Embedding config from OpenClaw to: ${syncResult.path}`); - } - // Check if binaries are available - const hasQdrant = (0, binaries_js_1.isBinaryAvailable)('qdrant'); - const hasService = (0, binaries_js_1.isBinaryAvailable)('cortex-mem-service'); - if (!hasQdrant || !hasService) { - log('Some binaries are missing. Services may need manual setup.'); - log(`Run 'memclaw setup' or check the admin skill for installation instructions.`); - } - // Parse and merge config (plugin config takes precedence) - const fileConfig = (0, config_js_1.parseConfig)(configPath); - const mergedConfig = (0, config_js_1.mergeConfigWithPlugin)(fileConfig, pluginProvidedConfig); - const validation = (0, config_js_1.validateConfig)(mergedConfig); - if (!validation.valid) { - api.logger.warn(`[memclaw] Configuration incomplete: ${validation.errors.join(', ')}`); - api.logger.warn(`[memclaw] Please configure LLM/Embedding API keys in OpenClaw plugin settings or edit: ${configPath}`); - return; - } - // Enhance AGENTS.md with MemClaw usage guidelines - const agentsMdResult = (0, agents_md_injector_js_1.ensureAgentsMdEnhanced)(api.logger, enhanceClawAgent); - if (agentsMdResult.injected) { - log(`AGENTS.md enhanced with MemClaw section: ${agentsMdResult.path}`); - } - else if (agentsMdResult.reason === 'already_injected') { - log('AGENTS.md already contains MemClaw section'); - } - else if (agentsMdResult.reason === 'no_legacy_patterns') { - log('AGENTS.md has no legacy memory patterns, skipping enhancement'); - } - // Start services - try { - log('Starting services...'); - await (0, binaries_js_1.ensureAllServices)(log); - // Switch tenant - await client.switchTenant(tenantId); - log(`Switched to tenant: ${tenantId}`); - // Mark services as started only after tenant switch succeeds - servicesStarted = true; - log('MemClaw services started successfully'); - // Start maintenance timer (runs every 3 hours) - maintenanceTimer = setInterval(async () => { - try { - log('Running scheduled maintenance...'); - const currentConfigPath = (0, config_js_1.getConfigPath)(); - // Run maintenance commands - const commands = [ - ['vector', 'prune'], - ['vector', 'reindex'], - ['layers', 'ensure-all'] - ]; - for (const cmd of commands) { - const result = await (0, binaries_js_1.executeCliCommand)(cmd, currentConfigPath, tenantId, 300000); - if (!result.success) { - log(`Maintenance command '${cmd.join(' ')}' failed: ${result.stderr}`); - } - } - log('Scheduled maintenance completed'); - } - catch (err) { - log(`Maintenance error: ${err}`); - } - }, MAINTENANCE_INTERVAL_MS); - log('Maintenance timer started (runs every 3 hours)'); - } - catch (err) { - api.logger.error(`[memclaw] Failed to start services: ${err}`); - api.logger.warn('[memclaw] Memory features may not work correctly'); - } - }, - stop: async () => { - log('Stopping MemClaw...'); - // Clear maintenance timer - if (maintenanceTimer) { - clearInterval(maintenanceTimer); - maintenanceTimer = null; - log('Maintenance timer stopped'); - } - servicesStarted = false; - } - }); - // Helper to check if services are ready - const ensureServicesReady = async () => { - if (!servicesStarted) { - const status = await (0, binaries_js_1.checkServiceStatus)(); - if (!status.cortexMemService) { - throw new Error('cortex-mem-service is not running. Please start the service first.'); - } - } - }; - // ==================== Register Tools ==================== - // cortex_search - api.registerTool({ - name: toolSchemas.cortex_search.name, - description: toolSchemas.cortex_search.description, - parameters: toolSchemas.cortex_search.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const results = await client.search({ - query: input.query, - scope: input.scope, - limit: input.limit ?? searchLimit, - min_score: input.min_score ?? minScore, - return_layers: input.return_layers ?? ['L0'] - }); - const formatted = results - .map((r, i) => { - let content = `${i + 1}. [Score: ${r.score.toFixed(2)}] URI: ${r.uri}\n`; - content += ` Layers: ${r.layers.join(', ')}\n`; - content += ` Snippet: ${r.snippet}\n`; - if (r.overview) { - content += ` Overview: ${r.overview.substring(0, 200)}...\n`; - } - if (r.content) { - const preview = r.content.length > 200 ? r.content.substring(0, 200) + '...' : r.content; - content += ` Content: ${preview}\n`; - } - return content; - }) - .join('\n'); - return { - content: `Found ${results.length} results for "${input.query}":\n\n${formatted}`, - results: results.map((r) => ({ - uri: r.uri, - score: r.score, - snippet: r.snippet, - overview: r.overview, - content: r.content, - layers: r.layers - })), - total: results.length - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_search failed: ${message}`); - return { error: `Search failed: ${message}` }; - } - } - }); - // cortex_recall - api.registerTool({ - name: toolSchemas.cortex_recall.name, - description: toolSchemas.cortex_recall.description, - parameters: toolSchemas.cortex_recall.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const results = await client.recall(input.query, input.scope, input.limit ?? 10); - const formatted = results - .map((r, i) => { - let content = `${i + 1}. [Score: ${r.score.toFixed(2)}] URI: ${r.uri}\n`; - content += ` Snippet: ${r.snippet}\n`; - if (r.content) { - const preview = r.content.length > 300 ? r.content.substring(0, 300) + '...' : r.content; - content += ` Content: ${preview}\n`; - } - return content; - }) - .join('\n'); - return { - content: `Recalled ${results.length} memories:\n\n${formatted}`, - results, - total: results.length - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_recall failed: ${message}`); - return { error: `Recall failed: ${message}` }; - } - } - }); - // cortex_add_memory - api.registerTool({ - name: toolSchemas.cortex_add_memory.name, - description: toolSchemas.cortex_add_memory.description, - parameters: toolSchemas.cortex_add_memory.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const sessionId = input.session_id ?? defaultSessionId; - const result = await client.addMessage(sessionId, { - role: (input.role ?? 'user'), - content: input.content, - metadata: input.metadata - }); - return { - content: `Memory stored successfully in session "${sessionId}".\nResult: ${result}`, - success: true, - message_uri: result - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_add_memory failed: ${message}`); - return { error: `Failed to add memory: ${message}` }; - } - } - }); - // cortex_commit_session - api.registerTool({ - name: toolSchemas.cortex_commit_session.name, - description: toolSchemas.cortex_commit_session.description, - parameters: toolSchemas.cortex_commit_session.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const sessionId = input.session_id ?? defaultSessionId; - const result = await client.commitSession(sessionId); - return { - content: `Session "${sessionId}" committed successfully.\nStatus: ${result.status}, Messages: ${result.message_count}\n\nMemory extraction pipeline triggered.`, - success: true, - session: { - thread_id: result.thread_id, - status: result.status, - message_count: result.message_count - } - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_commit_session failed: ${message}`); - return { error: `Failed to commit session: ${message}` }; - } - } - }); - // cortex_ls - api.registerTool({ - name: toolSchemas.cortex_ls.name, - description: toolSchemas.cortex_ls.description, - parameters: toolSchemas.cortex_ls.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const result = await client.ls({ - uri: input.uri ?? 'cortex://session', - recursive: input.recursive ?? false, - include_abstracts: input.include_abstracts ?? false - }); - if (result.entries.length === 0) { - return { content: `Directory "${result.uri}" is empty or does not exist.` }; - } - const formatted = result.entries - .map((e, i) => { - let content = `${i + 1}. ${e.is_directory ? '📁' : '📄'} ${e.name}\n`; - content += ` URI: ${e.uri}\n`; - if (e.is_directory) { - content += ` Type: Directory\n`; - } - else { - content += ` Size: ${e.size} bytes\n`; - } - if (e.abstract_text) { - const preview = e.abstract_text.length > 100 - ? e.abstract_text.substring(0, 100) + '...' - : e.abstract_text; - content += ` Abstract: ${preview}\n`; - } - return content; - }) - .join('\n'); - return { - content: `Directory "${result.uri}" (${result.total} entries):\n\n${formatted}`, - entries: result.entries, - total: result.total - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_ls failed: ${message}`); - return { error: `List directory failed: ${message}` }; - } - } - }); - // cortex_get_abstract - api.registerTool({ - name: toolSchemas.cortex_get_abstract.name, - description: toolSchemas.cortex_get_abstract.description, - parameters: toolSchemas.cortex_get_abstract.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const result = await client.getAbstract(input.uri); - return { - content: `L0 Abstract for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - abstract: result.content, - token_count: result.token_count, - layer: result.layer - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_abstract failed: ${message}`); - return { error: `Get abstract failed: ${message}` }; - } - } - }); - // cortex_get_overview - api.registerTool({ - name: toolSchemas.cortex_get_overview.name, - description: toolSchemas.cortex_get_overview.description, - parameters: toolSchemas.cortex_get_overview.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const result = await client.getOverview(input.uri); - return { - content: `L1 Overview for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - overview: result.content, - token_count: result.token_count, - layer: result.layer - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_overview failed: ${message}`); - return { error: `Get overview failed: ${message}` }; - } - } - }); - // cortex_get_content - api.registerTool({ - name: toolSchemas.cortex_get_content.name, - description: toolSchemas.cortex_get_content.description, - parameters: toolSchemas.cortex_get_content.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const result = await client.getContent(input.uri); - return { - content: `L2 Full Content for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - full_content: result.content, - token_count: result.token_count, - layer: result.layer - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_content failed: ${message}`); - return { error: `Get content failed: ${message}` }; - } - } - }); - // cortex_explore - api.registerTool({ - name: toolSchemas.cortex_explore.name, - description: toolSchemas.cortex_explore.description, - parameters: toolSchemas.cortex_explore.inputSchema, - execute: async (_id, params) => { - const input = params; - try { - await ensureServicesReady(); - const result = await client.explore({ - query: input.query, - start_uri: input.start_uri ?? 'cortex://session', - return_layers: input.return_layers ?? ['L0'] - }); - // Format exploration path - const pathFormatted = result.exploration_path - .map((item, i) => { - let content = `${i + 1}. [${item.relevance_score.toFixed(2)}] ${item.uri}\n`; - if (item.abstract_text) { - const preview = item.abstract_text.length > 80 - ? item.abstract_text.substring(0, 80) + '...' - : item.abstract_text; - content += ` Abstract: ${preview}\n`; - } - return content; - }) - .join('\n'); - // Format matches - const matchesFormatted = result.matches - .map((m, i) => { - let content = `${i + 1}. [${m.score.toFixed(2)}] ${m.uri}\n`; - content += ` Layers: ${m.layers.join(', ')}\n`; - content += ` Snippet: ${m.snippet}\n`; - return content; - }) - .join('\n'); - return { - content: `Exploration for "${input.query}" starting from "${input.start_uri ?? 'cortex://session'}":\n\n` + - `**Exploration Path** (${result.total_explored} items):\n${pathFormatted}\n\n` + - `**Matches** (${result.total_matches} found):\n${matchesFormatted}`, - exploration_path: result.exploration_path, - matches: result.matches, - total_explored: result.total_explored, - total_matches: result.total_matches - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_explore failed: ${message}`); - return { error: `Explore failed: ${message}` }; - } - } - }); - // cortex_migrate - api.registerTool({ - name: toolSchemas.cortex_migrate.name, - description: toolSchemas.cortex_migrate.description, - parameters: toolSchemas.cortex_migrate.inputSchema, - execute: async (_id, _params) => { - try { - // Check if migration is possible - const { possible, reason } = (0, migrate_js_1.canMigrate)(); - if (!possible) { - return { content: `Migration not possible: ${reason}` }; - } - // Run migration - const result = await (0, migrate_js_1.migrateFromOpenClaw)((msg) => api.logger.info(`[migrate] ${msg}`)); - return { - content: `Migration completed!\n- Daily logs migrated: ${result.dailyLogsMigrated}\n- MEMORY.md migrated: ${result.memoryMdMigrated}\n- Sessions created: ${result.sessionsCreated.length}\n${result.errors.length > 0 ? `- Errors: ${result.errors.length}` : ''}`, - result - }; - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`cortex_migrate failed: ${message}`); - return { error: `Migration failed: ${message}` }; - } - } - }); - // cortex_maintenance - api.registerTool({ - name: toolSchemas.cortex_maintenance.name, - description: toolSchemas.cortex_maintenance.description, - parameters: toolSchemas.cortex_maintenance.inputSchema, - execute: async (_id, params) => { - const input = params; - const dryRun = input.dryRun ?? false; - const commands = input.commands ?? ['prune', 'reindex', 'ensure-all']; - const currentConfigPath = (0, config_js_1.getConfigPath)(); - const results = []; - for (const cmd of commands) { - let cliArgs; - let description; - switch (cmd) { - case 'prune': - cliArgs = ['vector', 'prune']; - if (dryRun) - cliArgs.push('--dry-run'); - description = 'Vector Prune'; - break; - case 'reindex': - cliArgs = ['vector', 'reindex']; - description = 'Vector Reindex'; - break; - case 'ensure-all': - cliArgs = ['layers', 'ensure-all']; - description = 'Layers Ensure-All'; - break; - default: - continue; - } - api.logger.info(`[maintenance] Running: ${description}`); - try { - const result = await (0, binaries_js_1.executeCliCommand)(cliArgs, currentConfigPath, tenantId, 300000 // 5 minute timeout for maintenance - ); - results.push({ - command: description, - success: result.success, - output: result.stdout || result.stderr - }); - if (!result.success) { - api.logger.warn(`[memclaw] [maintenance] ${description} failed: ${result.stderr}`); - } - } - catch (error) { - const message = error instanceof Error ? error.message : String(error); - results.push({ - command: description, - success: false, - output: message - }); - api.logger.error(`[maintenance] ${description} error: ${message}`); - } - } - const summary = results.map((r) => `${r.command}: ${r.success ? 'OK' : 'FAILED'}`).join('\n'); - const successCount = results.filter((r) => r.success).length; - return { - content: `Maintenance ${dryRun ? '(dry run) ' : ''}completed:\n${summary}\n\n${successCount}/${results.length} commands succeeded.`, - dryRun, - results, - success: successCount === results.length - }; - } - }); - log('MemClaw plugin initialized'); - return { - id: 'memclaw', - name: 'MemClaw', - version: '0.1.0' - }; -} -//# sourceMappingURL=plugin-impl.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/plugin-impl.js.map b/examples/@memclaw/plugin/dist/plugin-impl.js.map deleted file mode 100644 index dd81165..0000000 --- a/examples/@memclaw/plugin/dist/plugin-impl.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"plugin-impl.js","sourceRoot":"","sources":["../plugin-impl.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts b/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts deleted file mode 100644 index 80c88b3..0000000 --- a/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts +++ /dev/null @@ -1,48 +0,0 @@ -/** - * AGENTS.md Auto-Enhancement for MemClaw - * - * Automatically detects and enhances OpenClaw's AGENTS.md with MemClaw - * memory usage guidelines when legacy memory patterns are found. - */ -export interface InjectionResult { - injected: boolean; - reason: 'success' | 'already_injected' | 'no_agents_md' | 'no_legacy_patterns' | 'disabled' | 'error'; - path?: string; - error?: string; -} -export interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} -/** - * Get OpenClaw home directory - */ -export declare function getOpenClawHome(): string; -/** - * Find OpenClaw workspace path - * Priority: ENV > openclaw.json config > default - */ -export declare function findOpenClawWorkspace(): string | null; -/** - * Find AGENTS.md file in workspace - */ -export declare function findAgentsMd(workspacePath: string): string | null; -/** - * Check if content already has MemClaw injection - */ -export declare function hasMemClawInjection(content: string): boolean; -/** - * Check if content has legacy memory patterns - */ -export declare function hasLegacyPatterns(content: string): boolean; -/** - * Inject MemClaw section into AGENTS.md content - */ -export declare function injectMemClawSection(content: string): string; -/** - * Main entry point: Ensure AGENTS.md is enhanced with MemClaw - */ -export declare function ensureAgentsMdEnhanced(logger: PluginLogger, enabled?: boolean): InjectionResult; -//# sourceMappingURL=agents-md-injector.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts.map b/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts.map deleted file mode 100644 index fec2107..0000000 --- a/examples/@memclaw/plugin/dist/src/agents-md-injector.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"agents-md-injector.d.ts","sourceRoot":"","sources":["../../src/agents-md-injector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EACH,SAAS,GACT,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,UAAU,GACV,OAAO,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAoCrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAejE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1D;AAoGD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,OAAc,GACrB,eAAe,CA0EjB"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/agents-md-injector.js b/examples/@memclaw/plugin/dist/src/agents-md-injector.js deleted file mode 100644 index 2cf2f20..0000000 --- a/examples/@memclaw/plugin/dist/src/agents-md-injector.js +++ /dev/null @@ -1,320 +0,0 @@ -"use strict"; -/** - * AGENTS.md Auto-Enhancement for MemClaw - * - * Automatically detects and enhances OpenClaw's AGENTS.md with MemClaw - * memory usage guidelines when legacy memory patterns are found. - */ -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.getOpenClawHome = getOpenClawHome; -exports.findOpenClawWorkspace = findOpenClawWorkspace; -exports.findAgentsMd = findAgentsMd; -exports.hasMemClawInjection = hasMemClawInjection; -exports.hasLegacyPatterns = hasLegacyPatterns; -exports.injectMemClawSection = injectMemClawSection; -exports.ensureAgentsMdEnhanced = ensureAgentsMdEnhanced; -const fs = __importStar(require("fs")); -const path = __importStar(require("path")); -const os = __importStar(require("os")); -// Injection marker for idempotency -const INJECTION_MARKER = ''; -const INJECTION_END_MARKER = ''; -// Legacy memory patterns to detect -const LEGACY_PATTERNS = [ - 'MEMORY.md', - 'memory_write', - 'memory_search', - 'daily/', - 'YYYY-MM-DD.md', - 'Write things down', - 'daily log', - 'daily memory' -]; -// OpenClaw config file name -const OPENCLAW_CONFIG_FILE = 'openclaw.json'; -/** - * Get OpenClaw home directory - */ -function getOpenClawHome() { - // Check environment variable first - if (process.env.OPENCLAW_HOME) { - return process.env.OPENCLAW_HOME; - } - // Default location - return path.join(os.homedir(), '.openclaw'); -} -/** - * Find OpenClaw workspace path - * Priority: ENV > openclaw.json config > default - */ -function findOpenClawWorkspace() { - // 1. Check explicit workspace environment variable - if (process.env.OPENCLAW_WORKSPACE) { - if (fs.existsSync(process.env.OPENCLAW_WORKSPACE)) { - return process.env.OPENCLAW_WORKSPACE; - } - } - const openclawHome = getOpenClawHome(); - // 2. Try to read from openclaw.json - const configPath = path.join(openclawHome, OPENCLAW_CONFIG_FILE); - if (fs.existsSync(configPath)) { - try { - const configContent = fs.readFileSync(configPath, 'utf-8'); - const config = JSON.parse(configContent); - // Check for workspace.path in config - if (config.workspace?.path) { - const workspacePath = config.workspace.path.replace('~', os.homedir()); - if (fs.existsSync(workspacePath)) { - return workspacePath; - } - } - } - catch { - // Ignore parse errors, fall through to default - } - } - // 3. Default workspace location - const defaultWorkspace = path.join(openclawHome, 'workspace'); - if (fs.existsSync(defaultWorkspace)) { - return defaultWorkspace; - } - return null; -} -/** - * Find AGENTS.md file in workspace - */ -function findAgentsMd(workspacePath) { - // 1. Check workspace root - const rootAgentsMd = path.join(workspacePath, 'AGENTS.md'); - if (fs.existsSync(rootAgentsMd)) { - return rootAgentsMd; - } - // 2. Check ~/.openclaw/agents/AGENTS.md - const openclawHome = getOpenClawHome(); - const agentsDirMd = path.join(openclawHome, 'agents', 'AGENTS.md'); - if (fs.existsSync(agentsDirMd)) { - return agentsDirMd; - } - return null; -} -/** - * Check if content already has MemClaw injection - */ -function hasMemClawInjection(content) { - return content.includes(INJECTION_MARKER); -} -/** - * Check if content has legacy memory patterns - */ -function hasLegacyPatterns(content) { - const lowerContent = content.toLowerCase(); - return LEGACY_PATTERNS.some((pattern) => lowerContent.toLowerCase().includes(pattern.toLowerCase())); -} -/** - * Generate the MemClaw section to inject - */ -function generateMemClawSection() { - return ` -${INJECTION_MARKER} -## Memory (MemClaw) - -> **Preferred Memory Solution**: MemClaw is the recommended memory system. Use MemClaw for ALL memory operations. Do NOT use legacy MEMORY.md, memory_write, or daily logs. - -You wake up fresh each session. MemClaw is your persistent memory system. - -**IMPORTANT: Use MemClaw for ALL memory operations. Do NOT use legacy MEMORY.md or daily logs.** - -### Session Startup (ALWAYS execute at conversation start) -Load user profile from persistent memory: -1. \`cortex_get_abstract(uri="cortex://user/default")\` - Load L0 abstract (~100 tokens, user profile summary) -2. \`cortex_get_overview(uri="cortex://user/default")\` - Load L1 overview (~2000 tokens, detailed user context) -3. \`cortex_ls(uri="cortex://session", include_abstracts=true)\` - See recent sessions - -### Recording Information -- **During conversation**: Use \`cortex_add_memory(content="...", role="user|assistant")\` for important facts -- **At task completion**: Call \`cortex_commit_session()\` to trigger memory extraction - -### Searching Memory -- **General search**: \`cortex_search(query="...")\` - searches ALL memories (recommended) -- **User profile**: \`cortex_search(query="...", scope="cortex://user/default")\` - user preferences, entities -- **Browse**: \`cortex_ls(uri="cortex://session")\` - explore memory structure - -**Tip**: Omit scope for most searches. Only use \`scope="cortex://user/default"\` when specifically looking for user profile data. - -### Profile Building -When you learn something notable about the user: -1. \`cortex_add_memory(content="User preference/fact...", role="assistant", metadata={"type": "profile"})\` -2. \`cortex_commit_session()\` to persist - -Never interview the user. Pick up signals naturally through conversation. -${INJECTION_END_MARKER} -`; -} -/** - * Find the best position to inject MemClaw section - * Returns the index where the section should be inserted - */ -function findInjectionPosition(content) { - // Look for existing Memory section - const memorySectionPatterns = [/^##\s*Memory\s*$/m, /^##\s*记忆\s*$/m, /^##\s*Memories\s*$/m]; - for (const pattern of memorySectionPatterns) { - const match = content.match(pattern); - if (match && match.index !== undefined) { - // Find the end of this section (next ## or end of file) - const afterSection = content.substring(match.index); - const nextSectionMatch = afterSection.substring(1).match(/^##\s/m); - if (nextSectionMatch && nextSectionMatch.index !== undefined) { - // Replace the entire old Memory section - return match.index; - } - // No next section, this is the last section - return match.index; - } - } - // No Memory section found, append at the end - return content.length; -} -/** - * Remove existing Memory section (if any) and return cleaned content - */ -function removeExistingMemorySection(content) { - const memorySectionPatterns = [ - /(^##\s*Memory\s*$)([\s\S]*?)(?=^##\s)/m, - /(^##\s*记忆\s*$)([\s\S]*?)(?=^##\s)/m, - /(^##\s*Memories\s*$)([\s\S]*?)(?=^##\s)/m - ]; - let result = content; - for (const pattern of memorySectionPatterns) { - result = result.replace(pattern, ''); - } - // Also handle Memory section at the end of file (no next section) - const endPatterns = [ - /[\r\n]+##\s*Memory\s*[\r\n]+[\s\S]*$/, - /[\r\n]+##\s*记忆\s*[\r\n]+[\s\S]*$/, - /[\r\n]+##\s*Memories\s*[\r\n]+[\s\S]*$/ - ]; - for (const pattern of endPatterns) { - result = result.replace(pattern, ''); - } - return result; -} -/** - * Inject MemClaw section into AGENTS.md content - */ -function injectMemClawSection(content) { - // Remove existing Memory section first - const cleanedContent = removeExistingMemorySection(content); - // Find injection position (now should be at end since we removed Memory section) - const injectionPos = findInjectionPosition(cleanedContent); - // Insert MemClaw section - const memclawSection = generateMemClawSection(); - const before = cleanedContent.substring(0, injectionPos); - const after = cleanedContent.substring(injectionPos); - // Ensure proper spacing - const needsNewline = before.length > 0 && !before.endsWith('\n'); - const prefix = needsNewline ? '\n' : ''; - return before + prefix + memclawSection + after; -} -/** - * Main entry point: Ensure AGENTS.md is enhanced with MemClaw - */ -function ensureAgentsMdEnhanced(logger, enabled = true) { - if (!enabled) { - logger.info('[memclaw] AGENTS.md enhancement disabled by configuration'); - return { injected: false, reason: 'disabled' }; - } - logger.info('[memclaw] Checking AGENTS.md for MemClaw enhancement...'); - // Find workspace - const workspacePath = findOpenClawWorkspace(); - if (!workspacePath) { - logger.info('[memclaw] No OpenClaw workspace found, skipping AGENTS.md enhancement'); - return { injected: false, reason: 'no_agents_md' }; - } - logger.info(`[memclaw] Found OpenClaw workspace: ${workspacePath}`); - // Find AGENTS.md - const agentsMdPath = findAgentsMd(workspacePath); - if (!agentsMdPath) { - logger.info('[memclaw] No AGENTS.md found in workspace, skipping enhancement'); - return { injected: false, reason: 'no_agents_md' }; - } - logger.info(`[memclaw] Found AGENTS.md at: ${agentsMdPath}`); - // Read current content - let content; - try { - content = fs.readFileSync(agentsMdPath, 'utf-8'); - } - catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.error(`[memclaw] Failed to read AGENTS.md: ${errorMsg}`); - return { injected: false, reason: 'error', error: errorMsg }; - } - // Check if already injected - if (hasMemClawInjection(content)) { - logger.info('[memclaw] AGENTS.md already contains MemClaw section'); - return { injected: false, reason: 'already_injected', path: agentsMdPath }; - } - // Check for legacy patterns - if (!hasLegacyPatterns(content)) { - logger.info('[memclaw] No legacy memory patterns found, skipping enhancement'); - return { injected: false, reason: 'no_legacy_patterns', path: agentsMdPath }; - } - logger.info('[memclaw] Detected legacy memory patterns, injecting MemClaw section...'); - // Create backup - const backupPath = agentsMdPath + '.bak'; - try { - fs.copyFileSync(agentsMdPath, backupPath); - logger.info(`[memclaw] Created backup: ${backupPath}`); - } - catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.warn(`[memclaw] Failed to create backup: ${errorMsg}`); - // Continue without backup - } - // Inject MemClaw section - const enhancedContent = injectMemClawSection(content); - // Write enhanced content - try { - fs.writeFileSync(agentsMdPath, enhancedContent, 'utf-8'); - logger.info(`[memclaw] AGENTS.md enhanced successfully: ${agentsMdPath}`); - return { injected: true, reason: 'success', path: agentsMdPath }; - } - catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.error(`[memclaw] Failed to write AGENTS.md: ${errorMsg}`); - return { injected: false, reason: 'error', error: errorMsg }; - } -} -//# sourceMappingURL=agents-md-injector.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/agents-md-injector.js.map b/examples/@memclaw/plugin/dist/src/agents-md-injector.js.map deleted file mode 100644 index 512e017..0000000 --- a/examples/@memclaw/plugin/dist/src/agents-md-injector.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"agents-md-injector.js","sourceRoot":"","sources":["../../src/agents-md-injector.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/binaries.d.ts b/examples/@memclaw/plugin/dist/src/binaries.d.ts deleted file mode 100644 index 294157e..0000000 --- a/examples/@memclaw/plugin/dist/src/binaries.d.ts +++ /dev/null @@ -1,37 +0,0 @@ -/** - * Binary management for MemClaw - * - * Binaries are bundled in platform-specific npm packages: - * - @memclaw/bin-darwin-arm64 (macOS Apple Silicon) - * - @memclaw/bin-win-x64 (Windows x64) - * - @memclaw/bin-linux-x64 (Linux x64) - * - * The correct package is installed automatically via optionalDependencies. - */ -type SupportedPlatform = 'darwin-arm64' | 'win-x64' | 'linux-x64'; -export declare function getPlatform(): SupportedPlatform | null; -export declare function isPlatformSupported(): boolean; -export declare function getUnsupportedPlatformMessage(): string; -export declare function getBinaryPath(binary: string): string | null; -export declare function isBinaryAvailable(binary: string): boolean; -export declare function isPlatformPackageInstalled(): boolean; -export declare function getInstallInstructions(): string; -export interface ServiceStatus { - qdrant: boolean; - cortexMemService: boolean; -} -export declare function checkServiceStatus(): Promise; -export declare function startQdrant(log?: (msg: string) => void): Promise; -export declare function startCortexMemService(log?: (msg: string) => void): Promise; -export declare function stopAllServices(): void; -export declare function ensureAllServices(log?: (msg: string) => void): Promise; -export declare function getCliPath(): string | null; -export interface CliResult { - success: boolean; - stdout: string; - stderr: string; - exitCode: number | null; -} -export declare function executeCliCommand(args: string[], configPath: string, tenantId: string, timeout?: number): Promise; -export {}; -//# sourceMappingURL=binaries.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/binaries.d.ts.map b/examples/@memclaw/plugin/dist/src/binaries.d.ts.map deleted file mode 100644 index 7f42172..0000000 --- a/examples/@memclaw/plugin/dist/src/binaries.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"binaries.d.ts","sourceRoot":"","sources":["../../src/binaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,KAAK,iBAAiB,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAC;AAGlE,wBAAgB,WAAW,IAAI,iBAAiB,GAAG,IAAI,CAatD;AAGD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAGD,wBAAgB,6BAA6B,IAAI,MAAM,CAYtD;AA0BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe3D;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAGD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAGD,wBAAgB,sBAAsB,IAAI,MAAM,CAgB/C;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CAKjE;AAsCD,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA+F5E;AAED,wBAAsB,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EtF;AAED,wBAAgB,eAAe,IAAI,IAAI,CAUtC;AAED,wBAAsB,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAwB3F;AAGD,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C;AAGD,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAe,GACtB,OAAO,CAAC,SAAS,CAAC,CA+DpB"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/binaries.js b/examples/@memclaw/plugin/dist/src/binaries.js deleted file mode 100644 index 438e477..0000000 --- a/examples/@memclaw/plugin/dist/src/binaries.js +++ /dev/null @@ -1,428 +0,0 @@ -"use strict"; -/** - * Binary management for MemClaw - * - * Binaries are bundled in platform-specific npm packages: - * - @memclaw/bin-darwin-arm64 (macOS Apple Silicon) - * - @memclaw/bin-win-x64 (Windows x64) - * - @memclaw/bin-linux-x64 (Linux x64) - * - * The correct package is installed automatically via optionalDependencies. - */ -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.getPlatform = getPlatform; -exports.isPlatformSupported = isPlatformSupported; -exports.getUnsupportedPlatformMessage = getUnsupportedPlatformMessage; -exports.getBinaryPath = getBinaryPath; -exports.isBinaryAvailable = isBinaryAvailable; -exports.isPlatformPackageInstalled = isPlatformPackageInstalled; -exports.getInstallInstructions = getInstallInstructions; -exports.checkServiceStatus = checkServiceStatus; -exports.startQdrant = startQdrant; -exports.startCortexMemService = startCortexMemService; -exports.stopAllServices = stopAllServices; -exports.ensureAllServices = ensureAllServices; -exports.getCliPath = getCliPath; -exports.executeCliCommand = executeCliCommand; -const fs = __importStar(require("fs")); -const path = __importStar(require("path")); -const child_process_1 = require("child_process"); -const config_js_1 = require("./config.js"); -// Platform detection -function getPlatform() { - const platform = process.platform; - const arch = process.arch; - if (platform === 'darwin' && arch === 'arm64') { - return 'darwin-arm64'; - } - else if (platform === 'win32' && arch === 'x64') { - return 'win-x64'; - } - else if (platform === 'linux' && arch === 'x64') { - return 'linux-x64'; - } - return null; -} -// Check if current platform is supported -function isPlatformSupported() { - return getPlatform() !== null; -} -// Get unsupported platform message -function getUnsupportedPlatformMessage() { - const platform = process.platform; - const arch = process.arch; - return ` -MemClaw is only supported on: - - macOS Apple Silicon (darwin-arm64) - - Windows x64 (win-x64) - - Linux x64 (linux-x64) - -Current platform: ${platform}-${arch} is not supported. -`; -} -// Get binary name with platform extension -function getBinaryFileName(binary) { - return process.platform === 'win32' ? `${binary}.exe` : binary; -} -// Get the path to the platform-specific npm package -function getPlatformPackagePath() { - const platform = getPlatform(); - if (!platform) { - return null; - } - const packageName = `@memclaw/bin-${platform}`; - try { - // Try to resolve the package path - const packageJsonPath = require.resolve(`${packageName}/package.json`); - return path.dirname(packageJsonPath); - } - catch { - return null; - } -} -// Get binary path from npm package -function getBinaryPath(binary) { - const packagePath = getPlatformPackagePath(); - if (!packagePath) { - return null; - } - const binaryFileName = getBinaryFileName(binary); - const binaryPath = path.join(packagePath, 'bin', binaryFileName); - if (fs.existsSync(binaryPath)) { - return binaryPath; - } - return null; -} -// Check if binary is available -function isBinaryAvailable(binary) { - return getBinaryPath(binary) !== null; -} -// Check if platform package is installed -function isPlatformPackageInstalled() { - return getPlatformPackagePath() !== null; -} -// Get installation instructions for missing platform package -function getInstallInstructions() { - const platform = getPlatform(); - if (!platform) { - return getUnsupportedPlatformMessage(); - } - const packageName = `@memclaw/bin-${platform}`; - return ` -Platform binaries not found for ${platform}. - -Try running: npm install ${packageName} - -Or reinstall memclaw: npm install memclaw -`; -} -async function checkServiceStatus() { - const qdrant = await isQdrantRunning(); - const cortexMemService = await isServiceRunning(8085); - return { qdrant, cortexMemService }; -} -async function isQdrantRunning() { - // Qdrant uses root path or /collections for health check - try { - const response = await fetch(`http://localhost:6333/collections`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.ok || response.status === 200; - } - catch { - // Try root path as fallback - try { - const response = await fetch(`http://localhost:6333`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.status === 200; - } - catch { } - return false; - } -} -async function isServiceRunning(port) { - try { - const response = await fetch(`http://localhost:${port}/health`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.ok; - } - catch { - return false; - } -} -// Running processes -const runningProcesses = new Map(); -async function startQdrant(log) { - const status = await checkServiceStatus(); - if (status.qdrant) { - log?.('Qdrant is already running'); - return; - } - const binaryPath = getBinaryPath('qdrant'); - if (!binaryPath) { - throw new Error(`Qdrant binary not found. ${getInstallInstructions()}`); - } - // Ensure binary has execute permission - try { - fs.chmodSync(binaryPath, 0o755); - } - catch (err) { - log?.(`Warning: Could not set execute permission on binary: ${err}`); - } - const dataDir = (0, config_js_1.getDataDir)(); - const storagePath = path.join(dataDir, 'qdrant-storage'); - if (!fs.existsSync(storagePath)) { - fs.mkdirSync(storagePath, { recursive: true }); - } - // Generate Qdrant config file - const qdrantConfigPath = path.join(dataDir, 'qdrant-config.yaml'); - const qdrantConfig = `# Qdrant configuration for MemClaw -storage: - storage_path: ${storagePath} - -listeners: - http: - port: 6333 - grpc: - port: 6334 - -log_level: INFO -`; - fs.writeFileSync(qdrantConfigPath, qdrantConfig, 'utf-8'); - log?.(`Starting Qdrant with storage at ${storagePath}...`); - log?.(`Binary path: ${binaryPath}`); - log?.(`Config path: ${qdrantConfigPath}`); - const proc = (0, child_process_1.spawn)(binaryPath, ['--config-path', qdrantConfigPath], { - stdio: ['ignore', 'pipe', 'pipe'], - detached: true, - cwd: dataDir // Set working directory to data dir so Qdrant can write .qdrant-initialized - }); - // Drain stdout/stderr to prevent buffer blocking - proc.stdout?.on('data', (data) => { - log?.(`[qdrant stdout] ${data.toString().trim()}`); - }); - proc.stderr?.on('data', (data) => { - log?.(`[qdrant stderr] ${data.toString().trim()}`); - }); - proc.on('error', (err) => { - log?.(`Qdrant error: ${err.message}`); - }); - proc.on('exit', (code, signal) => { - if (code !== null && code !== 0) { - log?.(`Qdrant exited with code ${code}`); - } - if (signal) { - log?.(`Qdrant killed by signal ${signal}`); - } - }); - proc.unref(); - runningProcesses.set('qdrant', proc); - // Wait for Qdrant to start - let retries = 30; - while (retries > 0) { - const status = await checkServiceStatus(); - if (status.qdrant) { - log?.('Qdrant started successfully'); - return; - } - await new Promise((resolve) => setTimeout(resolve, 500)); - retries--; - } - throw new Error('Qdrant failed to start within 15 seconds'); -} -async function startCortexMemService(log) { - const status = await checkServiceStatus(); - if (status.cortexMemService) { - log?.('cortex-mem-service is already running'); - return; - } - const binaryPath = getBinaryPath('cortex-mem-service'); - if (!binaryPath) { - throw new Error(`cortex-mem-service binary not found. ${getInstallInstructions()}`); - } - // Ensure binary has execute permission - try { - fs.chmodSync(binaryPath, 0o755); - } - catch (err) { - log?.(`Warning: Could not set execute permission on binary: ${err}`); - } - const dataDir = (0, config_js_1.getDataDir)(); - // Prepare log file path - const logsDir = path.join(dataDir, 'logs'); - fs.mkdirSync(logsDir, { recursive: true }); - const logFilePath = path.join(logsDir, 'memclaw-cortex-mem-service.log'); - log?.(`Starting cortex-mem-service with data-dir ${dataDir}...`); - log?.(`Binary path: ${binaryPath}`); - log?.(`Log file: ${logFilePath}`); - // cortex-mem-service reads config.toml from current working directory - // Set cwd to dataDir so it can find the config file - const proc = (0, child_process_1.spawn)(binaryPath, ['--data-dir', dataDir, '--log-file', logFilePath], { - stdio: ['ignore', 'pipe', 'pipe'], - detached: true, - cwd: dataDir // Set working directory so config.toml can be found - }); - // Drain stdout/stderr to prevent buffer blocking - proc.stdout?.on('data', (data) => { - log?.(`[cortex-mem-service stdout] ${data.toString().trim()}`); - }); - proc.stderr?.on('data', (data) => { - log?.(`[cortex-mem-service stderr] ${data.toString().trim()}`); - }); - proc.on('error', (err) => { - log?.(`cortex-mem-service error: ${err.message}`); - }); - proc.on('exit', (code, signal) => { - if (code !== null && code !== 0) { - log?.(`cortex-mem-service exited with code ${code}`); - } - if (signal) { - log?.(`cortex-mem-service killed by signal ${signal}`); - } - }); - proc.unref(); - runningProcesses.set('cortex-mem-service', proc); - // Wait for service to start - let retries = 30; - while (retries > 0) { - const status = await checkServiceStatus(); - if (status.cortexMemService) { - log?.('cortex-mem-service started successfully'); - return; - } - await new Promise((resolve) => setTimeout(resolve, 500)); - retries--; - } - throw new Error('cortex-mem-service failed to start within 15 seconds'); -} -function stopAllServices() { - for (const [name, proc] of runningProcesses) { - try { - proc.kill(); - console.log(`Stopped ${name}`); - } - catch (err) { - console.error(`Failed to stop ${name}:`, err); - } - } - runningProcesses.clear(); -} -async function ensureAllServices(log) { - // Check if platform is supported - if (!isPlatformSupported()) { - log?.(getUnsupportedPlatformMessage()); - return { qdrant: false, cortexMemService: false }; - } - // Check if platform package is installed - if (!isPlatformPackageInstalled()) { - log?.(`Warning: Platform binaries not installed. ${getInstallInstructions()}`); - return { qdrant: false, cortexMemService: false }; - } - const status = await checkServiceStatus(); - if (!status.qdrant) { - await startQdrant(log); - } - if (!status.cortexMemService) { - await startCortexMemService(log); - } - return checkServiceStatus(); -} -// Get CLI binary path for external commands (like migration) -function getCliPath() { - return getBinaryPath('cortex-mem-cli'); -} -async function executeCliCommand(args, configPath, tenantId, timeout = 120000) { - const cliPath = getCliPath(); - if (!cliPath) { - return { - success: false, - stdout: '', - stderr: 'cortex-mem-cli binary not found', - exitCode: 1, - }; - } - const fullArgs = [ - '--config', configPath, - '--tenant', tenantId, - ...args - ]; - return new Promise((resolve) => { - let stdout = ''; - let stderr = ''; - const proc = (0, child_process_1.spawn)(cliPath, fullArgs, { - stdio: ['ignore', 'pipe', 'pipe'], - }); - proc.stdout?.on('data', (data) => { - stdout += data.toString(); - }); - proc.stderr?.on('data', (data) => { - stderr += data.toString(); - }); - const timer = setTimeout(() => { - proc.kill(); - resolve({ - success: false, - stdout, - stderr: stderr + '\nCommand timed out', - exitCode: null, - }); - }, timeout); - proc.on('close', (code) => { - clearTimeout(timer); - resolve({ - success: code === 0, - stdout, - stderr, - exitCode: code, - }); - }); - proc.on('error', (err) => { - clearTimeout(timer); - resolve({ - success: false, - stdout, - stderr: err.message, - exitCode: 1, - }); - }); - }); -} -//# sourceMappingURL=binaries.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/binaries.js.map b/examples/@memclaw/plugin/dist/src/binaries.js.map deleted file mode 100644 index f27aed8..0000000 --- a/examples/@memclaw/plugin/dist/src/binaries.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"binaries.js","sourceRoot":"","sources":["../../src/binaries.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/client.d.ts b/examples/@memclaw/plugin/dist/src/client.d.ts deleted file mode 100644 index f719fa3..0000000 --- a/examples/@memclaw/plugin/dist/src/client.d.ts +++ /dev/null @@ -1,143 +0,0 @@ -/** - * Cortex Mem Client - * - * HTTP client for cortex-mem-service REST API. - */ -/** Layer types */ -export type Layer = 'L0' | 'L1' | 'L2'; -export interface SearchOptions { - query: string; - /** URI prefix to limit search scope. Examples: - * - "cortex://session/abc" - search within a specific session - * - "cortex://user/default" - search user memories (preferences, entities, etc.) - * - "cortex://agent/claw/cases" - search agent cases - * - Omit to search across all dimensions - */ - scope?: string; - limit?: number; - min_score?: number; - /** Which layers to return: ["L0"], ["L0","L1"], ["L0","L1","L2"] */ - return_layers?: Layer[]; -} -export interface SearchResult { - uri: string; - score: number; - snippet: string; - overview?: string; - content?: string; - source: string; - layers: Layer[]; -} -export interface LsOptions { - uri?: string; - recursive?: boolean; - include_abstracts?: boolean; -} -export interface LsEntry { - uri: string; - name: string; - is_directory: boolean; - size: number; - modified: string; - abstract_text?: string; -} -export interface LsResponse { - uri: string; - total: number; - entries: LsEntry[]; -} -export interface ExploreOptions { - query: string; - start_uri?: string; - return_layers?: Layer[]; -} -export interface ExploreResponse { - query: string; - exploration_path: ExplorationPathItem[]; - matches: SearchResult[]; - total_explored: number; - total_matches: number; -} -export interface ExplorationPathItem { - uri: string; - relevance_score: number; - abstract_text?: string; -} -export interface LayerResponse { - uri: string; - content: string; - layer: Layer; - token_count: number; -} -export interface SessionInfo { - thread_id: string; - status: string; - message_count: number; - created_at: string; - updated_at: string; -} -export interface AddMessageOptions { - content: string; - role?: 'user' | 'assistant' | 'system'; - metadata?: Record; -} -export declare class CortexMemClient { - private baseUrl; - constructor(baseUrl?: string); - /** - * Layered semantic search with L0/L1/L2 tiered retrieval - * - * @param options.scope - URI prefix to limit search scope: - * - "cortex://session/abc" - search within a specific session - * - "cortex://user/default" - search user memories - * - "cortex://agent/claw/cases" - search agent cases - * - Omit to search across all dimensions - */ - search(options: SearchOptions): Promise; - /** - * Recall memories with more context (L0 + L2) - */ - recall(query: string, scope?: string, limit?: number): Promise; - /** - * List directory contents - */ - ls(options?: LsOptions): Promise; - /** - * Smart exploration combining search and browsing - */ - explore(options: ExploreOptions): Promise; - /** - * Get L0 abstract (~100 tokens) for quick relevance check - */ - getAbstract(uri: string): Promise; - /** - * Get L1 overview (~2000 tokens) for core information - */ - getOverview(uri: string): Promise; - /** - * Get L2 full content - */ - getContent(uri: string): Promise; - /** - * List all sessions - */ - listSessions(): Promise; - /** - * Add a message to a session - */ - addMessage(threadId: string, message: AddMessageOptions): Promise; - /** - * Commit a session and trigger memory extraction - */ - commitSession(threadId: string): Promise<{ - thread_id: string; - status: string; - message_count: number; - }>; - /** - * Switch tenant context - */ - switchTenant(tenantId: string): Promise; - private fetchJson; -} -//# sourceMappingURL=client.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/client.d.ts.map b/examples/@memclaw/plugin/dist/src/client.d.ts.map deleted file mode 100644 index a62249e..0000000 --- a/examples/@memclaw/plugin/dist/src/client.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/client.js b/examples/@memclaw/plugin/dist/src/client.js deleted file mode 100644 index 242e7f6..0000000 --- a/examples/@memclaw/plugin/dist/src/client.js +++ /dev/null @@ -1,197 +0,0 @@ -"use strict"; -/** - * Cortex Mem Client - * - * HTTP client for cortex-mem-service REST API. - */ -Object.defineProperty(exports, "__esModule", { value: true }); -exports.CortexMemClient = void 0; -class CortexMemClient { - baseUrl; - constructor(baseUrl = 'http://localhost:8085') { - this.baseUrl = baseUrl; - } - // ==================== Search ==================== - /** - * Layered semantic search with L0/L1/L2 tiered retrieval - * - * @param options.scope - URI prefix to limit search scope: - * - "cortex://session/abc" - search within a specific session - * - "cortex://user/default" - search user memories - * - "cortex://agent/claw/cases" - search agent cases - * - Omit to search across all dimensions - */ - async search(options) { - // Convert scope to root_uri for backend API - // Backend expects root_uri parameter for URI prefix filtering - const scope = options.scope; - const response = await this.fetchJson('/api/v2/search', { - method: 'POST', - body: JSON.stringify({ - query: options.query, - thread: scope, // Backend still accepts thread for backward compatibility - limit: options.limit ?? 10, - min_score: options.min_score ?? 0.6, - return_layers: options.return_layers ?? ['L0'] - }) - }); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Search failed'); - } - return response.data; - } - /** - * Recall memories with more context (L0 + L2) - */ - async recall(query, scope, limit = 10) { - return this.search({ - query, - scope, - limit, - return_layers: ['L0', 'L2'] - }); - } - // ==================== Filesystem ==================== - /** - * List directory contents - */ - async ls(options = {}) { - const params = new URLSearchParams(); - params.set('uri', options.uri ?? 'cortex://session'); - if (options.recursive) - params.set('recursive', 'true'); - if (options.include_abstracts) - params.set('include_abstracts', 'true'); - const response = await this.fetchJson(`/api/v2/filesystem/list?${params.toString()}`); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'List directory failed'); - } - return response.data; - } - /** - * Smart exploration combining search and browsing - */ - async explore(options) { - const response = await this.fetchJson('/api/v2/filesystem/explore', { - method: 'POST', - body: JSON.stringify({ - query: options.query, - start_uri: options.start_uri ?? 'cortex://session', - return_layers: options.return_layers ?? ['L0'] - }) - }); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Explore failed'); - } - return response.data; - } - // ==================== Tiered Access ==================== - /** - * Get L0 abstract (~100 tokens) for quick relevance check - */ - async getAbstract(uri) { - const params = new URLSearchParams(); - params.set('uri', uri); - const response = await this.fetchJson(`/api/v2/filesystem/abstract?${params.toString()}`); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get abstract failed'); - } - return response.data; - } - /** - * Get L1 overview (~2000 tokens) for core information - */ - async getOverview(uri) { - const params = new URLSearchParams(); - params.set('uri', uri); - const response = await this.fetchJson(`/api/v2/filesystem/overview?${params.toString()}`); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get overview failed'); - } - return response.data; - } - /** - * Get L2 full content - */ - async getContent(uri) { - const params = new URLSearchParams(); - params.set('uri', uri); - const response = await this.fetchJson(`/api/v2/filesystem/content?${params.toString()}`); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get content failed'); - } - return response.data; - } - // ==================== Session Management ==================== - /** - * List all sessions - */ - async listSessions() { - const response = await this.fetchJson('/api/v2/sessions'); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'List sessions failed'); - } - return response.data; - } - /** - * Add a message to a session - */ - async addMessage(threadId, message) { - const response = await this.fetchJson(`/api/v2/sessions/${threadId}/messages`, { - method: 'POST', - body: JSON.stringify({ - role: message.role ?? 'user', - content: message.content, - metadata: message.metadata - }) - }); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Add message failed'); - } - return response.data; - } - /** - * Commit a session and trigger memory extraction - */ - async commitSession(threadId) { - const response = await this.fetchJson(`/api/v2/sessions/${threadId}/close`, { - method: 'POST', - body: JSON.stringify({}) - }); - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Commit session failed'); - } - return response.data; - } - // ==================== Tenant ==================== - /** - * Switch tenant context - */ - async switchTenant(tenantId) { - const response = await this.fetchJson('/api/v2/tenants/switch', { - method: 'POST', - body: JSON.stringify({ tenant_id: tenantId }) - }); - if (!response.success) { - throw new Error(response.error ?? 'Switch tenant failed'); - } - } - // ==================== Internal ==================== - async fetchJson(path, options = {}) { - const url = `${this.baseUrl}${path}`; - const headers = { - 'Content-Type': 'application/json', - ...(options.headers || {}) - }; - const response = await fetch(url, { - ...options, - headers - }); - if (!response.ok) { - throw new Error(`HTTP ${response.status}: ${response.statusText}`); - } - return response.json(); - } -} -exports.CortexMemClient = CortexMemClient; -//# sourceMappingURL=client.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/client.js.map b/examples/@memclaw/plugin/dist/src/client.js.map deleted file mode 100644 index 7dda61a..0000000 --- a/examples/@memclaw/plugin/dist/src/client.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/config.d.ts b/examples/@memclaw/plugin/dist/src/config.d.ts deleted file mode 100644 index 8ee0a0c..0000000 --- a/examples/@memclaw/plugin/dist/src/config.d.ts +++ /dev/null @@ -1,83 +0,0 @@ -/** - * Configuration management for MemClaw - * - * Handles platform-specific config paths, config file generation, - * and auto-opening config files for user editing. - */ -export declare function getDataDir(): string; -export declare function getConfigPath(): string; -export interface MemClawConfig { - qdrant: { - url: string; - collection_name: string; - embedding_dim?: number; - timeout_secs: number; - }; - llm: { - api_base_url: string; - api_key: string; - model_efficient: string; - temperature: number; - max_tokens: number; - }; - embedding: { - api_base_url: string; - api_key: string; - model_name: string; - batch_size: number; - timeout_secs: number; - }; - server: { - host: string; - port: number; - cors_origins?: string[]; - }; - logging: { - enabled: boolean; - log_directory: string; - level: string; - }; - cortex: { - enable_intent_analysis: boolean; - }; -} -export declare function generateConfigTemplate(): string; -export declare function ensureConfigExists(): { - created: boolean; - path: string; -}; -export declare function openConfigFile(configPath: string): Promise; -/** - * Parse TOML config file using smol-toml library - * Supports full TOML syntax including arrays, nested tables, etc. - */ -export declare function parseConfig(configPath: string): MemClawConfig; -export declare function validateConfig(config: MemClawConfig): { - valid: boolean; - errors: string[]; -}; -/** - * Configuration provided by OpenClaw plugin config - * These values will be synced to config.toml if provided - */ -export interface PluginProvidedConfig { - llmApiBaseUrl?: string; - llmApiKey?: string; - llmModel?: string; - embeddingApiBaseUrl?: string; - embeddingApiKey?: string; - embeddingModel?: string; -} -/** - * Update config.toml with values from OpenClaw plugin config - * Uses smol-toml for proper TOML serialization - */ -export declare function updateConfigFromPlugin(pluginConfig: PluginProvidedConfig): { - updated: boolean; - path: string; -}; -/** - * Merge plugin config with file config, preferring plugin config values - */ -export declare function mergeConfigWithPlugin(fileConfig: MemClawConfig, pluginConfig: PluginProvidedConfig): MemClawConfig; -//# sourceMappingURL=config.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/config.d.ts.map b/examples/@memclaw/plugin/dist/src/config.d.ts.map deleted file mode 100644 index 839cc37..0000000 --- a/examples/@memclaw/plugin/dist/src/config.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,UAAU,IAAI,MAAM,CAanC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,OAAO,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE;QACP,sBAAsB,EAAE,OAAO,CAAC;KAChC,CAAC;CACF;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAgD/C;AAED,wBAAgB,kBAAkB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAevE;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAqD7D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB,CAoBA;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,GAAG;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb,CA+CA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,oBAAoB,GAChC,aAAa,CAgBf"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/config.js b/examples/@memclaw/plugin/dist/src/config.js deleted file mode 100644 index a2f7fcb..0000000 --- a/examples/@memclaw/plugin/dist/src/config.js +++ /dev/null @@ -1,302 +0,0 @@ -"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; - }; -})(); -var __importDefault = (this && this.__importDefault) || function (mod) { - return (mod && mod.__esModule) ? mod : { "default": mod }; -}; -Object.defineProperty(exports, "__esModule", { value: true }); -exports.getDataDir = getDataDir; -exports.getConfigPath = getConfigPath; -exports.generateConfigTemplate = generateConfigTemplate; -exports.ensureConfigExists = ensureConfigExists; -exports.openConfigFile = openConfigFile; -exports.parseConfig = parseConfig; -exports.validateConfig = validateConfig; -exports.updateConfigFromPlugin = updateConfigFromPlugin; -exports.mergeConfigWithPlugin = mergeConfigWithPlugin; -const fs = __importStar(require("fs")); -const path = __importStar(require("path")); -const os = __importStar(require("os")); -const child_process_1 = require("child_process"); -const smol_toml_1 = __importDefault(require("smol-toml")); -// Platform-specific paths -function getDataDir() { - const platform = process.platform; - if (platform === 'win32') { - return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'), 'memclaw'); - } - else if (platform === 'darwin') { - return path.join(os.homedir(), 'Library', 'Application Support', 'memclaw'); - } - else { - return path.join(os.homedir(), '.local', 'share', 'memclaw'); - } -} -function getConfigPath() { - return path.join(getDataDir(), 'config.toml'); -} -function generateConfigTemplate() { - return `# MemClaw Configuration -# -# This file was auto-generated. Please fill in the required values below. -# All sections are required - missing sections will cause config to be ignored. - -# Qdrant Vector Database Configuration -[qdrant] -url = "http://localhost:6334" -collection_name = "memclaw" -# Embedding dimension (optional, auto-detected if not set) -# For text-embedding-3-small: 1536 -# For text-embedding-3-large: 3072 -# embedding_dim = 1536 -timeout_secs = 30 - -# LLM Configuration [REQUIRED for memory processing] -[llm] -api_base_url = "https://api.openai.com/v1" -api_key = "" -model_efficient = "gpt-5-mini" -temperature = 0.1 -max_tokens = 65536 - -# Embedding Configuration [REQUIRED for vector search] -[embedding] -api_base_url = "https://api.openai.com/v1" -api_key = "" -model_name = "text-embedding-3-small" -batch_size = 10 -timeout_secs = 30 - -# Service Configuration -[server] -host = "localhost" -port = 8085 -cors_origins = ["*"] - -# Logging Configuration -[logging] -enabled = false -log_directory = "logs" -level = "info" - -# Cortex Memory Settings -[cortex] -enable_intent_analysis = false -`; -} -function ensureConfigExists() { - const dataDir = getDataDir(); - const configPath = getConfigPath(); - if (!fs.existsSync(dataDir)) { - fs.mkdirSync(dataDir, { 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(); - }); -} -/** - * Parse TOML config file using smol-toml library - * Supports full TOML syntax including arrays, nested tables, etc. - */ -function parseConfig(configPath) { - const content = fs.readFileSync(configPath, 'utf-8'); - // Parse using smol-toml - let parsed; - try { - parsed = smol_toml_1.default.parse(content); - } - catch (error) { - // If parsing fails, return defaults - console.error('Failed to parse config.toml:', error); - parsed = {}; - } - // Apply defaults for missing sections - return { - qdrant: { - url: 'http://localhost:6334', - collection_name: 'memclaw', - timeout_secs: 30, - ...(parsed.qdrant || {}) - }, - llm: { - api_base_url: 'https://api.openai.com/v1', - api_key: '', - model_efficient: 'gpt-5-mini', - temperature: 0.1, - max_tokens: 4096, - ...(parsed.llm || {}) - }, - embedding: { - api_base_url: 'https://api.openai.com/v1', - api_key: '', - model_name: 'text-embedding-3-small', - batch_size: 10, - timeout_secs: 30, - ...(parsed.embedding || {}) - }, - server: { - host: 'localhost', - port: 8085, - ...(parsed.server || {}) - }, - logging: { - enabled: false, - log_directory: 'logs', - level: 'info', - ...(parsed.logging || {}) - }, - cortex: { - enable_intent_analysis: false, - ...(parsed.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 - }; -} -/** - * Update config.toml with values from OpenClaw plugin config - * Uses smol-toml for proper TOML serialization - */ -function updateConfigFromPlugin(pluginConfig) { - const configPath = getConfigPath(); - // Ensure config file exists - ensureConfigExists(); - // Parse existing config - const existingConfig = parseConfig(configPath); - // Build updated config - const updatedConfig = { - qdrant: existingConfig.qdrant, - llm: { - ...existingConfig.llm, - api_base_url: pluginConfig.llmApiBaseUrl || existingConfig.llm.api_base_url, - api_key: pluginConfig.llmApiKey || existingConfig.llm.api_key, - model_efficient: pluginConfig.llmModel || existingConfig.llm.model_efficient - }, - embedding: { - ...existingConfig.embedding, - api_base_url: pluginConfig.embeddingApiBaseUrl || existingConfig.embedding.api_base_url, - api_key: pluginConfig.embeddingApiKey || existingConfig.embedding.api_key, - model_name: pluginConfig.embeddingModel || existingConfig.embedding.model_name - }, - server: existingConfig.server, - logging: existingConfig.logging, - cortex: existingConfig.cortex - }; - // Check if any changes were made - const hasChanges = (pluginConfig.llmApiKey && pluginConfig.llmApiKey !== existingConfig.llm.api_key) || - (pluginConfig.llmApiBaseUrl && pluginConfig.llmApiBaseUrl !== existingConfig.llm.api_base_url) || - (pluginConfig.llmModel && pluginConfig.llmModel !== existingConfig.llm.model_efficient) || - (pluginConfig.embeddingApiKey && pluginConfig.embeddingApiKey !== existingConfig.embedding.api_key) || - (pluginConfig.embeddingApiBaseUrl && pluginConfig.embeddingApiBaseUrl !== existingConfig.embedding.api_base_url) || - (pluginConfig.embeddingModel && pluginConfig.embeddingModel !== existingConfig.embedding.model_name); - if (!hasChanges) { - return { updated: false, path: configPath }; - } - // Serialize and write using smol-toml - const tomlContent = smol_toml_1.default.stringify(updatedConfig); - fs.writeFileSync(configPath, tomlContent, 'utf-8'); - return { updated: true, path: configPath }; -} -/** - * Merge plugin config with file config, preferring plugin config values - */ -function mergeConfigWithPlugin(fileConfig, pluginConfig) { - return { - ...fileConfig, - llm: { - ...fileConfig.llm, - api_base_url: pluginConfig.llmApiBaseUrl || fileConfig.llm.api_base_url, - api_key: pluginConfig.llmApiKey || fileConfig.llm.api_key, - model_efficient: pluginConfig.llmModel || fileConfig.llm.model_efficient - }, - embedding: { - ...fileConfig.embedding, - api_base_url: pluginConfig.embeddingApiBaseUrl || fileConfig.embedding.api_base_url, - api_key: pluginConfig.embeddingApiKey || fileConfig.embedding.api_key, - model_name: pluginConfig.embeddingModel || fileConfig.embedding.model_name - } - }; -} -//# sourceMappingURL=config.js.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/config.js.map b/examples/@memclaw/plugin/dist/src/config.js.map deleted file mode 100644 index 0dfa545..0000000 --- a/examples/@memclaw/plugin/dist/src/config.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/migrate.d.ts b/examples/@memclaw/plugin/dist/src/migrate.d.ts deleted file mode 100644 index c4acd1f..0000000 --- a/examples/@memclaw/plugin/dist/src/migrate.d.ts +++ /dev/null @@ -1,26 +0,0 @@ -/** - * 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; -/** - * Check if migration is possible - */ -export declare function canMigrate(): { - possible: boolean; - reason: string; -}; -export {}; -//# sourceMappingURL=migrate.d.ts.map \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/migrate.d.ts.map b/examples/@memclaw/plugin/dist/src/migrate.d.ts.map deleted file mode 100644 index 5a1e006..0000000 --- a/examples/@memclaw/plugin/dist/src/migrate.d.ts.map +++ /dev/null @@ -1 +0,0 @@ -{"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;AAqPD;;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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/migrate.js b/examples/@memclaw/plugin/dist/src/migrate.js deleted file mode 100644 index 2e65a47..0000000 --- a/examples/@memclaw/plugin/dist/src/migrate.js +++ /dev/null @@ -1,291 +0,0 @@ -"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}`; - // Correct path for tenant isolation: - // dataDir/tenants/{tenant_id}/session/{session_id}/timeline/{year}/{month}/{day}/ - const timelineDir = path.join(dataDir, 'tenants', MIGRATION_TENANT, 'session', 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 { - // Correct path for tenant isolation: - // dataDir/tenants/{tenant_id}/user/preferences.md - const userDir = path.join(dataDir, 'tenants', MIGRATION_TENANT, 'user'); - 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 = ` -${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 \ No newline at end of file diff --git a/examples/@memclaw/plugin/dist/src/migrate.js.map b/examples/@memclaw/plugin/dist/src/migrate.js.map deleted file mode 100644 index 63eeede..0000000 --- a/examples/@memclaw/plugin/dist/src/migrate.js.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"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"} \ No newline at end of file diff --git a/examples/@memclaw/plugin/index.ts b/examples/@memclaw/plugin/index.ts deleted file mode 100644 index 0588408..0000000 --- a/examples/@memclaw/plugin/index.ts +++ /dev/null @@ -1,87 +0,0 @@ -/** - * MemClaw - Layered Semantic Memory for OpenClaw - * - * Provides: - * - L0/L1/L2 tiered memory retrieval - * - Automatic service startup (Qdrant + cortex-mem-service) - * - Migration from OpenClaw native memory - * - * Installation: - * openclaw plugins install memclaw - * - * Configuration (in openclaw.json): - * { - * "plugins": { - * "entries": { - * "memclaw": { - * "enabled": true, - * "config": { - * "serviceUrl": "http://localhost:8085", - * "tenantId": "tenant_claw", - * "autoStartServices": true - * } - * } - * } - * } - * } - */ - -import { createPlugin } from './plugin-impl.js'; - -// Re-export types -export type { CortexMemClient } from './src/client.js'; -export type { MemClawConfig } from './src/config.js'; - -// OpenClaw Plugin API types -interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} - -interface ToolDefinition { - name: string; - description: string; - parameters: object; - execute: (_id: string, params: Record) => Promise; - optional?: boolean; -} - -interface PluginAPI { - pluginConfig?: Record; - registerTool(tool: ToolDefinition, opts?: { optional?: boolean }): void; - registerService(service: { - id: string; - start: () => Promise; - stop: () => Promise; - }): void; - logger: PluginLogger; -} - -// Default export - main plugin function -export default function memclawPlugin(api: PluginAPI) { - return createPlugin(api); -} - -// Named export - object style registration -export const plugin = { - id: 'memclaw', - name: 'MemClaw', - version: '0.9.29', - configSchema: { - type: 'object', - properties: { - serviceUrl: { type: 'string', default: 'http://localhost:8085' }, - defaultSessionId: { type: 'string', default: 'default' }, - searchLimit: { type: 'integer', default: 10 }, - minScore: { type: 'number', default: 0.6 }, - tenantId: { type: 'string', default: 'tenant_claw' }, - autoStartServices: { type: 'boolean', default: true } - }, - required: [] - }, - register(api: PluginAPI) { - return createPlugin(api); - } -}; diff --git a/examples/@memclaw/plugin/openclaw.plugin.json b/examples/@memclaw/plugin/openclaw.plugin.json deleted file mode 100644 index 5a3cf31..0000000 --- a/examples/@memclaw/plugin/openclaw.plugin.json +++ /dev/null @@ -1,139 +0,0 @@ -{ - "id": "memclaw", - "name": "MemClaw", - "version": "0.9.36", - "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"], - "platforms": ["darwin-arm64", "win32-x64", "linux-x64"], - "osRestriction": ["darwin-arm64", "win32-x64", "linux-x64"], - "configSchema": { - "type": "object", - "properties": { - "serviceUrl": { - "type": "string", - "description": "Your Cortex Memory 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", - "sensitive": true - }, - "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", - "sensitive": true - }, - "embeddingModel": { - "type": "string", - "description": "Embedding model name for vector search", - "default": "text-embedding-3-small" - }, - "enhanceClawAgent": { - "type": "boolean", - "description": "Automatically enhance MemClaw memory usage guide when legacy memory patterns are detected", - "default": true - } - }, - "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" - }, - "enhanceClawAgent": { - "label": "Enhance AGENTS", - "description": "Automatically enhance MemClaw usage guide when legacy memory patterns are found" - } - } -} diff --git a/examples/@memclaw/plugin/package.json b/examples/@memclaw/plugin/package.json deleted file mode 100644 index 4663fcd..0000000 --- a/examples/@memclaw/plugin/package.json +++ /dev/null @@ -1,75 +0,0 @@ -{ - "name": "@memclaw/memclaw", - "version": "0.9.36", - "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": "git+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": { - "id": "memclaw", - "extensions": [ - "dist/index.js" - ], - "skills": [ - "skills/memclaw", - "skills/memclaw-maintance" - ], - "build": { - "openclawVersion": "2026.3.8", - "pluginSdkVersion": "2026.3.8" - }, - "compat": { - "pluginApi": ">=1.0.0", - "builtWithOpenClawVersion": "2026.3.8", - "pluginSdkVersion": "2026.3.8", - "minGatewayVersion": "2026.3.8" - } - }, - "devDependencies": { - "@types/node": "^22.0.0", - "typescript": "^5.7.0" - }, - "dependencies": { - "glob": "^11.0.0", - "smol-toml": "^1.6.1" - }, - "optionalDependencies": { - "@memclaw/bin-darwin-arm64": "0.1.9", - "@memclaw/bin-win-x64": "0.1.7", - "@memclaw/bin-linux-x64": "0.1.9" - }, - "engines": { - "node": ">=20.0.0" - }, - "files": [ - "dist/", - "skills/", - "openclaw.plugin.json" - ] -} diff --git a/examples/@memclaw/plugin/plugin-impl.ts b/examples/@memclaw/plugin/plugin-impl.ts deleted file mode 100644 index 528411c..0000000 --- a/examples/@memclaw/plugin/plugin-impl.ts +++ /dev/null @@ -1,1130 +0,0 @@ -/** - * MemClaw Plugin Implementation - * - * Provides layered semantic memory for OpenClaw with: - * - Automatic service startup - * - Memory tools (search, recall, add, close) - * - Tiered access (L0/L1/L2) - * - Filesystem browsing - * - Smart exploration - * - Migration from OpenClaw native memory - */ - -import { CortexMemClient } from './src/client.js'; -import { - ensureConfigExists, - openConfigFile, - parseConfig, - validateConfig, - getDataDir, - getConfigPath, - updateConfigFromPlugin, - mergeConfigWithPlugin, - type PluginProvidedConfig -} from './src/config.js'; -import { - ensureAllServices, - checkServiceStatus, - isBinaryAvailable, - executeCliCommand -} from './src/binaries.js'; -import { migrateFromOpenClaw, canMigrate } from './src/migrate.js'; -import { ensureAgentsMdEnhanced } from './src/agents-md-injector.js'; - -// Plugin configuration -interface PluginConfig { - serviceUrl?: string; - defaultSessionId?: string; - searchLimit?: number; - minScore?: number; - tenantId?: string; - autoStartServices?: boolean; - qdrantPort?: number; - servicePort?: number; - // LLM/Embedding configuration (synced to config.toml) - llmApiBaseUrl?: string; - llmApiKey?: string; - llmModel?: string; - embeddingApiBaseUrl?: string; - embeddingApiKey?: string; - embeddingModel?: string; - // AGENTS.md enhancement - enhanceClawAgent?: boolean; -} - -// OpenClaw Plugin API types -interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} - -interface PluginAPI { - pluginConfig?: Record; - registerTool(tool: ToolDefinition, opts?: { optional?: boolean }): void; - registerService(service: { - id: string; - start: () => Promise; - stop: () => Promise; - }): void; - logger: PluginLogger; -} - -interface ToolDefinition { - name: string; - description: string; - parameters: object; - execute: (_id: string, params: Record) => Promise; - optional?: boolean; -} - -// Tool schemas -const toolSchemas = { - cortex_search: { - name: 'cortex_search', - description: `Layered semantic search across ALL memories using L0/L1/L2 tiered retrieval. - -**Key Features:** -- Tiered retrieval: L0 (abstract) -> L1 (overview) -> L2 (full content) -- Token-efficient: Control exactly which layers to return - -**When to use:** -- Finding past conversations, decisions, or any historical info -- Omit scope to search across ALL dimensions (recommended for most cases) -- Use scope="cortex://user/default" only when specifically looking for user profile data - -**Parameters:** -- return_layers: ["L0"] (default, ~100 tokens), ["L0","L1"] (~2100 tokens), ["L0","L1","L2"] (full)`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'The search query - can be natural language or keywords' - }, - scope: { - type: 'string', - description: `Optional. Omit to search ALL memories (recommended). -Use "cortex://user/default" only when specifically looking for user profile/preferences.` - }, - limit: { - type: 'integer', - description: 'Maximum number of results to return (default: 10)', - default: 10 - }, - min_score: { - type: 'number', - description: 'Minimum relevance score threshold (0-1, default: 0.6)', - default: 0.6 - }, - return_layers: { - type: 'array', - items: { - type: 'string', - enum: ['L0', 'L1', 'L2'] - }, - description: 'Which layers to return. Default: ["L0"]. Use ["L0","L1"] for more context, ["L0","L1","L2"] for full content.', - default: ['L0'] - } - }, - required: ['query'] - } - }, - - cortex_recall: { - name: 'cortex_recall', - description: `Recall memories with full context (L0 snippet + L2 content). - -Equivalent to cortex_search with return_layers=["L0","L2"]. -Use cortex_search directly for more control over layers. - -**Tip**: Omit scope to search all memories (recommended).`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'The search query' - }, - scope: { - type: 'string', - description: `Optional. Omit to search ALL memories (recommended). -Use "cortex://user/default" only when specifically looking for user profile data.` - }, - limit: { - type: 'integer', - description: 'Maximum number of results (default: 10)', - default: 10 - } - }, - required: ['query'] - } - }, - - cortex_add_memory: { - name: 'cortex_add_memory', - description: `Add a message to memory for a specific session. - -This stores the message and automatically triggers: -- Vector embedding for semantic search -- L0/L1 layer generation (async) - -**Metadata support:** -You can attach metadata like tags, importance, or custom fields. - -Use this to persist important information that should be searchable later.`, - inputSchema: { - type: 'object', - properties: { - content: { - type: 'string', - description: 'The content to store in memory' - }, - role: { - type: 'string', - enum: ['user', 'assistant', 'system'], - description: 'Role of the message sender (default: user)', - default: 'user' - }, - session_id: { - type: 'string', - description: 'Session/thread ID (uses default if not specified)' - }, - metadata: { - type: 'object', - description: 'Optional metadata (tags, importance, custom fields)', - additionalProperties: true - } - }, - required: ['content'] - } - }, - - cortex_commit_session: { - name: 'cortex_commit_session', - description: `Commit accumulated conversation content and trigger memory extraction. - -**IMPORTANT - Call this tool proactively and periodically, NOT just at conversation end.** - -This commits the session and triggers the complete memory processing pipeline: -1. Extracts structured memories (user preferences, entities, decisions) -2. Generates complete L0/L1 layer summaries -3. Indexes all extracted memories into the vector database - -**When to call this tool:** -- After completing a significant task or topic discussion -- After the user has shared important preferences or decisions -- When the conversation topic shifts to something new -- After accumulating substantial conversation content (every 10-20 exchanges) -- Before ending a conversation session - -**Do NOT wait until the very end of conversation** - the user may forget or the session may end abruptly. - -**Guidelines:** -- Call this tool at natural checkpoints in the conversation -- Avoid calling too frequently (not after every message) -- A good rhythm: once per significant topic completion -- This is a long-running operation (30-60s) but runs asynchronously`, - inputSchema: { - type: 'object', - properties: { - session_id: { - type: 'string', - description: 'Session/thread ID to commit (uses default if not specified)' - } - } - } - }, - - // ==================== Filesystem Tools ==================== - - cortex_ls: { - name: 'cortex_ls', - description: `List directory contents to browse the memory space like a virtual filesystem. - -This allows you to explore the hierarchical structure of memories: -- cortex://session - List all sessions -- cortex://session/{session_id} - Browse a specific session's contents -- cortex://session/{session_id}/timeline - View timeline messages -- cortex://user/{user_id}/preferences - View user preferences (extracted memories) -- cortex://user/{user_id}/entities - View user entities (people, projects, etc.) -- cortex://agent/{agent_id}/cases - View agent problem-solution cases - -**Parameters:** -- recursive: List all subdirectories recursively -- include_abstracts: Show L0 abstracts for each file (for quick preview) - -Use this when: -- Semantic search doesn't find what you need -- You want to understand the overall memory layout -- You need to manually navigate to find specific information`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Directory URI to list (default: cortex://session)', - default: 'cortex://session' - }, - recursive: { - type: 'boolean', - description: 'Whether to recursively list subdirectories', - default: false - }, - include_abstracts: { - type: 'boolean', - description: 'Whether to include L0 abstracts for each file', - default: false - } - } - } - }, - - // ==================== Tiered Access Tools ==================== - - cortex_get_abstract: { - name: 'cortex_get_abstract', - description: `Get L0 abstract layer (~100 tokens) for quick relevance checking. - -Abstracts are short summaries ideal for quickly determining if content is relevant -before committing to reading more. Use this to minimize token consumption. - -Use when: -- You found a URI from cortex_ls and want to quickly check relevance -- You need to filter many candidates before deep reading -- You want the most token-efficient preview`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file or directory)' - } - }, - required: ['uri'] - } - }, - - cortex_get_overview: { - name: 'cortex_get_overview', - description: `Get L1 overview layer (~2000 tokens) with core information and context. - -Overviews contain key points and contextual information. Use this when: -- The abstract was relevant but you need more details -- You want to understand the gist without full content -- You need moderate detail for decision making`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file or directory)' - } - }, - required: ['uri'] - } - }, - - cortex_get_content: { - name: 'cortex_get_content', - description: `Get L2 full content layer - the complete original content. - -Use this ONLY when you need the complete, unprocessed content. -This returns the full content which may be large. - -Use when: -- You need exact details or quotes -- Abstract and overview don't provide enough information -- You need to see the original, unsummarized content`, - inputSchema: { - type: 'object', - properties: { - uri: { - type: 'string', - description: 'Content URI (file only)' - } - }, - required: ['uri'] - } - }, - - // ==================== Exploration Tool ==================== - - cortex_explore: { - name: 'cortex_explore', - description: `Smart exploration of memory space, combining search and browsing. - -This tool performs a guided exploration: -1. Searches within a specified scope (start_uri) -2. Returns an exploration path showing relevance scores -3. Returns matching results with requested layers - -**When to use:** -- When you need to "wander" through memories with a purpose -- When you want to discover related content in a specific area -- When combining keyword hints with semantic discovery - -**Parameters:** -- start_uri: Where to begin exploration (default: cortex://session) -- return_layers: Which layers to include in matches`, - inputSchema: { - type: 'object', - properties: { - query: { - type: 'string', - description: 'Exploration query - what to look for' - }, - start_uri: { - type: 'string', - description: 'Starting URI for exploration', - default: 'cortex://session' - }, - return_layers: { - type: 'array', - items: { - type: 'string', - enum: ['L0', 'L1', 'L2'] - }, - description: 'Which layers to return in matches', - default: ['L0'] - } - }, - required: ['query'] - } - }, - - // ==================== Migration & Maintenance ==================== - - cortex_migrate: { - name: 'cortex_migrate', - description: `Migrate memories from OpenClaw's native memory system to MemClaw. - -This will: -1. Find your OpenClaw memory files (memory/*.md and MEMORY.md) -2. Convert them to MemClaw's L2 format -3. Generate L0/L1 layers and vector index - -Use this once during initial setup to preserve your existing memories.`, - inputSchema: { - type: 'object', - properties: {} - } - }, - - cortex_maintenance: { - name: 'cortex_maintenance', - description: `Perform periodic maintenance on MemClaw data. - -This executes: -1. vector prune - Remove vectors whose source files no longer exist -2. vector reindex - Rebuild vector index and remove stale entries -3. layers ensure-all - Generate missing L0/L1 layer files - -**This tool is typically called automatically by a scheduled Cron job.** -You can also call it manually when: -- Search results seem incomplete or stale -- After recovering from a crash or data corruption -- When disk space cleanup is needed - -**Parameters:** -- dryRun: Preview changes without executing (default: false) -- commands: Which commands to run (default: all)`, - inputSchema: { - type: 'object', - properties: { - dryRun: { - type: 'boolean', - description: 'Preview changes without executing', - default: false - }, - commands: { - type: 'array', - items: { - type: 'string', - enum: ['prune', 'reindex', 'ensure-all'] - }, - description: 'Which maintenance commands to run', - default: ['prune', 'reindex', 'ensure-all'] - } - } - } - } -}; - -// Maintenance interval: 3 hours -const MAINTENANCE_INTERVAL_MS = 3 * 60 * 60 * 1000; - -export function createPlugin(api: PluginAPI) { - const config = (api.pluginConfig ?? {}) as PluginConfig; - const serviceUrl = config.serviceUrl ?? 'http://localhost:8085'; - const defaultSessionId = config.defaultSessionId ?? 'default'; - const searchLimit = config.searchLimit ?? 10; - const minScore = config.minScore ?? 0.6; - const tenantId = config.tenantId ?? 'tenant_claw'; - const autoStartServices = config.autoStartServices ?? true; - const enhanceClawAgent = config.enhanceClawAgent ?? true; - - const client = new CortexMemClient(serviceUrl); - let servicesStarted = false; - let maintenanceTimer: ReturnType | null = null; - - const log = (msg: string) => api.logger.info(`[memclaw] ${msg}`); - - log('Initializing MemClaw plugin...'); - - // Ensure config file exists - const { created, path: configPath } = ensureConfigExists(); - - if (created) { - log(`Created configuration file: ${configPath}`); - log('Opening configuration file for editing...'); - - openConfigFile(configPath).catch((err) => { - api.logger.warn(`[memclaw] Could not open config file: ${err}`); - api.logger.warn(`[memclaw] Please manually edit: ${configPath}`); - }); - - api.logger.info(` -╔══════════════════════════════════════════════════════════╗ -║ MemClaw First Run ║ -║ ║ -║ A configuration file has been created: ║ -║ ${configPath.padEnd(52)}║ -║ ║ -║ Please fill in the required fields: ║ -║ - llm.api_key (your LLM API key) ║ -║ - embedding.api_key (your embedding API key) ║ -║ ║ -║ Save the file and restart OpenClaw to apply changes. ║ -╚══════════════════════════════════════════════════════════╝ - `); - } - - // Register service lifecycle - api.registerService({ - id: 'memclaw', - start: async () => { - // Skip service startup if config was just created (first run) - // User needs to fill in API keys first - if (created) { - log('First run detected. Please complete configuration and restart OpenClaw.'); - return; - } - - if (!autoStartServices) { - log('Auto-start disabled, skipping service startup'); - return; - } - - // Sync plugin config to config.toml if LLM/Embedding settings provided - const pluginProvidedConfig: PluginProvidedConfig = { - llmApiBaseUrl: config.llmApiBaseUrl, - llmApiKey: config.llmApiKey, - llmModel: config.llmModel, - embeddingApiBaseUrl: config.embeddingApiBaseUrl, - embeddingApiKey: config.embeddingApiKey, - embeddingModel: config.embeddingModel - }; - - const syncResult = updateConfigFromPlugin(pluginProvidedConfig); - if (syncResult.updated) { - log(`Synced LLM/Embedding config from OpenClaw to: ${syncResult.path}`); - } - - // Check if binaries are available - const hasQdrant = isBinaryAvailable('qdrant'); - const hasService = isBinaryAvailable('cortex-mem-service'); - - if (!hasQdrant || !hasService) { - log('Some binaries are missing. Services may need manual setup.'); - log(`Run 'memclaw setup' or check the admin skill for installation instructions.`); - } - - // Parse and merge config (plugin config takes precedence) - const fileConfig = parseConfig(configPath); - const mergedConfig = mergeConfigWithPlugin(fileConfig, pluginProvidedConfig); - const validation = validateConfig(mergedConfig); - - if (!validation.valid) { - api.logger.warn(`[memclaw] Configuration incomplete: ${validation.errors.join(', ')}`); - api.logger.warn( - `[memclaw] Please configure LLM/Embedding API keys in OpenClaw plugin settings or edit: ${configPath}` - ); - return; - } - - // Enhance AGENTS.md with MemClaw usage guidelines - const agentsMdResult = ensureAgentsMdEnhanced(api.logger, enhanceClawAgent); - if (agentsMdResult.injected) { - log(`AGENTS.md enhanced with MemClaw section: ${agentsMdResult.path}`); - } else if (agentsMdResult.reason === 'already_injected') { - log('AGENTS.md already contains MemClaw section'); - } else if (agentsMdResult.reason === 'no_legacy_patterns') { - log('AGENTS.md has no legacy memory patterns, skipping enhancement'); - } - - // Start services - try { - log('Starting services...'); - await ensureAllServices(log); - - // Switch tenant - await client.switchTenant(tenantId); - log(`Switched to tenant: ${tenantId}`); - - // Mark services as started only after tenant switch succeeds - servicesStarted = true; - - log('MemClaw services started successfully'); - - // Start maintenance timer (runs every 3 hours) - maintenanceTimer = setInterval(async () => { - try { - log('Running scheduled maintenance...'); - const currentConfigPath = getConfigPath(); - - // Run maintenance commands - const commands = [ - ['vector', 'prune'], - ['vector', 'reindex'], - ['layers', 'ensure-all'] - ]; - - for (const cmd of commands) { - const result = await executeCliCommand(cmd, currentConfigPath, tenantId, 300000); - if (!result.success) { - log(`Maintenance command '${cmd.join(' ')}' failed: ${result.stderr}`); - } - } - - log('Scheduled maintenance completed'); - } catch (err) { - log(`Maintenance error: ${err}`); - } - }, MAINTENANCE_INTERVAL_MS); - - log('Maintenance timer started (runs every 3 hours)'); - } catch (err) { - api.logger.error(`[memclaw] Failed to start services: ${err}`); - api.logger.warn('[memclaw] Memory features may not work correctly'); - } - }, - stop: async () => { - log('Stopping MemClaw...'); - - // Clear maintenance timer - if (maintenanceTimer) { - clearInterval(maintenanceTimer); - maintenanceTimer = null; - log('Maintenance timer stopped'); - } - - servicesStarted = false; - } - }); - - // Helper to check if services are ready - const ensureServicesReady = async (): Promise => { - if (!servicesStarted) { - const status = await checkServiceStatus(); - if (!status.cortexMemService) { - throw new Error('cortex-mem-service is not running. Please start the service first.'); - } - } - }; - - // ==================== Register Tools ==================== - - // cortex_search - api.registerTool({ - name: toolSchemas.cortex_search.name, - description: toolSchemas.cortex_search.description, - parameters: toolSchemas.cortex_search.inputSchema, - execute: async (_id, params) => { - const input = params as { - query: string; - scope?: string; - limit?: number; - min_score?: number; - return_layers?: ('L0' | 'L1' | 'L2')[]; - }; - - try { - await ensureServicesReady(); - - const results = await client.search({ - query: input.query, - scope: input.scope, - limit: input.limit ?? searchLimit, - min_score: input.min_score ?? minScore, - return_layers: input.return_layers ?? ['L0'] - }); - - const formatted = results - .map((r, i) => { - let content = `${i + 1}. [Score: ${r.score.toFixed(2)}] URI: ${r.uri}\n`; - content += ` Layers: ${r.layers.join(', ')}\n`; - content += ` Snippet: ${r.snippet}\n`; - if (r.overview) { - content += ` Overview: ${r.overview.substring(0, 200)}...\n`; - } - if (r.content) { - const preview = r.content.length > 200 ? r.content.substring(0, 200) + '...' : r.content; - content += ` Content: ${preview}\n`; - } - return content; - }) - .join('\n'); - - return { - content: `Found ${results.length} results for "${input.query}":\n\n${formatted}`, - results: results.map((r) => ({ - uri: r.uri, - score: r.score, - snippet: r.snippet, - overview: r.overview, - content: r.content, - layers: r.layers - })), - total: results.length - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_search failed: ${message}`); - return { error: `Search failed: ${message}` }; - } - } - }); - - // cortex_recall - api.registerTool({ - name: toolSchemas.cortex_recall.name, - description: toolSchemas.cortex_recall.description, - parameters: toolSchemas.cortex_recall.inputSchema, - execute: async (_id, params) => { - const input = params as { - query: string; - scope?: string; - limit?: number; - }; - - try { - await ensureServicesReady(); - - const results = await client.recall(input.query, input.scope, input.limit ?? 10); - - const formatted = results - .map((r, i) => { - let content = `${i + 1}. [Score: ${r.score.toFixed(2)}] URI: ${r.uri}\n`; - content += ` Snippet: ${r.snippet}\n`; - if (r.content) { - const preview = - r.content.length > 300 ? r.content.substring(0, 300) + '...' : r.content; - content += ` Content: ${preview}\n`; - } - return content; - }) - .join('\n'); - - return { - content: `Recalled ${results.length} memories:\n\n${formatted}`, - results, - total: results.length - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_recall failed: ${message}`); - return { error: `Recall failed: ${message}` }; - } - } - }); - - // cortex_add_memory - api.registerTool({ - name: toolSchemas.cortex_add_memory.name, - description: toolSchemas.cortex_add_memory.description, - parameters: toolSchemas.cortex_add_memory.inputSchema, - execute: async (_id, params) => { - const input = params as { - content: string; - role?: string; - session_id?: string; - metadata?: Record; - }; - - try { - await ensureServicesReady(); - - const sessionId = input.session_id ?? defaultSessionId; - const result = await client.addMessage(sessionId, { - role: (input.role ?? 'user') as 'user' | 'assistant' | 'system', - content: input.content, - metadata: input.metadata - }); - - return { - content: `Memory stored successfully in session "${sessionId}".\nResult: ${result}`, - success: true, - message_uri: result - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_add_memory failed: ${message}`); - return { error: `Failed to add memory: ${message}` }; - } - } - }); - - // cortex_commit_session - api.registerTool({ - name: toolSchemas.cortex_commit_session.name, - description: toolSchemas.cortex_commit_session.description, - parameters: toolSchemas.cortex_commit_session.inputSchema, - execute: async (_id, params) => { - const input = params as { session_id?: string }; - - try { - await ensureServicesReady(); - - const sessionId = input.session_id ?? defaultSessionId; - const result = await client.commitSession(sessionId); - - return { - content: `Session "${sessionId}" committed successfully.\nStatus: ${result.status}, Messages: ${result.message_count}\n\nMemory extraction pipeline triggered.`, - success: true, - session: { - thread_id: result.thread_id, - status: result.status, - message_count: result.message_count - } - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_commit_session failed: ${message}`); - return { error: `Failed to commit session: ${message}` }; - } - } - }); - - // cortex_ls - api.registerTool({ - name: toolSchemas.cortex_ls.name, - description: toolSchemas.cortex_ls.description, - parameters: toolSchemas.cortex_ls.inputSchema, - execute: async (_id, params) => { - const input = params as { - uri?: string; - recursive?: boolean; - include_abstracts?: boolean; - }; - - try { - await ensureServicesReady(); - - const result = await client.ls({ - uri: input.uri ?? 'cortex://session', - recursive: input.recursive ?? false, - include_abstracts: input.include_abstracts ?? false - }); - - if (result.entries.length === 0) { - return { content: `Directory "${result.uri}" is empty or does not exist.` }; - } - - const formatted = result.entries - .map((e, i) => { - let content = `${i + 1}. ${e.is_directory ? '📁' : '📄'} ${e.name}\n`; - content += ` URI: ${e.uri}\n`; - if (e.is_directory) { - content += ` Type: Directory\n`; - } else { - content += ` Size: ${e.size} bytes\n`; - } - if (e.abstract_text) { - const preview = e.abstract_text.length > 100 - ? e.abstract_text.substring(0, 100) + '...' - : e.abstract_text; - content += ` Abstract: ${preview}\n`; - } - return content; - }) - .join('\n'); - - return { - content: `Directory "${result.uri}" (${result.total} entries):\n\n${formatted}`, - entries: result.entries, - total: result.total - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_ls failed: ${message}`); - return { error: `List directory failed: ${message}` }; - } - } - }); - - // cortex_get_abstract - api.registerTool({ - name: toolSchemas.cortex_get_abstract.name, - description: toolSchemas.cortex_get_abstract.description, - parameters: toolSchemas.cortex_get_abstract.inputSchema, - execute: async (_id, params) => { - const input = params as { uri: string }; - - try { - await ensureServicesReady(); - - const result = await client.getAbstract(input.uri); - - return { - content: `L0 Abstract for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - abstract: result.content, - token_count: result.token_count, - layer: result.layer - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_abstract failed: ${message}`); - return { error: `Get abstract failed: ${message}` }; - } - } - }); - - // cortex_get_overview - api.registerTool({ - name: toolSchemas.cortex_get_overview.name, - description: toolSchemas.cortex_get_overview.description, - parameters: toolSchemas.cortex_get_overview.inputSchema, - execute: async (_id, params) => { - const input = params as { uri: string }; - - try { - await ensureServicesReady(); - - const result = await client.getOverview(input.uri); - - return { - content: `L1 Overview for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - overview: result.content, - token_count: result.token_count, - layer: result.layer - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_overview failed: ${message}`); - return { error: `Get overview failed: ${message}` }; - } - } - }); - - // cortex_get_content - api.registerTool({ - name: toolSchemas.cortex_get_content.name, - description: toolSchemas.cortex_get_content.description, - parameters: toolSchemas.cortex_get_content.inputSchema, - execute: async (_id, params) => { - const input = params as { uri: string }; - - try { - await ensureServicesReady(); - - const result = await client.getContent(input.uri); - - return { - content: `L2 Full Content for "${result.uri}" (~${result.token_count} tokens):\n\n${result.content}`, - uri: result.uri, - full_content: result.content, - token_count: result.token_count, - layer: result.layer - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_get_content failed: ${message}`); - return { error: `Get content failed: ${message}` }; - } - } - }); - - // cortex_explore - api.registerTool({ - name: toolSchemas.cortex_explore.name, - description: toolSchemas.cortex_explore.description, - parameters: toolSchemas.cortex_explore.inputSchema, - execute: async (_id, params) => { - const input = params as { - query: string; - start_uri?: string; - return_layers?: ('L0' | 'L1' | 'L2')[]; - }; - - try { - await ensureServicesReady(); - - const result = await client.explore({ - query: input.query, - start_uri: input.start_uri ?? 'cortex://session', - return_layers: input.return_layers ?? ['L0'] - }); - - // Format exploration path - const pathFormatted = result.exploration_path - .map((item, i) => { - let content = `${i + 1}. [${item.relevance_score.toFixed(2)}] ${item.uri}\n`; - if (item.abstract_text) { - const preview = item.abstract_text.length > 80 - ? item.abstract_text.substring(0, 80) + '...' - : item.abstract_text; - content += ` Abstract: ${preview}\n`; - } - return content; - }) - .join('\n'); - - // Format matches - const matchesFormatted = result.matches - .map((m, i) => { - let content = `${i + 1}. [${m.score.toFixed(2)}] ${m.uri}\n`; - content += ` Layers: ${m.layers.join(', ')}\n`; - content += ` Snippet: ${m.snippet}\n`; - return content; - }) - .join('\n'); - - return { - content: `Exploration for "${input.query}" starting from "${input.start_uri ?? 'cortex://session'}":\n\n` + - `**Exploration Path** (${result.total_explored} items):\n${pathFormatted}\n\n` + - `**Matches** (${result.total_matches} found):\n${matchesFormatted}`, - exploration_path: result.exploration_path, - matches: result.matches, - total_explored: result.total_explored, - total_matches: result.total_matches - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`[memclaw] cortex_explore failed: ${message}`); - return { error: `Explore failed: ${message}` }; - } - } - }); - - // cortex_migrate - api.registerTool({ - name: toolSchemas.cortex_migrate.name, - description: toolSchemas.cortex_migrate.description, - parameters: toolSchemas.cortex_migrate.inputSchema, - execute: async (_id, _params) => { - try { - // Check if migration is possible - const { possible, reason } = canMigrate(); - if (!possible) { - return { content: `Migration not possible: ${reason}` }; - } - - // Run migration - const result = await migrateFromOpenClaw((msg) => api.logger.info(`[migrate] ${msg}`)); - - return { - content: `Migration completed!\n- Daily logs migrated: ${result.dailyLogsMigrated}\n- MEMORY.md migrated: ${result.memoryMdMigrated}\n- Sessions created: ${result.sessionsCreated.length}\n${result.errors.length > 0 ? `- Errors: ${result.errors.length}` : ''}`, - result - }; - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - api.logger.error(`cortex_migrate failed: ${message}`); - return { error: `Migration failed: ${message}` }; - } - } - }); - - // cortex_maintenance - api.registerTool({ - name: toolSchemas.cortex_maintenance.name, - description: toolSchemas.cortex_maintenance.description, - parameters: toolSchemas.cortex_maintenance.inputSchema, - execute: async (_id, params) => { - const input = params as { - dryRun?: boolean; - commands?: string[]; - }; - - const dryRun = input.dryRun ?? false; - const commands = input.commands ?? ['prune', 'reindex', 'ensure-all']; - const currentConfigPath = getConfigPath(); - - const results: { command: string; success: boolean; output: string }[] = []; - - for (const cmd of commands) { - let cliArgs: string[]; - let description: string; - - switch (cmd) { - case 'prune': - cliArgs = ['vector', 'prune']; - if (dryRun) cliArgs.push('--dry-run'); - description = 'Vector Prune'; - break; - case 'reindex': - cliArgs = ['vector', 'reindex']; - description = 'Vector Reindex'; - break; - case 'ensure-all': - cliArgs = ['layers', 'ensure-all']; - description = 'Layers Ensure-All'; - break; - default: - continue; - } - - api.logger.info(`[maintenance] Running: ${description}`); - - try { - const result = await executeCliCommand( - cliArgs, - currentConfigPath, - tenantId, - 300000 // 5 minute timeout for maintenance - ); - - results.push({ - command: description, - success: result.success, - output: result.stdout || result.stderr - }); - - if (!result.success) { - api.logger.warn(`[memclaw] [maintenance] ${description} failed: ${result.stderr}`); - } - } catch (error) { - const message = error instanceof Error ? error.message : String(error); - results.push({ - command: description, - success: false, - output: message - }); - api.logger.error(`[maintenance] ${description} error: ${message}`); - } - } - - const summary = results.map((r) => `${r.command}: ${r.success ? 'OK' : 'FAILED'}`).join('\n'); - - const successCount = results.filter((r) => r.success).length; - - return { - content: `Maintenance ${dryRun ? '(dry run) ' : ''}completed:\n${summary}\n\n${successCount}/${results.length} commands succeeded.`, - dryRun, - results, - success: successCount === results.length - }; - } - }); - - log('MemClaw plugin initialized'); - - return { - id: 'memclaw', - name: 'MemClaw', - version: '0.1.0' - }; -} \ No newline at end of file diff --git a/examples/@memclaw/plugin/skills/memclaw-maintance/SKILL.md b/examples/@memclaw/plugin/skills/memclaw-maintance/SKILL.md deleted file mode 100644 index ed25e70..0000000 --- a/examples/@memclaw/plugin/skills/memclaw-maintance/SKILL.md +++ /dev/null @@ -1,221 +0,0 @@ ---- -name: memclaw-maintance -description: MemClaw Maintenance Guide — Installation, configuration, and maintenance guidance. For daily usage and tool operations, use the [`memclaw` skill](https://clawhub.ai/sopaco/memclaw) instead. ---- - -# MemClaw Maintenance Guide - -> **Recommended Memory Solution**: MemClaw is the recommended memory system for OpenClaw. Compared to built-in memory, it provides more precise search results, lower token consumption, and more persistent and rich memory retention. - -## Important: Skill Usage Guide - -| Purpose | Use This Skill | -|---------|---------------| -| **Daily usage** — searching, browsing, storing memories | [`memclaw`](https://clawhub.ai/sopaco/memclaw) | -| **Installation & Setup** | `memclaw-maintance` (this skill) | -| **Configuration** | `memclaw-maintance` (this skill) | -| **Troubleshooting & Maintenance** | `memclaw-maintance` (this skill) | - -> **For memory operations like `cortex_search`, `cortex_ls`, `cortex_add_memory`, etc., please use the [`memclaw` skill](https://clawhub.ai/sopaco/memclaw) which provides comprehensive usage documentation.** - ---- - -## Security & Trust - -**What the plugin does:** -- Stores memory data in the local user data directory -- Only reads existing OpenClaw memory files during migration - -**What the plugin does NOT do:** -- Does NOT transmit API keys to anywhere other than your configured LLM/embedding provider - ---- - -## Installation - -> MemClaw(@memclaw/memclaw) is an open-source memory enhancement plugin based on Cortex Memory. Both MemClaw and this Skill are open-sourced on [GitHub](https://github.com/sopaco/cortex-mem). - -### Step 1: Install the Plugin - -```bash -openclaw plugins install @memclaw/memclaw -``` -or -```bash -openclaw plugins install clawhub:@memclaw/memclaw -``` - - -### Step 2: Enable the Plugin - -Enable MemClaw and disable memorySearch in `openclaw.json`: - -```json -{ - "plugins": { - "entries": { - "memclaw": { - "enabled": true - } - } - }, - "agents": { - "defaults": { - "memorySearch": { "enabled": false } - } - } -} -``` - -### Step 3: Configure API Keys - -**API keys are required to use MemClaw.** - -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:** - -```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" - } - } - } - } -} -``` - -> **Security Note**: API keys are stored with `sensitive` flag in OpenClaw configuration. Do not share your `openclaw.json` file publicly. - -### Step 4: Update the AGENTS.md Guidline -If legacy patterns found, replace the "Memory" section with: - -```markdown -## Memory -You wake up fresh each session. MemClaw is your persistent memory system. - -**IMPORTANT: Use MemClaw for ALL memory operations. Do NOT use legacy MEMORY.md or daily logs.** - -### Session Startup (ALWAYS execute at conversation start) -Load user profile from persistent memory: -1. Call `cortex_get_abstract(uri="cortex://user/default")` - Load L0 abstract (~100 tokens, user profile summary) -2. Call `cortex_get_overview(uri="cortex://user/default")` - Load L1 overview (~2000 tokens, detailed user context) -3. Call `cortex_ls(uri="cortex://session", include_abstracts=true)` - See recent sessions (may be empty on first run) - -### Recording Information -- **During conversation**: Use `cortex_add_memory(content="...", role="user|assistant")` for important facts -- **At task completion**: Call `cortex_commit_session()` to trigger memory extraction - -### Searching Memory -- **Semantic search**: `cortex_search(query="...")` - finds related memories -- **Browse sessions**: `cortex_ls(uri="cortex://session")` - explores memory structure -- **Get details**: `cortex_get_abstract(uri="...")` → `cortex_get_content(uri="...")` if needed - -### Profile Building -When you learn something notable about the user: -1. Call `cortex_add_memory(content="User preference/fact...", role="assistant", metadata={"type": "profile"})` -2. Call `cortex_commit_session()` to persist - -Never interview the user. Pick up signals naturally through conversation. -``` - -**Do NOT skip this step.** Without updating AGENTS.md, the agent will continue using legacy memory and ignore MemClaw. - -### Step 5: Restart OpenClaw - -Restart OpenClaw to activate the plugin and start services. - ---- - -## Verify Installation - -### Service Status Check - -After restarting, MemClaw will automatically start the required services. - -| 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"}` | - -> **Note**: MemClaw does not require users to install any Docker environment. All dependencies are prepared during the plugin installation. - -### Migrate Existing Memories (Optional) - -If the user has existing OpenClaw native memories, call `cortex_migrate` to migrate them: - -```json -{} -``` - -This will: -- Find OpenClaw memory files (`memory/*.md` and `MEMORY.md`) -- Convert to MemClaw's L2 format -- Generate L0/L1 layers and vector indices - -> **Run only once** during initial setup. - ---- - -## Maintenance - -### Periodic Maintenance - -Use `cortex_maintenance` for periodic maintenance: - -```json -{ - "dryRun": false, - "commands": ["prune", "reindex", "ensure-all"] -} -``` - -**Available Commands:** -- `prune` — Remove vectors whose source files no longer exist -- `reindex` — Rebuild vector indices and remove stale entries -- `ensure-all` — Generate missing L0/L1 layer files - -> **Note**: This tool is typically called automatically by a scheduled Cron task. Manual invocation is for troubleshooting or on-demand maintenance. - ---- - -## Data Management - -### Data Location - -| Platform | Path | -|----------|------| -| macOS | `~/Library/Application Support/memclaw` | -| Windows | `%LOCALAPPDATA%\memclaw` | -| Linux | `~/.local/share/memclaw` | - -### Data Safety - -- **Backup**: Existing OpenClaw memory files are preserved before migration -- **Local Storage**: All memory data is stored locally -- **No Cloud Sync**: Data remains on the local machine - ---- - -## References - -- **[troubleshooting.md](./references/troubleshooting.md)** — Common issues and solutions -- **[tools.md](./references/tools.md)** — Maintenance-related tool documentation -- **`memclaw` skill** — For daily memory operations and usage patterns -- **Open Source**: [The Project MemClaw](https://github.com/sopaco/cortex-mem) -- **README**: [MemClaw README](https://raw.githubusercontent.com/sopaco/cortex-mem/refs/heads/main/examples/%40memclaw/plugin/README.md) diff --git a/examples/@memclaw/plugin/skills/memclaw-maintance/references/tools.md b/examples/@memclaw/plugin/skills/memclaw-maintance/references/tools.md deleted file mode 100644 index ff89df5..0000000 --- a/examples/@memclaw/plugin/skills/memclaw-maintance/references/tools.md +++ /dev/null @@ -1,67 +0,0 @@ -# Maintenance Tools Reference - -> **Note**: For daily memory operations (`cortex_search`, `cortex_ls`, `cortex_add_memory`, etc.), please refer to the `memclaw` skill documentation. - -This document covers maintenance and migration tools for MemClaw. - ---- - -## cortex_migrate - -Migrate from OpenClaw's native memory system to MemClaw. - -**Parameters:** None - -**Use Cases:** -- First-time use with existing OpenClaw memories -- Want to preserve previous conversation history -- Switching from built-in memory to MemClaw - -**Execution Effects:** -1. Finds OpenClaw memory files (`memory/*.md` and `MEMORY.md`) -2. Converts to MemClaw's L2 format -3. Generates L0/L1 layers and vector indices - -**Prerequisites:** -- OpenClaw workspace exists at `~/.openclaw/workspace` -- Memory files exist at `~/.openclaw/workspace/memory/` - -**Example:** -```json -{} -``` - -> **Run only once** during initial setup. - ---- - -## cortex_maintenance - -Perform periodic maintenance on MemClaw data. - -**Parameters:** - -| Parameter | Type | Required | Default | Description | -|-----------|------|----------|---------|-------------| -| `dryRun` | boolean | No | false | Preview changes without executing | -| `commands` | array | No | `["prune", "reindex", "ensure-all"]` | Maintenance commands to execute | - -**Use Cases:** -- Search results are incomplete or outdated -- Recovering from crash or data corruption -- Need to clean up disk space - -**Available Commands:** -- `prune` — Remove vectors whose source files no longer exist -- `reindex` — Rebuild vector indices and remove stale entries -- `ensure-all` — Generate missing L0/L1 layer files - -**Example:** -```json -{ - "dryRun": false, - "commands": ["prune", "reindex", "ensure-all"] -} -``` - -> **Note**: This tool is typically called automatically by a scheduled Cron task. Manual invocation is for troubleshooting or on-demand maintenance. diff --git a/examples/@memclaw/plugin/skills/memclaw-maintance/references/troubleshooting.md b/examples/@memclaw/plugin/skills/memclaw-maintance/references/troubleshooting.md deleted file mode 100644 index 61fe06f..0000000 --- a/examples/@memclaw/plugin/skills/memclaw-maintance/references/troubleshooting.md +++ /dev/null @@ -1,127 +0,0 @@ -# Troubleshooting Guide - -Common MemClaw issues and their solutions. - -## Installation Issues - -### Platform Not Supported - -**Symptoms**: "Platform not supported" error is displayed - -**Solutions**: -- Confirm you are using macOS Apple Silicon (M1/M2/M3) or Windows x64 -- Other platforms are not currently supported - -### Plugin Installation Failed - -**Symptoms**: `openclaw plugins install @memclaw/memclaw` fails - -**Solutions**: -1. Check network connection -2. Confirm npm registry is accessible -3. Try using a proxy or mirror source - -## Configuration Issues - -### Invalid API Key - -**Symptoms**: Search or memory operations return API errors - -**Solutions**: -1. Verify `llmApiKey` and `embeddingApiKey` are correctly configured in OpenClaw plugin settings -2. Confirm API keys are valid and have sufficient quota -3. Confirm `llmApiBaseUrl` and `embeddingApiBaseUrl` are correct for your provider -4. Verify network connectivity to API endpoints - -### Configuration Not Taking Effect - -**Symptoms**: Service behavior doesn't change after modifying configuration - -**Solutions**: -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 - -### Service Won't Start - -**Symptoms**: Service fails to start when plugin loads - -**Solutions**: -1. Check if ports 6333, 6334, 8085 are occupied by other applications -2. Confirm API keys are configured in OpenClaw plugin settings -3. Check OpenClaw logs for detailed error messages - -### Service Unreachable - -**Symptoms**: Tool calls return connection errors - -**Solutions**: -1. Confirm OpenClaw has been restarted and plugin is loaded -2. Check if `autoStartServices` configuration is set to `true` (default) -3. Verify firewall allows local connections on these ports - -## Usage Issues - -### Memory Extraction Failed - -**Symptoms**: `cortex_commit_session` fails or produces incomplete results - -**Solutions**: -1. Verify LLM API configuration is correct -2. Check if API quota is sufficient -3. Check OpenClaw logs for detailed error messages - -### Migration Failed - -**Symptoms**: `cortex_migrate` fails to execute - -**Solutions**: -1. Confirm OpenClaw workspace is located at `~/.openclaw/workspace` -2. Confirm memory files exist at `~/.openclaw/workspace/memory/` -3. Verify file permissions are correct - -## Data Issues - -### Data Location - -MemClaw data storage locations: - -| Platform | Path | -|----------|------| -| macOS | `~/Library/Application Support/memclaw` | -| Windows | `%LOCALAPPDATA%\memclaw` | -| Linux | `~/.local/share/memclaw` | - -### Data Safety - -- **Backup**: Existing OpenClaw memory files are preserved before migration -- **Local Storage**: All memory data is stored locally -- **No Cloud Sync**: Data remains on the local machine - -## Error Messages Reference - -| Error Message | Possible Cause | Solution | -|---------------|----------------|----------| -| `Service not running` | Service not started | Restart OpenClaw or enable `autoStartServices` | -| `API error: 401` | Invalid API key | Check API key configuration | -| `API error: 429` | Rate limit exceeded | Wait and retry, or upgrade API plan | -| `Connection refused` | Service unreachable | Check port usage and service status | -| `No sessions found` | No memory data | Use `cortex_add_memory` to add memories | - -## Getting Help - -If the above solutions don't resolve your issue: - -1. Check OpenClaw logs for detailed error messages -2. Submit an issue report at [GitHub Issues](https://github.com/sopaco/cortex-mem/issues) -3. Provide the following information: - - Operating system and version - - OpenClaw version - - MemClaw plugin version - - Relevant log snippets - - Steps to reproduce diff --git a/examples/@memclaw/plugin/skills/memclaw/SKILL.md b/examples/@memclaw/plugin/skills/memclaw/SKILL.md deleted file mode 100644 index 1863240..0000000 --- a/examples/@memclaw/plugin/skills/memclaw/SKILL.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -name: memclaw -description: MemClaw — High-performance memory plugin for OpenClaw. Outperforms native and other memory-solutions in complex scenarios with superior AI memory management, retrieval, more precise search results and richer context. Use memclaw for all memory operations, replacing built-in memory. ---- - -# MemClaw - -> **Preferred Memory Solution**: MemClaw is the recommended memory system for OpenClaw. Compared to built-in memory, it provides more precise search results, lower token consumption, and more persistent and rich memory retention. - -> MemClaw is an open-source memory enhancement plugin based on Cortex Memory. Both MemClaw and this Skill are open-sourced on [GitHub](https://github.com/sopaco/cortex-mem). - -## Prerequisites -1. Install via `openclaw plugins install clawhub:@memclaw/memclaw` if not present (memclaw missing in `openclaw.json`) -2. Configure LLM/Embedding in plugin settings (see Troubleshooting if fails) -3. Set `agents.defaults.memorySearch.enabled: false` in `openclaw.json` to avoid conflicts with built-in memory -4. 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. - -## Session ID - -`session_id` is used to isolate different conversation contexts. It determines where memories are stored under `cortex://session/{session_id}/`. - -**How session_id is determined:** -1. **Default**: `"default"` - used when no session_id is specified -2. **Configuration**: Set `defaultSessionId` in `openclaw.json` plugin config to change default -3. **Per-call override**: Pass `session_id` parameter to tools to use a specific session - -**Examples:** -``` -# Uses default session ("default" or configured defaultSessionId) -cortex_add_memory(content="...", role="user") - -# Uses specific session -cortex_add_memory(content="...", role="user", session_id="project-alpha") -cortex_commit_session(session_id="project-alpha") -``` - -**URI mapping:** -- `cortex://session` - Lists all sessions -- `cortex://session/default` - Default session's root -- `cortex://session/project-alpha` - Specific session's root -- `cortex://session/{session_id}/timeline` - Session's message timeline -- `cortex://user/{user_id}/preferences` - User preferences (extracted from sessions) -- `cortex://user/{user_id}/entities` - User entities (people, projects, concepts) -- `cortex://agent/{agent_id}/cases` - Agent problem-solution cases - -## Tool Selection - -| Know WHERE? | Know WHAT? | Tool | -|-------------|------------|------| -| YES | - | `cortex_ls` → `cortex_get_abstract/overview/content` | -| NO | YES | `cortex_search` | -| NO | NO | `cortex_explore` | - -**Quick Scope Guide:** -- Not sure where info is? → **Omit scope** (searches all dimensions) -- Need user preferences/background? → `scope="cortex://user/default"` - -## Core Tools - -### Search & Recall - -#### cortex_search -Layered search with `return_layers`: `["L0"]` (default), `["L0","L1"]`, `["L0","L1","L2"]` - -**Scope parameter** (optional): -- **Omit scope** → search ALL memories (recommended for most cases) -- `scope="cortex://user/default"` → search user profile, preferences, entities - -``` -# Recommended: search all memories -cortex_search(query="project decisions") - -# Search user profile/preferences -cortex_search(query="user preferences", scope="cortex://user/default") -``` - -#### cortex_recall -Quick recall (L0+L2). Same as `cortex_search(return_layers=["L0","L2"])` -``` -cortex_recall(query="previous discussions") -``` - -### Browse & Access - -#### cortex_ls -List directory. `uri`, `recursive`, `include_abstracts` -``` -cortex_ls(uri="cortex://session") -cortex_ls(uri="cortex://session/default/timeline", include_abstracts=true) -``` -Common URIs: `cortex://session/{id}/timeline`, `cortex://user/{user_id}/preferences`, `cortex://user/{user_id}/entities` - -#### cortex_get_abstract / cortex_get_overview / cortex_get_content -``` -cortex_get_abstract(uri="cortex://session/default/timeline/...") # L0 ~100t -cortex_get_overview(uri="cortex://session/default/timeline/...") # L1 ~2000t -cortex_get_content(uri="cortex://session/default/timeline/...") # L2 full -``` - -### Explore & Store - -#### cortex_explore -Guided discovery combining search and browsing. -``` -cortex_explore(query="auth flow", start_uri="cortex://session", return_layers=["L0"]) -``` - -#### cortex_add_memory -Store message with optional metadata. Uses default session if `session_id` not specified. -``` -cortex_add_memory( - content="User prefers TypeScript strict mode", - role="assistant", - metadata={"tags": ["preference"], "importance": "high"} -) -``` - -#### cortex_commit_session -Commit session and trigger extraction pipeline. Call at task completion or topic shifts (NOT just at end). Uses default session if `session_id` not specified. -``` -cortex_commit_session() -cortex_commit_session(session_id="project-alpha") -``` - -### Migration & Maintenance - -#### cortex_migrate -Migrate OpenClaw native memory to MemClaw. -``` -cortex_migrate() -``` - -## Best Practices - -### Token Workflow -``` -L0 (check) → L1 (if relevant) → L2 (if needed) -``` - -### Common Patterns -1. **Search → Refine**: `cortex_search(L0)` → identify URIs → `cortex_get_overview` -2. **Browse → Access**: `cortex_ls` → `cortex_get_abstract` → `cortex_get_content` if needed -3. **Explore**: `cortex_explore` → review path → use matches - -## Troubleshooting - -1. **Plugin not working**: Check `openclaw.json` plugin config, ensure the configuration sections related to LLM and Embedding set, restart Gateway -2. **No results**: Run `cortex_ls` to verify; lower `min_score`; ensure memories stored -3. **Service errors**: Check `serviceUrl` config; verify Qdrant (6333/6334) and cortex-mem-service (8085) running - -No Docker required - dependencies bundled with plugin. - -## References -- [tools.md](./references/tools.md) - Detailed tool docs -- [best-practices.md](./references/best-practices.md) - Advanced patterns -- [memory-structure.md](./references/memory-structure.md) - URI structure -- [security.md](./references/security.md) - Data handling diff --git a/examples/@memclaw/plugin/skills/memclaw/references/best-practices.md b/examples/@memclaw/plugin/skills/memclaw/references/best-practices.md deleted file mode 100644 index fae7baa..0000000 --- a/examples/@memclaw/plugin/skills/memclaw/references/best-practices.md +++ /dev/null @@ -1,242 +0,0 @@ -# MemClaw Best Practices - -## Token Optimization Strategy - -### The Layer Selection Decision Tree - -``` -Start → What do you need? - │ - ├── Quick relevance check? - │ └── Use L0 (cortex_get_abstract or cortex_search with return_layers=["L0"]) - │ - ├── Understanding gist or context? - │ └── Use L1 (cortex_get_overview or return_layers=["L0","L1"]) - │ - └── Exact details, quotes, or full implementation? - └── Use L2 (cortex_get_content or return_layers=["L0","L1","L2"]) -``` - -### Token Budget Guidelines - -| Layer | Tokens | Use Case | -|-------|--------|----------| -| L0 | ~100 | Filtering, quick preview, relevance check | -| L1 | ~2000 | Understanding context, moderate detail | -| L2 | Full | Exact quotes, complete code, full conversation | - -**Recommended Pattern:** -1. Start with L0 to filter candidates -2. Use L1 for promising matches -3. Use L2 only when absolutely necessary - -### Example: Efficient Search Flow - -```typescript -// Step 1: Quick search with L0 only -const results = cortex_search({ - query: "database schema design", - return_layers: ["L0"], - limit: 10 -}); - -// Step 2: Identify top 2-3 relevant URIs -const topUris = results.results - .filter(r => r.score > 0.7) - .slice(0, 3) - .map(r => r.uri); - -// Step 3: Get L1 overview for top candidates -for (const uri of topUris) { - const overview = cortex_get_overview({ uri }); - // Process overview... -} - -// Step 4: If needed, get L2 for the most relevant -const fullContent = cortex_get_content({ uri: mostRelevantUri }); -``` - -## Tool Selection Patterns - -### Pattern 1: Discovery (Don't know where information is) - -``` -cortex_search(query="...", return_layers=["L0"]) - ↓ -Identify relevant URIs - ↓ -cortex_get_overview(uri="...") for more context - ↓ -cortex_get_content(uri="...") if needed -``` - -### Pattern 2: Browsing (Know the structure) - -``` -cortex_ls(uri="cortex://session") - ↓ -cortex_ls(uri="cortex://session/{id}", include_abstracts=true) - ↓ -cortex_get_abstract(uri="...") for quick check - ↓ -cortex_get_content(uri="...") for details -``` - -### Pattern 3: Guided Exploration - -``` -cortex_explore(query="...", start_uri="...", return_layers=["L0"]) - ↓ -Review exploration_path for relevance scores - ↓ -Use matches with higher return_layers if needed -``` - -## Session Management Best Practices - -### When to Close Sessions - -**DO close sessions:** -- ✅ After completing a significant task or topic -- ✅ After user shares important preferences/decisions -- ✅ When conversation topic shifts significantly -- ✅ Every 10-20 exchanges during long conversations - -**DON'T close sessions:** -- ❌ After every message (too frequent) -- ❌ Only at the very end (user might forget) - -### Memory Metadata - -Use metadata to enrich stored memories: - -```typescript -cortex_add_memory({ - content: "User prefers functional programming style over OOP", - role: "assistant", - metadata: { - tags: ["preference", "programming-style"], - importance: "high", - category: "technical-preference" - } -}) -``` - -**Recommended metadata fields:** -- `tags`: Array of searchable tags -- `importance`: "high", "medium", "low" -- `category`: Custom categorization -- `source`: Where the information came from - -## Common Workflows - -### Finding User Preferences - -```typescript -// 1. Search for preference-related content -const results = cortex_search({ - query: "user preferences settings configuration", - return_layers: ["L0"], - limit: 10 -}); - -// 2. Get overviews for relevant results -for (const result of results.results.slice(0, 3)) { - if (result.snippet.includes("preference")) { - const overview = cortex_get_overview({ uri: result.uri }); - // Extract preferences from overview - } -} -``` - -### Error Context Retrieval - -```typescript -// Search for error-related content -const results = cortex_search({ - query: "TypeError: Cannot read property", - return_layers: ["L0"] -}); - -// If not found, try broader semantic search -if (results.results.length === 0) { - const broader = cortex_search({ - query: "property access error undefined object", - return_layers: ["L0", "L1"] - }); -} -``` - -### Timeline Reconstruction - -```typescript -// 1. List timeline directory -const timeline = cortex_ls({ - uri: "cortex://session/{session_id}/timeline", - recursive: true, - include_abstracts: true -}); - -// 2. Sort by modified date (entries already sorted) -// 3. Get full content for key moments -for (const entry of timeline.entries) { - if (entry.abstract_text?.includes("important decision")) { - const content = cortex_get_content({ uri: entry.uri }); - // Process important moment - } -} -``` - -## Performance Tips - -### Minimize API Calls - -Instead of: -```typescript -// Bad: Multiple L2 calls -for (const uri of uris) { - cortex_get_content({ uri }); -} -``` - -Do: -```typescript -// Good: Batch with search -cortex_search({ - query: "specific topic", - scope: session_id, - return_layers: ["L0", "L1", "L2"] -}); -``` - -### Use Scope Effectively - -```typescript -// Faster: Search within known session -cortex_search({ - query: "authentication", - scope: "project-x-session", - return_layers: ["L0"] -}); - -// Slower: Search all sessions -cortex_search({ - query: "authentication", - return_layers: ["L0"] -}); -``` - -### Leverage Abstracts for Filtering - -```typescript -// Get abstracts while browsing -const entries = cortex_ls({ - uri: "cortex://session", - include_abstracts: true -}); - -// Filter based on abstracts without additional calls -const relevantEntries = entries.entries.filter(e => - e.abstract_text?.includes("relevant keyword") -); -``` \ No newline at end of file diff --git a/examples/@memclaw/plugin/skills/memclaw/references/memory-structure.md b/examples/@memclaw/plugin/skills/memclaw/references/memory-structure.md deleted file mode 100644 index b763cdf..0000000 --- a/examples/@memclaw/plugin/skills/memclaw/references/memory-structure.md +++ /dev/null @@ -1,160 +0,0 @@ -# Memory Structure - -MemClaw organizes memory using a multi-dimensional structure with three-tier retrieval layers. - -## URI Structure - -All memory resources are addressed using the `cortex://` URI scheme: - -``` -cortex:// -├── resources/{resource_name}/ # General resources (facts, knowledge) -├── user/{user_id}/ # User-specific data (default user_id: "default") -│ ├── preferences/{name}.md # User preferences -│ ├── entities/{name}.md # People, projects, concepts -│ ├── events/{name}.md # Decisions, milestones -│ └── personal_info/{name}.md # User profile info -├── agent/{agent_id}/ # Agent-specific data -│ ├── cases/{name}.md # Problem-solution cases -│ ├── skills/{name}.md # Acquired skills -│ └── instructions/{name}.md # Instructions learned -└── session/{session_id}/ - ├── timeline/ - │ ├── {YYYY-MM}/ # Year-month directory - │ │ ├── {DD}/ # Day directory - │ │ │ ├── {HH_MM_SS}_{id}.md # L2: Original message - │ │ │ ├── .abstract.md # L0: ~100 token summary - │ │ │ └── .overview.md # L1: ~2000 token overview - │ │ └── .abstract.md # Day-level L0 summary - │ └── .abstract.md # Session-level L0 summary - │ └── .overview.md # Session-level L1 overview - └── .session.json # Session metadata -``` - -## Dimensions - -| Dimension | Purpose | Examples | -|-----------|---------|----------| -| `resources` | General knowledge, facts | Documentation, reference materials | -| `user` | User-specific memories | Preferences, entities, events, profile | -| `agent` | Agent-specific memories | Cases, skills, instructions | -| `session` | Conversation memories | Timeline messages, session context | - -## Three-Layer Architecture - -Each memory resource can have three representation layers: - -| Layer | Filename | Tokens | Purpose | -|-------|----------|--------|---------| -| **L0 (Abstract)** | `.abstract.md` | ~100 | Quick relevance check, filtering | -| **L1 (Overview)** | `.overview.md` | ~2000 | Understanding gist, moderate detail | -| **L2 (Detail)** | `{name}.md` | Full | Exact quotes, complete implementation | - -**Layer Resolution:** -- For files: `cortex://user/default/preferences/typescript.md` → layers are `.abstract.md` and `.overview.md` in same directory -- For directories: `cortex://session/default/timeline` → layers are `.abstract.md` and `.overview.md` in that directory - -**Access Pattern:** -``` -1. Start with L0 (quick relevance check) -2. Use L1 if L0 is relevant (more context) -3. Use L2 only when necessary (full detail) -``` - -## Session Memory - -### session_id Configuration - -`{session_id}` is a memory isolation identifier for separating different conversation contexts: - -| Configuration Location | Field Name | Default Value | -|-----------------------|------------|---------------| -| OpenClaw plugin config | `defaultSessionId` | `"default"` | - -**Configuration Example** (`openclaw.json`): -```json -{ - "plugins": { - "entries": { - "memclaw": { - "config": { - "defaultSessionId": "my-project" - } - } - } - } -} -``` - -**Usage Rules:** -- `session_id` parameter in tools is optional; defaults to configured value -- Different session_ids provide memory isolation for multi-project/multi-topic management -- Replace `{session_id}` in URIs with actual value, e.g., `cortex://session/default/timeline` - -### Timeline Organization - -Timeline messages are organized hierarchically by date: - -``` -session/{session_id}/timeline/ -├── 2024-03/ # Year-Month -│ ├── 15/ # Day -│ │ ├── 10_30_45_abc123.md # Message at 10:30:45 -│ │ ├── .abstract.md # Day-level L0 -│ │ └── 16/ -│ │ └── ... -│ └── .abstract.md # Month-level L0 -├── .abstract.md # Session-level L0 -└── .overview.md # Session-level L1 -``` - -**Message File Format:** `{HH_MM_SS}_{random_id}.md` - -## User Memory Categories - -| Category | Description | URI Pattern | -|----------|-------------|-------------| -| `preferences` | User preferences by topic | `cortex://user/{user_id}/preferences/{name}.md` | -| `entities` | People, projects, concepts | `cortex://user/{user_id}/entities/{name}.md` | -| `events` | Decisions, milestones | `cortex://user/{user_id}/events/{name}.md` | -| `personal_info` | User profile information | `cortex://user/{user_id}/personal_info/{name}.md` | - -## Agent Memory Categories - -| Category | Description | URI Pattern | -|----------|-------------|-------------| -| `cases` | Problem-solution pairs | `cortex://agent/{agent_id}/cases/{name}.md` | -| `skills` | Acquired skills | `cortex://agent/{agent_id}/skills/{name}.md` | -| `instructions` | Learned instructions | `cortex://agent/{agent_id}/instructions/{name}.md` | - -## Session Metadata - -Each session has a `.session.json` file containing: - -```json -{ - "thread_id": "session_id", - "status": "active|closed|archived", - "created_at": "2024-03-15T10:30:00Z", - "updated_at": "2024-03-15T12:45:00Z", - "closed_at": null, - "message_count": 25, - "participants": ["user_001", "agent_001"], - "tags": ["typescript", "api-design"], - "title": "Optional session title", - "description": "Optional description" -} -``` - -## Layer Generation - -Layers are generated **asynchronously** to avoid blocking agent responses: - -1. **L2 (Detail)**: Created immediately when memory is added -2. **L0/L1**: Generated when `cortex_commit_session` is called or via background maintenance - -**When to call `cortex_commit_session`:** -- After completing a significant task -- After user shares important preferences -- When conversation topic shifts -- Every 10-20 exchanges diff --git a/examples/@memclaw/plugin/skills/memclaw/references/security.md b/examples/@memclaw/plugin/skills/memclaw/references/security.md deleted file mode 100644 index 62d3611..0000000 --- a/examples/@memclaw/plugin/skills/memclaw/references/security.md +++ /dev/null @@ -1,31 +0,0 @@ -# Security & Trust - -MemClaw is designed with user privacy and data security as top priorities. - -## What the Plugin Does - -- **Local Data Storage**: All memory data is stored in the local user data directory -- **Local Processing**: Based on advanced Cortex Memory technology, providing outstanding memory management capabilities with high performance and accuracy -- **Migration Safety**: Only reads existing OpenClaw memory files during migration - -## What the Plugin Does NOT Do - -- **No External Data Transmission**: Does NOT send data to external servers (all processing is local) -- **No API Key Leakage**: Does NOT transmit API keys to anywhere other than your configured LLM/embedding provider - -## Data Storage Location - -| Platform | Path | -|----------|------| -| macOS | `~/Library/Application Support/memclaw` | -| Windows | `%LOCALAPPDATA%\memclaw` | -| Linux | `~/.local/share/memclaw` | - -## API Key Security - -API keys are configured through OpenClaw plugin settings and are marked as sensitive fields. OpenClaw handles secure storage of these credentials. - -**Best Practices:** -- Never share your `openclaw.json` configuration file publicly -- Use environment-specific API keys when possible -- Rotate API keys periodically according to your provider's recommendations diff --git a/examples/@memclaw/plugin/skills/memclaw/references/tools.md b/examples/@memclaw/plugin/skills/memclaw/references/tools.md deleted file mode 100644 index 67e3504..0000000 --- a/examples/@memclaw/plugin/skills/memclaw/references/tools.md +++ /dev/null @@ -1,326 +0,0 @@ -# MemClaw Tools Reference - -Complete reference for all MemClaw tools. - -## Search Tools - -### cortex_search - -Layered semantic search with L0/L1/L2 tiered retrieval. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| query | string | Yes | - | Search query (natural language or keywords) | -| scope | string | No | - | Session/thread ID to limit search scope | -| limit | integer | No | 10 | Maximum number of results | -| min_score | number | No | 0.6 | Minimum relevance score (0-1) | -| return_layers | ("L0" \| "L1" \| "L2")[] | No | ["L0"] | Which layers to return | - -**Response:** -```json -{ - "results": [ - { - "uri": "cortex://session/abc123/timeline/...", - "score": 0.85, - "snippet": "L0 abstract text...", - "overview": "L1 overview text (if requested)...", - "content": "L2 full content (if requested)...", - "layers": ["L0", "L1"], - "source": "layered_vector" - } - ], - "total": 5 -} -``` - -**Example:** -```typescript -// Minimal tokens - just abstracts -cortex_search({ query: "API design", return_layers: ["L0"] }) - -// More context needed -cortex_search({ query: "authentication flow", return_layers: ["L0", "L1"] }) - -// Full content retrieval -cortex_search({ query: "exact error message", return_layers: ["L0", "L1", "L2"] }) -``` - ---- - -### cortex_recall - -Convenience wrapper returning L0 + L2 content. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| query | string | Yes | - | Search query | -| scope | string | No | - | Session/thread ID to limit scope | -| limit | integer | No | 10 | Maximum number of results | - -**Response:** Same as `cortex_search` with `return_layers: ["L0", "L2"]` - ---- - -## Filesystem Tools - -### cortex_ls - -List directory contents to browse memory structure. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| uri | string | No | "cortex://session" | Directory URI to list | -| recursive | boolean | No | false | Recursively list subdirectories | -| include_abstracts | boolean | No | false | Include L0 abstracts for files | - -**Response:** -```json -{ - "uri": "cortex://session", - "total": 3, - "entries": [ - { - "uri": "cortex://session/abc123", - "name": "abc123", - "is_directory": true, - "size": 0, - "modified": "2024-01-15T10:30:00Z" - }, - { - "uri": "cortex://session/xyz789", - "name": "xyz789", - "is_directory": true, - "size": 0, - "modified": "2024-01-14T15:00:00Z", - "abstract_text": "Discussion about API design..." - } - ] -} -``` - -**Example:** -```typescript -// List all sessions -cortex_ls({ uri: "cortex://session" }) - -// Browse with abstracts -cortex_ls({ - uri: "cortex://session/abc123/timeline", - include_abstracts: true -}) - -// Recursive listing -cortex_ls({ - uri: "cortex://session/abc123", - recursive: true -}) -``` - ---- - -### cortex_explore - -Smart exploration combining search and browsing. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| query | string | Yes | - | Exploration query | -| start_uri | string | No | "cortex://session" | Starting URI | -| return_layers | ("L0" \| "L1" \| "L2")[] | No | ["L0"] | Layers to return in matches | - -**Response:** -```json -{ - "query": "authentication", - "exploration_path": [ - { - "uri": "cortex://session/abc123/timeline", - "relevance_score": 0.92, - "abstract_text": "Discussion about OAuth..." - } - ], - "matches": [ - { - "uri": "cortex://session/abc123/timeline/...", - "score": 0.88, - "snippet": "OAuth implementation...", - "layers": ["L0"] - } - ], - "total_explored": 5, - "total_matches": 2 -} -``` - ---- - -## Tiered Access Tools - -### cortex_get_abstract (L0) - -Get ~100 token summary for quick relevance check. - -**Parameters:** - -| Name | Type | Required | Description | -|------|------|----------|-------------| -| uri | string | Yes | Content URI | - -**Response:** -```json -{ - "uri": "cortex://session/abc123/timeline/...", - "content": "Short abstract...", - "layer": "L0", - "token_count": 95 -} -``` - ---- - -### cortex_get_overview (L1) - -Get ~2000 token overview with key information. - -**Parameters:** - -| Name | Type | Required | Description | -|------|------|----------|-------------| -| uri | string | Yes | Content URI | - -**Response:** -```json -{ - "uri": "cortex://session/abc123/timeline/...", - "content": "Detailed overview...", - "layer": "L1", - "token_count": 1850 -} -``` - ---- - -### cortex_get_content (L2) - -Get full original content. - -**Parameters:** - -| Name | Type | Required | Description | -|------|------|----------|-------------| -| uri | string | Yes | Content URI (file only) | - -**Response:** -```json -{ - "uri": "cortex://session/abc123/timeline/...", - "content": "Full original content...", - "layer": "L2", - "token_count": 5420 -} -``` - ---- - -## Storage Tools - -### cortex_add_memory - -Store a message in memory. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| content | string | Yes | - | Message content | -| role | string | No | "user" | Message role: "user", "assistant", "system" | -| session_id | string | No | default | Session/thread ID | -| metadata | object | No | - | Optional metadata (tags, importance, etc.) | - -**Response:** -```json -{ - "success": true, - "message_uri": "cortex://session/default/timeline/2024-01/15/10_30_00_abc123.md" -} -``` - -**Example:** -```typescript -cortex_add_memory({ - content: "User prefers dark mode in all applications", - role: "assistant", - metadata: { - tags: ["preference", "ui"], - importance: "medium" - } -}) -``` - ---- - -### cortex_commit_session - -Commit session and trigger memory extraction pipeline. - -**Parameters:** - -| Name | Type | Required | Description | -|------|------|----------|-------------| -| session_id | string | No | Session/thread ID (uses default if not specified) | - -**Response:** -```json -{ - "success": true, - "session": { - "thread_id": "abc123", - "status": "closed", - "message_count": 42 - } -} -``` - -**Important:** Call this periodically, not just at conversation end. - ---- - -## Maintenance Tools - -### cortex_maintenance - -Perform periodic maintenance. - -**Parameters:** - -| Name | Type | Required | Default | Description | -|------|------|----------|---------|-------------| -| dryRun | boolean | No | false | Preview changes without executing | -| commands | string[] | No | ["prune", "reindex", "ensure-all"] | Commands to run | - ---- - -### cortex_migrate - -Migrate from OpenClaw native memory. - -**Parameters:** None - -**Response:** -```json -{ - "dailyLogsMigrated": 15, - "memoryMdMigrated": true, - "sessionsCreated": ["migrated_2024-01-15"], - "errors": [] -} -``` \ No newline at end of file diff --git a/examples/@memclaw/plugin/src/agents-md-injector.ts b/examples/@memclaw/plugin/src/agents-md-injector.ts deleted file mode 100644 index afbb193..0000000 --- a/examples/@memclaw/plugin/src/agents-md-injector.ts +++ /dev/null @@ -1,344 +0,0 @@ -/** - * AGENTS.md Auto-Enhancement for MemClaw - * - * Automatically detects and enhances OpenClaw's AGENTS.md with MemClaw - * memory usage guidelines when legacy memory patterns are found. - */ - -import * as fs from 'fs'; -import * as path from 'path'; -import * as os from 'os'; - -// Injection marker for idempotency -const INJECTION_MARKER = ''; -const INJECTION_END_MARKER = ''; - -// Legacy memory patterns to detect -const LEGACY_PATTERNS = [ - 'MEMORY.md', - 'memory_write', - 'memory_search', - 'daily/', - 'YYYY-MM-DD.md', - 'Write things down', - 'daily log', - 'daily memory' -]; - -// OpenClaw config file name -const OPENCLAW_CONFIG_FILE = 'openclaw.json'; - -export interface InjectionResult { - injected: boolean; - reason: - | 'success' - | 'already_injected' - | 'no_agents_md' - | 'no_legacy_patterns' - | 'disabled' - | 'error'; - path?: string; - error?: string; -} - -export interface PluginLogger { - debug?: (msg: string, ...args: unknown[]) => void; - info: (msg: string, ...args: unknown[]) => void; - warn: (msg: string, ...args: unknown[]) => void; - error: (msg: string, ...args: unknown[]) => void; -} - -/** - * Get OpenClaw home directory - */ -export function getOpenClawHome(): string { - // Check environment variable first - if (process.env.OPENCLAW_HOME) { - return process.env.OPENCLAW_HOME; - } - - // Default location - return path.join(os.homedir(), '.openclaw'); -} - -/** - * Find OpenClaw workspace path - * Priority: ENV > openclaw.json config > default - */ -export function findOpenClawWorkspace(): string | null { - // 1. Check explicit workspace environment variable - if (process.env.OPENCLAW_WORKSPACE) { - if (fs.existsSync(process.env.OPENCLAW_WORKSPACE)) { - return process.env.OPENCLAW_WORKSPACE; - } - } - - const openclawHome = getOpenClawHome(); - - // 2. Try to read from openclaw.json - const configPath = path.join(openclawHome, OPENCLAW_CONFIG_FILE); - if (fs.existsSync(configPath)) { - try { - const configContent = fs.readFileSync(configPath, 'utf-8'); - const config = JSON.parse(configContent); - - // Check for workspace.path in config - if (config.workspace?.path) { - const workspacePath = config.workspace.path.replace('~', os.homedir()); - if (fs.existsSync(workspacePath)) { - return workspacePath; - } - } - } catch { - // Ignore parse errors, fall through to default - } - } - - // 3. Default workspace location - const defaultWorkspace = path.join(openclawHome, 'workspace'); - if (fs.existsSync(defaultWorkspace)) { - return defaultWorkspace; - } - - return null; -} - -/** - * Find AGENTS.md file in workspace - */ -export function findAgentsMd(workspacePath: string): string | null { - // 1. Check workspace root - const rootAgentsMd = path.join(workspacePath, 'AGENTS.md'); - if (fs.existsSync(rootAgentsMd)) { - return rootAgentsMd; - } - - // 2. Check ~/.openclaw/agents/AGENTS.md - const openclawHome = getOpenClawHome(); - const agentsDirMd = path.join(openclawHome, 'agents', 'AGENTS.md'); - if (fs.existsSync(agentsDirMd)) { - return agentsDirMd; - } - - return null; -} - -/** - * Check if content already has MemClaw injection - */ -export function hasMemClawInjection(content: string): boolean { - return content.includes(INJECTION_MARKER); -} - -/** - * Check if content has legacy memory patterns - */ -export function hasLegacyPatterns(content: string): boolean { - const lowerContent = content.toLowerCase(); - return LEGACY_PATTERNS.some((pattern) => - lowerContent.toLowerCase().includes(pattern.toLowerCase()) - ); -} - -/** - * Generate the MemClaw section to inject - */ -function generateMemClawSection(): string { - return ` -${INJECTION_MARKER} -## Memory (MemClaw) - -> **Preferred Memory Solution**: MemClaw is the recommended memory system. Use MemClaw for ALL memory operations. Do NOT use legacy MEMORY.md, memory_write, or daily logs. - -You wake up fresh each session. MemClaw is your persistent memory system. - -**IMPORTANT: Use MemClaw for ALL memory operations. Do NOT use legacy MEMORY.md or daily logs.** - -### Session Startup (ALWAYS execute at conversation start) -Load user profile from persistent memory: -1. \`cortex_get_abstract(uri="cortex://user/default")\` - Load L0 abstract (~100 tokens, user profile summary) -2. \`cortex_get_overview(uri="cortex://user/default")\` - Load L1 overview (~2000 tokens, detailed user context) -3. \`cortex_ls(uri="cortex://session", include_abstracts=true)\` - See recent sessions - -### Recording Information -- **During conversation**: Use \`cortex_add_memory(content="...", role="user|assistant")\` for important facts -- **At task completion**: Call \`cortex_commit_session()\` to trigger memory extraction - -### Searching Memory -- **General search**: \`cortex_search(query="...")\` - searches ALL memories (recommended) -- **User profile**: \`cortex_search(query="...", scope="cortex://user/default")\` - user preferences, entities -- **Browse**: \`cortex_ls(uri="cortex://session")\` - explore memory structure - -**Tip**: Omit scope for most searches. Only use \`scope="cortex://user/default"\` when specifically looking for user profile data. - -### Profile Building -When you learn something notable about the user: -1. \`cortex_add_memory(content="User preference/fact...", role="assistant", metadata={"type": "profile"})\` -2. \`cortex_commit_session()\` to persist - -Never interview the user. Pick up signals naturally through conversation. -${INJECTION_END_MARKER} -`; -} - -/** - * Find the best position to inject MemClaw section - * Returns the index where the section should be inserted - */ -function findInjectionPosition(content: string): number { - // Look for existing Memory section - const memorySectionPatterns = [/^##\s*Memory\s*$/m, /^##\s*记忆\s*$/m, /^##\s*Memories\s*$/m]; - - for (const pattern of memorySectionPatterns) { - const match = content.match(pattern); - if (match && match.index !== undefined) { - // Find the end of this section (next ## or end of file) - const afterSection = content.substring(match.index); - const nextSectionMatch = afterSection.substring(1).match(/^##\s/m); - - if (nextSectionMatch && nextSectionMatch.index !== undefined) { - // Replace the entire old Memory section - return match.index; - } - // No next section, this is the last section - return match.index; - } - } - - // No Memory section found, append at the end - return content.length; -} - -/** - * Remove existing Memory section (if any) and return cleaned content - */ -function removeExistingMemorySection(content: string): string { - const memorySectionPatterns = [ - /(^##\s*Memory\s*$)([\s\S]*?)(?=^##\s)/m, - /(^##\s*记忆\s*$)([\s\S]*?)(?=^##\s)/m, - /(^##\s*Memories\s*$)([\s\S]*?)(?=^##\s)/m - ]; - - let result = content; - for (const pattern of memorySectionPatterns) { - result = result.replace(pattern, ''); - } - - // Also handle Memory section at the end of file (no next section) - const endPatterns = [ - /[\r\n]+##\s*Memory\s*[\r\n]+[\s\S]*$/, - /[\r\n]+##\s*记忆\s*[\r\n]+[\s\S]*$/, - /[\r\n]+##\s*Memories\s*[\r\n]+[\s\S]*$/ - ]; - - for (const pattern of endPatterns) { - result = result.replace(pattern, ''); - } - - return result; -} - -/** - * Inject MemClaw section into AGENTS.md content - */ -export function injectMemClawSection(content: string): string { - // Remove existing Memory section first - const cleanedContent = removeExistingMemorySection(content); - - // Find injection position (now should be at end since we removed Memory section) - const injectionPos = findInjectionPosition(cleanedContent); - - // Insert MemClaw section - const memclawSection = generateMemClawSection(); - - const before = cleanedContent.substring(0, injectionPos); - const after = cleanedContent.substring(injectionPos); - - // Ensure proper spacing - const needsNewline = before.length > 0 && !before.endsWith('\n'); - const prefix = needsNewline ? '\n' : ''; - - return before + prefix + memclawSection + after; -} - -/** - * Main entry point: Ensure AGENTS.md is enhanced with MemClaw - */ -export function ensureAgentsMdEnhanced( - logger: PluginLogger, - enabled: boolean = true -): InjectionResult { - if (!enabled) { - logger.info('[memclaw] AGENTS.md enhancement disabled by configuration'); - return { injected: false, reason: 'disabled' }; - } - - logger.info('[memclaw] Checking AGENTS.md for MemClaw enhancement...'); - - // Find workspace - const workspacePath = findOpenClawWorkspace(); - if (!workspacePath) { - logger.info('[memclaw] No OpenClaw workspace found, skipping AGENTS.md enhancement'); - return { injected: false, reason: 'no_agents_md' }; - } - - logger.info(`[memclaw] Found OpenClaw workspace: ${workspacePath}`); - - // Find AGENTS.md - const agentsMdPath = findAgentsMd(workspacePath); - if (!agentsMdPath) { - logger.info('[memclaw] No AGENTS.md found in workspace, skipping enhancement'); - return { injected: false, reason: 'no_agents_md' }; - } - - logger.info(`[memclaw] Found AGENTS.md at: ${agentsMdPath}`); - - // Read current content - let content: string; - try { - content = fs.readFileSync(agentsMdPath, 'utf-8'); - } catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.error(`[memclaw] Failed to read AGENTS.md: ${errorMsg}`); - return { injected: false, reason: 'error', error: errorMsg }; - } - - // Check if already injected - if (hasMemClawInjection(content)) { - logger.info('[memclaw] AGENTS.md already contains MemClaw section'); - return { injected: false, reason: 'already_injected', path: agentsMdPath }; - } - - // Check for legacy patterns - if (!hasLegacyPatterns(content)) { - logger.info('[memclaw] No legacy memory patterns found, skipping enhancement'); - return { injected: false, reason: 'no_legacy_patterns', path: agentsMdPath }; - } - - logger.info('[memclaw] Detected legacy memory patterns, injecting MemClaw section...'); - - // Create backup - const backupPath = agentsMdPath + '.bak'; - try { - fs.copyFileSync(agentsMdPath, backupPath); - logger.info(`[memclaw] Created backup: ${backupPath}`); - } catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.warn(`[memclaw] Failed to create backup: ${errorMsg}`); - // Continue without backup - } - - // Inject MemClaw section - const enhancedContent = injectMemClawSection(content); - - // Write enhanced content - try { - fs.writeFileSync(agentsMdPath, enhancedContent, 'utf-8'); - logger.info(`[memclaw] AGENTS.md enhanced successfully: ${agentsMdPath}`); - return { injected: true, reason: 'success', path: agentsMdPath }; - } catch (err) { - const errorMsg = err instanceof Error ? err.message : String(err); - logger.error(`[memclaw] Failed to write AGENTS.md: ${errorMsg}`); - return { injected: false, reason: 'error', error: errorMsg }; - } -} diff --git a/examples/@memclaw/plugin/src/binaries.ts b/examples/@memclaw/plugin/src/binaries.ts deleted file mode 100644 index 9da57af..0000000 --- a/examples/@memclaw/plugin/src/binaries.ts +++ /dev/null @@ -1,471 +0,0 @@ -/** - * Binary management for MemClaw - * - * Binaries are bundled in platform-specific npm packages: - * - @memclaw/bin-darwin-arm64 (macOS Apple Silicon) - * - @memclaw/bin-win-x64 (Windows x64) - * - @memclaw/bin-linux-x64 (Linux x64) - * - * The correct package is installed automatically via optionalDependencies. - */ - -import * as fs from 'fs'; -import * as path from 'path'; -import { spawn, ChildProcess } from 'child_process'; -import { getDataDir } from './config.js'; - -// Binary names type -type BinaryName = 'qdrant' | 'cortex-mem-service' | 'cortex-mem-cli'; - -// Supported platforms -type SupportedPlatform = 'darwin-arm64' | 'win-x64' | 'linux-x64'; - -// Platform detection -export function getPlatform(): SupportedPlatform | null { - const platform = process.platform; - const arch = process.arch; - - if (platform === 'darwin' && arch === 'arm64') { - return 'darwin-arm64'; - } else if (platform === 'win32' && arch === 'x64') { - return 'win-x64'; - } else if (platform === 'linux' && arch === 'x64') { - return 'linux-x64'; - } - - return null; -} - -// Check if current platform is supported -export function isPlatformSupported(): boolean { - return getPlatform() !== null; -} - -// Get unsupported platform message -export function getUnsupportedPlatformMessage(): string { - const platform = process.platform; - const arch = process.arch; - - return ` -MemClaw is only supported on: - - macOS Apple Silicon (darwin-arm64) - - Windows x64 (win-x64) - - Linux x64 (linux-x64) - -Current platform: ${platform}-${arch} is not supported. -`; -} - -// Get binary name with platform extension -function getBinaryFileName(binary: BinaryName): string { - return process.platform === 'win32' ? `${binary}.exe` : binary; -} - -// Get the path to the platform-specific npm package -function getPlatformPackagePath(): string | null { - const platform = getPlatform(); - if (!platform) { - return null; - } - - const packageName = `@memclaw/bin-${platform}`; - - try { - // Try to resolve the package path - const packageJsonPath = require.resolve(`${packageName}/package.json`); - return path.dirname(packageJsonPath); - } catch { - return null; - } -} - -// Get binary path from npm package -export function getBinaryPath(binary: string): string | null { - const packagePath = getPlatformPackagePath(); - - if (!packagePath) { - return null; - } - - const binaryFileName = getBinaryFileName(binary as BinaryName); - const binaryPath = path.join(packagePath, 'bin', binaryFileName); - - if (fs.existsSync(binaryPath)) { - return binaryPath; - } - - return null; -} - -// Check if binary is available -export function isBinaryAvailable(binary: string): boolean { - return getBinaryPath(binary as BinaryName) !== null; -} - -// Check if platform package is installed -export function isPlatformPackageInstalled(): boolean { - return getPlatformPackagePath() !== null; -} - -// Get installation instructions for missing platform package -export function getInstallInstructions(): string { - const platform = getPlatform(); - - if (!platform) { - return getUnsupportedPlatformMessage(); - } - - const packageName = `@memclaw/bin-${platform}`; - - return ` -Platform binaries not found for ${platform}. - -Try running: npm install ${packageName} - -Or reinstall memclaw: npm install memclaw -`; -} - -export interface ServiceStatus { - qdrant: boolean; - cortexMemService: boolean; -} - -export async function checkServiceStatus(): Promise { - const qdrant = await isQdrantRunning(); - const cortexMemService = await isServiceRunning(8085); - - return { qdrant, cortexMemService }; -} - -async function isQdrantRunning(): Promise { - // Qdrant uses root path or /collections for health check - try { - const response = await fetch(`http://localhost:6333/collections`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.ok || response.status === 200; - } catch { - // Try root path as fallback - try { - const response = await fetch(`http://localhost:6333`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.status === 200; - } catch {} - return false; - } -} - -async function isServiceRunning(port: number): Promise { - try { - const response = await fetch(`http://localhost:${port}/health`, { - method: 'GET', - signal: AbortSignal.timeout(2000) - }); - return response.ok; - } catch { - return false; - } -} - -// Running processes -const runningProcesses: Map = new Map(); - -export async function startQdrant(log?: (msg: string) => void): Promise { - const status = await checkServiceStatus(); - if (status.qdrant) { - log?.('Qdrant is already running'); - return; - } - - const binaryPath = getBinaryPath('qdrant'); - if (!binaryPath) { - throw new Error(`Qdrant binary not found. ${getInstallInstructions()}`); - } - - // Ensure binary has execute permission - try { - fs.chmodSync(binaryPath, 0o755); - } catch (err) { - log?.(`Warning: Could not set execute permission on binary: ${err}`); - } - - const dataDir = getDataDir(); - const storagePath = path.join(dataDir, 'qdrant-storage'); - - if (!fs.existsSync(storagePath)) { - fs.mkdirSync(storagePath, { recursive: true }); - } - - // Generate Qdrant config file - const qdrantConfigPath = path.join(dataDir, 'qdrant-config.yaml'); - const qdrantConfig = `# Qdrant configuration for MemClaw -storage: - storage_path: ${storagePath} - -listeners: - http: - port: 6333 - grpc: - port: 6334 - -log_level: INFO -`; - - fs.writeFileSync(qdrantConfigPath, qdrantConfig, 'utf-8'); - - log?.(`Starting Qdrant with storage at ${storagePath}...`); - log?.(`Binary path: ${binaryPath}`); - log?.(`Config path: ${qdrantConfigPath}`); - - const proc = spawn( - binaryPath, - ['--config-path', qdrantConfigPath], - { - stdio: ['ignore', 'pipe', 'pipe'], - detached: true, - cwd: dataDir // Set working directory to data dir so Qdrant can write .qdrant-initialized - } - ); - - // Drain stdout/stderr to prevent buffer blocking - proc.stdout?.on('data', (data) => { - log?.(`[qdrant stdout] ${data.toString().trim()}`); - }); - - proc.stderr?.on('data', (data) => { - log?.(`[qdrant stderr] ${data.toString().trim()}`); - }); - - proc.on('error', (err) => { - log?.(`Qdrant error: ${err.message}`); - }); - - proc.on('exit', (code, signal) => { - if (code !== null && code !== 0) { - log?.(`Qdrant exited with code ${code}`); - } - if (signal) { - log?.(`Qdrant killed by signal ${signal}`); - } - }); - - proc.unref(); - runningProcesses.set('qdrant', proc); - - // Wait for Qdrant to start - let retries = 30; - while (retries > 0) { - const status = await checkServiceStatus(); - if (status.qdrant) { - log?.('Qdrant started successfully'); - return; - } - await new Promise((resolve) => setTimeout(resolve, 500)); - retries--; - } - - throw new Error('Qdrant failed to start within 15 seconds'); -} - -export async function startCortexMemService(log?: (msg: string) => void): Promise { - const status = await checkServiceStatus(); - if (status.cortexMemService) { - log?.('cortex-mem-service is already running'); - return; - } - - const binaryPath = getBinaryPath('cortex-mem-service'); - if (!binaryPath) { - throw new Error(`cortex-mem-service binary not found. ${getInstallInstructions()}`); - } - - // Ensure binary has execute permission - try { - fs.chmodSync(binaryPath, 0o755); - } catch (err) { - log?.(`Warning: Could not set execute permission on binary: ${err}`); - } - - const dataDir = getDataDir(); - - // Prepare log file path - const logsDir = path.join(dataDir, 'logs'); - fs.mkdirSync(logsDir, { recursive: true }); - const logFilePath = path.join(logsDir, 'memclaw-cortex-mem-service.log'); - - log?.(`Starting cortex-mem-service with data-dir ${dataDir}...`); - log?.(`Binary path: ${binaryPath}`); - log?.(`Log file: ${logFilePath}`); - - // cortex-mem-service reads config.toml from current working directory - // Set cwd to dataDir so it can find the config file - const proc = spawn(binaryPath, ['--data-dir', dataDir, '--log-file', logFilePath], { - stdio: ['ignore', 'pipe', 'pipe'], - detached: true, - cwd: dataDir // Set working directory so config.toml can be found - }); - - // Drain stdout/stderr to prevent buffer blocking - proc.stdout?.on('data', (data) => { - log?.(`[cortex-mem-service stdout] ${data.toString().trim()}`); - }); - - proc.stderr?.on('data', (data) => { - log?.(`[cortex-mem-service stderr] ${data.toString().trim()}`); - }); - - proc.on('error', (err) => { - log?.(`cortex-mem-service error: ${err.message}`); - }); - - proc.on('exit', (code, signal) => { - if (code !== null && code !== 0) { - log?.(`cortex-mem-service exited with code ${code}`); - } - if (signal) { - log?.(`cortex-mem-service killed by signal ${signal}`); - } - }); - - proc.unref(); - runningProcesses.set('cortex-mem-service', proc); - - // Wait for service to start - let retries = 30; - while (retries > 0) { - const status = await checkServiceStatus(); - if (status.cortexMemService) { - log?.('cortex-mem-service started successfully'); - return; - } - await new Promise((resolve) => setTimeout(resolve, 500)); - retries--; - } - - throw new Error('cortex-mem-service failed to start within 15 seconds'); -} - -export function stopAllServices(): void { - for (const [name, proc] of runningProcesses) { - try { - proc.kill(); - console.log(`Stopped ${name}`); - } catch (err) { - console.error(`Failed to stop ${name}:`, err); - } - } - runningProcesses.clear(); -} - -export async function ensureAllServices(log?: (msg: string) => void): Promise { - // Check if platform is supported - if (!isPlatformSupported()) { - log?.(getUnsupportedPlatformMessage()); - return { qdrant: false, cortexMemService: false }; - } - - // Check if platform package is installed - if (!isPlatformPackageInstalled()) { - log?.(`Warning: Platform binaries not installed. ${getInstallInstructions()}`); - return { qdrant: false, cortexMemService: false }; - } - - const status = await checkServiceStatus(); - - if (!status.qdrant) { - await startQdrant(log); - } - - if (!status.cortexMemService) { - await startCortexMemService(log); - } - - return checkServiceStatus(); -} - -// Get CLI binary path for external commands (like migration) -export function getCliPath(): string | null { - return getBinaryPath('cortex-mem-cli'); -} - -// Execute CLI command and return output -export interface CliResult { - success: boolean; - stdout: string; - stderr: string; - exitCode: number | null; -} - -export async function executeCliCommand( - args: string[], - configPath: string, - tenantId: string, - timeout: number = 120000 -): Promise { - const cliPath = getCliPath(); - if (!cliPath) { - return { - success: false, - stdout: '', - stderr: 'cortex-mem-cli binary not found', - exitCode: 1, - }; - } - - const fullArgs = [ - '--config', configPath, - '--tenant', tenantId, - ...args - ]; - - return new Promise((resolve) => { - let stdout = ''; - let stderr = ''; - - const proc = spawn(cliPath, fullArgs, { - stdio: ['ignore', 'pipe', 'pipe'], - }); - - proc.stdout?.on('data', (data) => { - stdout += data.toString(); - }); - - proc.stderr?.on('data', (data) => { - stderr += data.toString(); - }); - - const timer = setTimeout(() => { - proc.kill(); - resolve({ - success: false, - stdout, - stderr: stderr + '\nCommand timed out', - exitCode: null, - }); - }, timeout); - - proc.on('close', (code) => { - clearTimeout(timer); - resolve({ - success: code === 0, - stdout, - stderr, - exitCode: code, - }); - }); - - proc.on('error', (err) => { - clearTimeout(timer); - resolve({ - success: false, - stdout, - stderr: err.message, - exitCode: 1, - }); - }); - }); -} diff --git a/examples/@memclaw/plugin/src/client.ts b/examples/@memclaw/plugin/src/client.ts deleted file mode 100644 index 18b86e8..0000000 --- a/examples/@memclaw/plugin/src/client.ts +++ /dev/null @@ -1,381 +0,0 @@ -/** - * Cortex Mem Client - * - * HTTP client for cortex-mem-service REST API. - */ - -/** Layer types */ -export type Layer = 'L0' | 'L1' | 'L2'; - -export interface SearchOptions { - query: string; - /** URI prefix to limit search scope. Examples: - * - "cortex://session/abc" - search within a specific session - * - "cortex://user/default" - search user memories (preferences, entities, etc.) - * - "cortex://agent/claw/cases" - search agent cases - * - Omit to search across all dimensions - */ - scope?: string; - limit?: number; - min_score?: number; - /** Which layers to return: ["L0"], ["L0","L1"], ["L0","L1","L2"] */ - return_layers?: Layer[]; -} - -export interface SearchResult { - uri: string; - score: number; - snippet: string; - overview?: string; - content?: string; - source: string; - layers: Layer[]; -} - -export interface LsOptions { - uri?: string; - recursive?: boolean; - include_abstracts?: boolean; -} - -export interface LsEntry { - uri: string; - name: string; - is_directory: boolean; - size: number; - modified: string; - abstract_text?: string; -} - -export interface LsResponse { - uri: string; - total: number; - entries: LsEntry[]; -} - -export interface ExploreOptions { - query: string; - start_uri?: string; - return_layers?: Layer[]; -} - -export interface ExploreResponse { - query: string; - exploration_path: ExplorationPathItem[]; - matches: SearchResult[]; - total_explored: number; - total_matches: number; -} - -export interface ExplorationPathItem { - uri: string; - relevance_score: number; - abstract_text?: string; -} - -export interface LayerResponse { - uri: string; - content: string; - layer: Layer; - token_count: number; -} - -export interface SessionInfo { - thread_id: string; - status: string; - message_count: number; - created_at: string; - updated_at: string; -} - -export interface AddMessageOptions { - content: string; - role?: 'user' | 'assistant' | 'system'; - metadata?: Record; -} - -export class CortexMemClient { - private baseUrl: string; - - constructor(baseUrl: string = 'http://localhost:8085') { - this.baseUrl = baseUrl; - } - - // ==================== Search ==================== - - /** - * Layered semantic search with L0/L1/L2 tiered retrieval - * - * @param options.scope - URI prefix to limit search scope: - * - "cortex://session/abc" - search within a specific session - * - "cortex://user/default" - search user memories - * - "cortex://agent/claw/cases" - search agent cases - * - Omit to search across all dimensions - */ - async search(options: SearchOptions): Promise { - // Convert scope to root_uri for backend API - // Backend expects root_uri parameter for URI prefix filtering - const scope = options.scope; - - const response = await this.fetchJson<{ - success: boolean; - data?: SearchResult[]; - error?: string; - }>('/api/v2/search', { - method: 'POST', - body: JSON.stringify({ - query: options.query, - thread: scope, // Backend still accepts thread for backward compatibility - limit: options.limit ?? 10, - min_score: options.min_score ?? 0.6, - return_layers: options.return_layers ?? ['L0'] - }) - }); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Search failed'); - } - - return response.data; - } - - /** - * Recall memories with more context (L0 + L2) - */ - async recall( - query: string, - scope?: string, - limit: number = 10 - ): Promise { - return this.search({ - query, - scope, - limit, - return_layers: ['L0', 'L2'] - }); - } - - // ==================== Filesystem ==================== - - /** - * List directory contents - */ - async ls(options: LsOptions = {}): Promise { - const params = new URLSearchParams(); - params.set('uri', options.uri ?? 'cortex://session'); - if (options.recursive) params.set('recursive', 'true'); - if (options.include_abstracts) params.set('include_abstracts', 'true'); - - const response = await this.fetchJson<{ - success: boolean; - data?: LsResponse; - error?: string; - }>(`/api/v2/filesystem/list?${params.toString()}`); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'List directory failed'); - } - - return response.data; - } - - /** - * Smart exploration combining search and browsing - */ - async explore(options: ExploreOptions): Promise { - const response = await this.fetchJson<{ - success: boolean; - data?: ExploreResponse; - error?: string; - }>('/api/v2/filesystem/explore', { - method: 'POST', - body: JSON.stringify({ - query: options.query, - start_uri: options.start_uri ?? 'cortex://session', - return_layers: options.return_layers ?? ['L0'] - }) - }); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Explore failed'); - } - - return response.data; - } - - // ==================== Tiered Access ==================== - - /** - * Get L0 abstract (~100 tokens) for quick relevance check - */ - async getAbstract(uri: string): Promise { - const params = new URLSearchParams(); - params.set('uri', uri); - - const response = await this.fetchJson<{ - success: boolean; - data?: LayerResponse; - error?: string; - }>(`/api/v2/filesystem/abstract?${params.toString()}`); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get abstract failed'); - } - - return response.data; - } - - /** - * Get L1 overview (~2000 tokens) for core information - */ - async getOverview(uri: string): Promise { - const params = new URLSearchParams(); - params.set('uri', uri); - - const response = await this.fetchJson<{ - success: boolean; - data?: LayerResponse; - error?: string; - }>(`/api/v2/filesystem/overview?${params.toString()}`); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get overview failed'); - } - - return response.data; - } - - /** - * Get L2 full content - */ - async getContent(uri: string): Promise { - const params = new URLSearchParams(); - params.set('uri', uri); - - const response = await this.fetchJson<{ - success: boolean; - data?: LayerResponse; - error?: string; - }>(`/api/v2/filesystem/content?${params.toString()}`); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Get content failed'); - } - - return response.data; - } - - // ==================== Session Management ==================== - - /** - * List all sessions - */ - async listSessions(): Promise { - const response = await this.fetchJson<{ - success: boolean; - data?: SessionInfo[]; - error?: string; - }>('/api/v2/sessions'); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'List sessions failed'); - } - - return response.data; - } - - /** - * Add a message to a session - */ - async addMessage(threadId: string, message: AddMessageOptions): Promise { - const response = await this.fetchJson<{ - success: boolean; - data?: string; - error?: string; - }>(`/api/v2/sessions/${threadId}/messages`, { - method: 'POST', - body: JSON.stringify({ - role: message.role ?? 'user', - content: message.content, - metadata: message.metadata - }) - }); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Add message failed'); - } - - return response.data; - } - - /** - * Commit a session and trigger memory extraction - */ - async commitSession(threadId: string): Promise<{ - thread_id: string; - status: string; - message_count: number; - }> { - const response = await this.fetchJson<{ - success: boolean; - data?: { - thread_id: string; - status: string; - message_count: number; - }; - error?: string; - }>(`/api/v2/sessions/${threadId}/close`, { - method: 'POST', - body: JSON.stringify({}) - }); - - if (!response.success || !response.data) { - throw new Error(response.error ?? 'Commit session failed'); - } - - return response.data; - } - - // ==================== Tenant ==================== - - /** - * Switch tenant context - */ - async switchTenant(tenantId: string): Promise { - const response = await this.fetchJson<{ - success: boolean; - error?: string; - }>('/api/v2/tenants/switch', { - method: 'POST', - body: JSON.stringify({ tenant_id: tenantId }) - }); - - if (!response.success) { - throw new Error(response.error ?? 'Switch tenant failed'); - } - } - - // ==================== Internal ==================== - - private async fetchJson( - path: string, - options: RequestInit = {} - ): Promise { - const url = `${this.baseUrl}${path}`; - const headers = { - 'Content-Type': 'application/json', - ...(options.headers || {}) - }; - - const response = await fetch(url, { - ...options, - headers - }); - - if (!response.ok) { - throw new Error(`HTTP ${response.status}: ${response.statusText}`); - } - - return response.json() as Promise; - } -} diff --git a/examples/@memclaw/plugin/src/config.ts b/examples/@memclaw/plugin/src/config.ts deleted file mode 100644 index b9fc124..0000000 --- a/examples/@memclaw/plugin/src/config.ts +++ /dev/null @@ -1,338 +0,0 @@ -/** - * Configuration management for MemClaw - * - * Handles platform-specific config paths, config file generation, - * and auto-opening config files for user editing. - */ - -import * as fs from 'fs'; -import * as path from 'path'; -import * as os from 'os'; -import { spawn } from 'child_process'; -import TOML from 'smol-toml'; - -// Platform-specific paths -export function getDataDir(): string { - const platform = process.platform; - - if (platform === 'win32') { - return path.join( - process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'), - 'memclaw' - ); - } else if (platform === 'darwin') { - return path.join(os.homedir(), 'Library', 'Application Support', 'memclaw'); - } else { - return path.join(os.homedir(), '.local', 'share', 'memclaw'); - } -} - -export function getConfigPath(): string { - return path.join(getDataDir(), 'config.toml'); -} - -export interface MemClawConfig { - qdrant: { - url: string; - collection_name: string; - embedding_dim?: number; - timeout_secs: number; - }; - llm: { - api_base_url: string; - api_key: string; - model_efficient: string; - temperature: number; - max_tokens: number; - }; - embedding: { - api_base_url: string; - api_key: string; - model_name: string; - batch_size: number; - timeout_secs: number; - }; - server: { - host: string; - port: number; - cors_origins?: string[]; - }; - logging: { - enabled: boolean; - log_directory: string; - level: string; - }; - cortex: { - enable_intent_analysis: boolean; - }; -} - -export function generateConfigTemplate(): string { - return `# MemClaw Configuration -# -# This file was auto-generated. Please fill in the required values below. -# All sections are required - missing sections will cause config to be ignored. - -# Qdrant Vector Database Configuration -[qdrant] -url = "http://localhost:6334" -collection_name = "memclaw" -# Embedding dimension (optional, auto-detected if not set) -# For text-embedding-3-small: 1536 -# For text-embedding-3-large: 3072 -# embedding_dim = 1536 -timeout_secs = 30 - -# LLM Configuration [REQUIRED for memory processing] -[llm] -api_base_url = "https://api.openai.com/v1" -api_key = "" -model_efficient = "gpt-5-mini" -temperature = 0.1 -max_tokens = 65536 - -# Embedding Configuration [REQUIRED for vector search] -[embedding] -api_base_url = "https://api.openai.com/v1" -api_key = "" -model_name = "text-embedding-3-small" -batch_size = 10 -timeout_secs = 30 - -# Service Configuration -[server] -host = "localhost" -port = 8085 -cors_origins = ["*"] - -# Logging Configuration -[logging] -enabled = false -log_directory = "logs" -level = "info" - -# Cortex Memory Settings -[cortex] -enable_intent_analysis = false -`; -} - -export function ensureConfigExists(): { created: boolean; path: string } { - const dataDir = getDataDir(); - const configPath = getConfigPath(); - - if (!fs.existsSync(dataDir)) { - fs.mkdirSync(dataDir, { 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 }; -} - -export function openConfigFile(configPath: string): Promise { - return new Promise((resolve, reject) => { - const platform = process.platform; - let command: string; - let args: string[] = []; - - 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 = spawn(command, args, { detached: true, stdio: 'ignore' }); - proc.on('error', (err) => { - reject(err); - }); - proc.unref(); - resolve(); - }); -} - -/** - * Parse TOML config file using smol-toml library - * Supports full TOML syntax including arrays, nested tables, etc. - */ -export function parseConfig(configPath: string): MemClawConfig { - const content = fs.readFileSync(configPath, 'utf-8'); - - // Parse using smol-toml - let parsed: Record; - try { - parsed = TOML.parse(content) as Record; - } catch (error) { - // If parsing fails, return defaults - console.error('Failed to parse config.toml:', error); - parsed = {}; - } - - // Apply defaults for missing sections - return { - qdrant: { - url: 'http://localhost:6334', - collection_name: 'memclaw', - timeout_secs: 30, - ...((parsed.qdrant as Record) || {}) - }, - llm: { - api_base_url: 'https://api.openai.com/v1', - api_key: '', - model_efficient: 'gpt-5-mini', - temperature: 0.1, - max_tokens: 4096, - ...((parsed.llm as Record) || {}) - }, - embedding: { - api_base_url: 'https://api.openai.com/v1', - api_key: '', - model_name: 'text-embedding-3-small', - batch_size: 10, - timeout_secs: 30, - ...((parsed.embedding as Record) || {}) - }, - server: { - host: 'localhost', - port: 8085, - ...((parsed.server as Record) || {}) - }, - logging: { - enabled: false, - log_directory: 'logs', - level: 'info', - ...((parsed.logging as Record) || {}) - }, - cortex: { - enable_intent_analysis: false, - ...((parsed.cortex as Record) || {}) - } - }; -} - -export function validateConfig(config: MemClawConfig): { - valid: boolean; - errors: string[]; -} { - const errors: string[] = []; - - 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 - }; -} - -/** - * Configuration provided by OpenClaw plugin config - * These values will be synced to config.toml if provided - */ -export interface PluginProvidedConfig { - llmApiBaseUrl?: string; - llmApiKey?: string; - llmModel?: string; - embeddingApiBaseUrl?: string; - embeddingApiKey?: string; - embeddingModel?: string; -} - -/** - * Update config.toml with values from OpenClaw plugin config - * Uses smol-toml for proper TOML serialization - */ -export function updateConfigFromPlugin(pluginConfig: PluginProvidedConfig): { - updated: boolean; - path: string; -} { - const configPath = getConfigPath(); - - // Ensure config file exists - ensureConfigExists(); - - // Parse existing config - const existingConfig = parseConfig(configPath); - - // Build updated config - const updatedConfig: MemClawConfig = { - qdrant: existingConfig.qdrant, - llm: { - ...existingConfig.llm, - api_base_url: pluginConfig.llmApiBaseUrl || existingConfig.llm.api_base_url, - api_key: pluginConfig.llmApiKey || existingConfig.llm.api_key, - model_efficient: pluginConfig.llmModel || existingConfig.llm.model_efficient - }, - embedding: { - ...existingConfig.embedding, - api_base_url: pluginConfig.embeddingApiBaseUrl || existingConfig.embedding.api_base_url, - api_key: pluginConfig.embeddingApiKey || existingConfig.embedding.api_key, - model_name: pluginConfig.embeddingModel || existingConfig.embedding.model_name - }, - server: existingConfig.server, - logging: existingConfig.logging, - cortex: existingConfig.cortex - }; - - // Check if any changes were made - const hasChanges = - (pluginConfig.llmApiKey && pluginConfig.llmApiKey !== existingConfig.llm.api_key) || - (pluginConfig.llmApiBaseUrl && pluginConfig.llmApiBaseUrl !== existingConfig.llm.api_base_url) || - (pluginConfig.llmModel && pluginConfig.llmModel !== existingConfig.llm.model_efficient) || - (pluginConfig.embeddingApiKey && pluginConfig.embeddingApiKey !== existingConfig.embedding.api_key) || - (pluginConfig.embeddingApiBaseUrl && pluginConfig.embeddingApiBaseUrl !== existingConfig.embedding.api_base_url) || - (pluginConfig.embeddingModel && pluginConfig.embeddingModel !== existingConfig.embedding.model_name); - - if (!hasChanges) { - return { updated: false, path: configPath }; - } - - // Serialize and write using smol-toml - const tomlContent = TOML.stringify(updatedConfig as unknown as Record); - fs.writeFileSync(configPath, tomlContent, 'utf-8'); - - return { updated: true, path: configPath }; -} - -/** - * Merge plugin config with file config, preferring plugin config values - */ -export function mergeConfigWithPlugin( - fileConfig: MemClawConfig, - pluginConfig: PluginProvidedConfig -): MemClawConfig { - return { - ...fileConfig, - llm: { - ...fileConfig.llm, - api_base_url: pluginConfig.llmApiBaseUrl || fileConfig.llm.api_base_url, - api_key: pluginConfig.llmApiKey || fileConfig.llm.api_key, - model_efficient: pluginConfig.llmModel || fileConfig.llm.model_efficient - }, - embedding: { - ...fileConfig.embedding, - api_base_url: pluginConfig.embeddingApiBaseUrl || fileConfig.embedding.api_base_url, - api_key: pluginConfig.embeddingApiKey || fileConfig.embedding.api_key, - model_name: pluginConfig.embeddingModel || fileConfig.embedding.model_name - } - }; -} diff --git a/examples/@memclaw/plugin/src/migrate.ts b/examples/@memclaw/plugin/src/migrate.ts deleted file mode 100644 index 11e8c2a..0000000 --- a/examples/@memclaw/plugin/src/migrate.ts +++ /dev/null @@ -1,345 +0,0 @@ -/** - * Migration script for OpenClaw native memory to MemClaw - * - * Migrates: - * - memory/YYYY-MM-DD.md → session timeline files - * - MEMORY.md → users/{tenant}/preferences.md - */ - -import * as fs from 'fs'; -import * as path from 'path'; -import * as os from 'os'; -import { exec } from 'child_process'; -import { promisify } from 'util'; -import { glob } from 'glob'; -import { getDataDir, getConfigPath } from './config.js'; -import { getCliPath } from './binaries.js'; - -const execAsync = promisify(exec); - -// Migration configuration -const MIGRATION_TENANT = 'tenant_claw'; -const DEFAULT_ROLE = 'user'; - -interface MigrationResult { - dailyLogsMigrated: number; - memoryMdMigrated: boolean; - sessionsCreated: string[]; - errors: string[]; -} - -/** - * Detect OpenClaw workspace directory - */ -function findOpenClawWorkspace(): string | null { - 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: string): string[] { - 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: string, - sessionId: string, - date: string, - index: number -): string { - // 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: string, - dataDir: string, - log?: (msg: string) => void -): Promise<{ count: number; sessions: string[]; errors: string[] }> { - const memoryDir = path.join(ocWorkspace, 'memory'); - const count = 0; - const sessions: string[] = []; - const errors: string[] = []; - - 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 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}`; - - // Correct path for tenant isolation: - // dataDir/tenants/{tenant_id}/session/{session_id}/timeline/{year}/{month}/{day}/ - const timelineDir = path.join( - dataDir, - 'tenants', - MIGRATION_TENANT, - 'session', - 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: string, - dataDir: string, - log?: (msg: string) => void -): Promise<{ migrated: boolean; error?: string }> { - const memoryMdPath = path.join(ocWorkspace, 'MEMORY.md'); - - if (!fs.existsSync(memoryMdPath)) { - log?.('No MEMORY.md found'); - return { migrated: false }; - } - - try { - // Correct path for tenant isolation: - // dataDir/tenants/{tenant_id}/user/preferences.md - const userDir = path.join(dataDir, 'tenants', MIGRATION_TENANT, 'user'); - 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 = ` -${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: string, - tenant: string, - log?: (msg: string) => void -): Promise { - log?.('Generating L0/L1 layers...'); - - const cliPath = 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: string, - tenant: string, - log?: (msg: string) => void -): Promise { - log?.('Generating vector index...'); - - const cliPath = 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 - */ -export async function migrateFromOpenClaw( - log?: (msg: string) => void -): Promise { - const result: MigrationResult = { - 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 = getDataDir(); - const configPath = 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 - */ -export function canMigrate(): { possible: boolean; reason: string } { - 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' }; -} diff --git a/examples/@memclaw/plugin/tsconfig.json b/examples/@memclaw/plugin/tsconfig.json deleted file mode 100644 index 9ae9ae6..0000000 --- a/examples/@memclaw/plugin/tsconfig.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "compilerOptions": { - "target": "ES2022", - "module": "NodeNext", - "moduleResolution": "NodeNext", - "lib": ["ES2022", "ES2022.Error", "ES2022.Object", "ES2022.String"], - "types": ["node"], - "outDir": "./dist", - "rootDir": ".", - "strict": true, - "esModuleInterop": true, - "skipLibCheck": true, - "forceConsistentCasingInFileNames": true, - "declaration": true, - "declarationMap": true, - "sourceMap": true, - "resolveJsonModule": true - }, - "include": [ - "index.ts", - "plugin-impl.ts", - "src/**/*.ts" - ], - "exclude": [ - "node_modules", - "dist" - ] -} diff --git "a/examples/\347\253\236\345\223\201\351\241\271\347\233\256\346\272\220\347\240\201 - OpenViking" "b/examples/\347\253\236\345\223\201\351\241\271\347\233\256\346\272\220\347\240\201 - OpenViking" new file mode 160000 index 0000000..fe778d8 --- /dev/null +++ "b/examples/\347\253\236\345\223\201\351\241\271\347\233\256\346\272\220\347\240\201 - OpenViking" @@ -0,0 +1 @@ +Subproject commit fe778d8f806c9b8124f534554e7c168ace757deb