@memclaw/memclaw 0.9.16 → 0.9.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -36
- package/dist/index.js +1 -1
- package/dist/plugin-impl.d.ts +4 -1
- package/dist/plugin-impl.d.ts.map +1 -1
- package/dist/plugin-impl.js +396 -77
- package/dist/plugin-impl.js.map +1 -1
- package/dist/src/client.d.ts +85 -42
- package/dist/src/client.d.ts.map +1 -1
- package/dist/src/client.js +138 -80
- package/dist/src/client.js.map +1 -1
- package/dist/src/config.d.ts.map +1 -1
- package/dist/src/config.js +1 -0
- package/dist/src/config.js.map +1 -1
- package/openclaw.plugin.json +1 -1
- package/package.json +1 -1
- package/skills/memclaw/SKILL.md +186 -68
- package/skills/memclaw/references/best-practices.md +195 -272
- package/skills/memclaw/references/memory-structure.md +160 -0
- package/skills/memclaw/references/security.md +31 -0
- package/skills/memclaw/references/tools.md +243 -122
- package/skills/memclaw-maintance/SKILL.md +73 -36
- package/skills/memclaw-maintance/references/tools.md +10 -148
- package/skills/lagacy/SKILL.md +0 -239
- package/skills/lagacy/references/maintenance.md +0 -110
- package/skills/lagacy/references/setup.md +0 -283
- package/skills/lagacy/references/tools.md +0 -170
package/dist/src/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH,gCAaC;AAED,sCAEC;AAoCD,
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}
|
package/openclaw.plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "memclaw",
|
|
3
3
|
"name": "MemClaw",
|
|
4
|
-
"version": "0.9.
|
|
4
|
+
"version": "0.9.18",
|
|
5
5
|
"description": "Layered semantic memory for OpenClaw with L0/L1/L2 tiered retrieval, easy setup, and migration from native memory",
|
|
6
6
|
"kind": "memory",
|
|
7
7
|
"skills": ["skills/memclaw", "skills/memclaw-maintance"],
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@memclaw/memclaw",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.18",
|
|
4
4
|
"description": "MemClaw - The Cortex Memory plugin for OpenClaw. Layered semantic memory for OpenClaw with easy setup and migration",
|
|
5
5
|
"homepage": "https://github.com/sopaco/cortex-mem",
|
|
6
6
|
"repository": {
|
package/skills/memclaw/SKILL.md
CHANGED
|
@@ -7,108 +7,226 @@ description: MemClaw — Advanced Semantic Memory System for OpenClaw. Uses L0/L
|
|
|
7
7
|
|
|
8
8
|
> **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.
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## Overview
|
|
11
|
+
> 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).
|
|
12
|
+
|
|
13
|
+
MemClaw provides OpenClaw with a powerful memory system that goes beyond simple storage:
|
|
14
|
+
|
|
15
|
+
- **Three-Layer Architecture**: L0 (Abstract ~100 tokens) → L1 (Overview ~2000 tokens) → L2 (Full Content)
|
|
16
|
+
- **Dual Access Paradigm**: Semantic search + Direct memory virtual-filesystem(in security sandbox) browsing
|
|
17
|
+
- **Token Efficiency**: Retrieve only what you need, when you need it
|
|
18
|
+
- **Automatic Processing**: Memory extraction and layer generation happens automatically
|
|
11
19
|
|
|
12
20
|
## Security & Trust
|
|
13
21
|
|
|
14
|
-
|
|
15
|
-
- Stores memory data in the local user data directory
|
|
16
|
-
- Based on advanced Cortex Memory technology, providing outstanding memory management capabilities with high performance and accuracy.
|
|
17
|
-
- Only reads existing OpenClaw memory files during migration
|
|
22
|
+
See [security.md](./references/security.md) for details on data handling, storage locations, and API key security.
|
|
18
23
|
|
|
19
|
-
|
|
20
|
-
- Does NOT send data to external servers (all processing is local)
|
|
21
|
-
- Does NOT transmit API keys to anywhere other than your configured LLM/embedding provider
|
|
24
|
+
## Configuration
|
|
22
25
|
|
|
23
|
-
|
|
26
|
+
All configuration is managed through OpenClaw plugin settings. However, when the plugin is first used, incomplete configuration items may cause it to fail. If the plugin or tools cannot be used, proactively inform the user and assist in completing the necessary configurations. For details, refer to the 'Troubleshooting' section in the skill of `memclaw-maintance`.
|
|
24
27
|
|
|
25
|
-
|
|
28
|
+
## Tool Selection Guide
|
|
26
29
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
30
|
+
```
|
|
31
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
32
|
+
│ How to Access Memories │
|
|
33
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
34
|
+
│ │
|
|
35
|
+
│ Do you know WHERE the information is? │
|
|
36
|
+
│ │ │
|
|
37
|
+
│ ├── YES ──► Use Direct Tiered Access │
|
|
38
|
+
│ │ cortex_ls → cortex_get_abstract/overview/content│
|
|
39
|
+
│ │ │
|
|
40
|
+
│ └── NO ──► Do you know WHAT you're looking for? │
|
|
41
|
+
│ │ │
|
|
42
|
+
│ ├── YES ──► Use Semantic Search │
|
|
43
|
+
│ │ cortex_search │
|
|
44
|
+
│ │ │
|
|
45
|
+
│ └── NO ──► Use Exploration │
|
|
46
|
+
│ cortex_explore │
|
|
47
|
+
│ │
|
|
48
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
49
|
+
```
|
|
32
50
|
|
|
33
|
-
|
|
51
|
+
## Core Tools
|
|
34
52
|
|
|
35
|
-
|
|
53
|
+
### 1. Semantic Search
|
|
36
54
|
|
|
37
|
-
|
|
55
|
+
#### `cortex_search`
|
|
56
|
+
Layered semantic search with fine-grained control over returned content.
|
|
38
57
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
3. Verify or update the required fields
|
|
42
|
-
4. Save changes and **restart OpenClaw Gateway** for changes to take effect
|
|
58
|
+
**Key Parameters:**
|
|
59
|
+
- `return_layers`: `["L0"]` (default, ~100 tokens), `["L0","L1"]` (~2100 tokens), `["L0","L1","L2"]` (full)
|
|
43
60
|
|
|
44
|
-
|
|
61
|
+
**Examples:**
|
|
62
|
+
```
|
|
63
|
+
# Quick search, minimal tokens
|
|
64
|
+
cortex_search(query="project decisions", return_layers=["L0"])
|
|
45
65
|
|
|
46
|
-
|
|
66
|
+
# Need more context
|
|
67
|
+
cortex_search(query="API design preferences", return_layers=["L0","L1"])
|
|
47
68
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
| Need more context | `cortex_recall` |
|
|
52
|
-
| Save important information | `cortex_add_memory` |
|
|
53
|
-
| Complete a task/topic | `cortex_close_session` |
|
|
54
|
-
| First-time use with existing memories | `cortex_migrate` |
|
|
69
|
+
# Full content retrieval
|
|
70
|
+
cortex_search(query="exact code implementation", return_layers=["L0","L1","L2"])
|
|
71
|
+
```
|
|
55
72
|
|
|
56
|
-
|
|
73
|
+
#### `cortex_recall`
|
|
74
|
+
Convenience wrapper that returns both abstract and full content.
|
|
75
|
+
Equivalent to `cortex_search(return_layers=["L0","L2"])`.
|
|
57
76
|
|
|
58
|
-
###
|
|
77
|
+
### 2. Memory Virtual Filesystem Browsing
|
|
59
78
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
3. **Suggested rhythm**: Once after each major topic is completed
|
|
79
|
+
#### `cortex_ls`
|
|
80
|
+
List directory contents to explore memory structure.
|
|
63
81
|
|
|
64
|
-
|
|
82
|
+
**Key Parameters:**
|
|
83
|
+
- `recursive`: Recursively list subdirectories
|
|
84
|
+
- `include_abstracts`: Show L0 abstracts for quick preview
|
|
65
85
|
|
|
66
|
-
**
|
|
67
|
-
```
|
|
68
|
-
|
|
86
|
+
**Examples:**
|
|
87
|
+
```
|
|
88
|
+
# List all sessions
|
|
89
|
+
cortex_ls(uri="cortex://session")
|
|
90
|
+
|
|
91
|
+
# Browse a specific session
|
|
92
|
+
cortex_ls(uri="cortex://session/abc123")
|
|
93
|
+
|
|
94
|
+
# Recursive listing with abstracts
|
|
95
|
+
cortex_ls(uri="cortex://session", recursive=true, include_abstracts=true)
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### 3. Tiered Access
|
|
99
|
+
|
|
100
|
+
#### `cortex_get_abstract` (L0)
|
|
101
|
+
Get ~100 token summary for quick relevance check.
|
|
102
|
+
|
|
103
|
+
#### `cortex_get_overview` (L1)
|
|
104
|
+
Get ~2000 token overview with key information.
|
|
105
|
+
|
|
106
|
+
#### `cortex_get_content` (L2)
|
|
107
|
+
Get full original content.
|
|
108
|
+
|
|
109
|
+
**Workflow:**
|
|
110
|
+
```
|
|
111
|
+
1. cortex_ls("cortex://session/{session_id}/timeline")
|
|
112
|
+
2. cortex_get_abstract("cortex://session/{session_id}/timeline/2024-01-15_001.md") # Quick check
|
|
113
|
+
3. If relevant → cortex_get_overview(...) # More context
|
|
114
|
+
4. If needed → cortex_get_content(...) # Full details
|
|
69
115
|
```
|
|
70
116
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
117
|
+
### 4. Smart Exploration
|
|
118
|
+
|
|
119
|
+
#### `cortex_explore`
|
|
120
|
+
Combines search and browsing for guided discovery.
|
|
121
|
+
|
|
122
|
+
**Example:**
|
|
123
|
+
```
|
|
124
|
+
cortex_explore(
|
|
125
|
+
query="authentication flow",
|
|
126
|
+
start_uri="cortex://session/{session_id}",
|
|
127
|
+
return_layers=["L0"]
|
|
128
|
+
)
|
|
74
129
|
```
|
|
75
130
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
131
|
+
Returns both an exploration path (showing relevance scores) and matching results.
|
|
132
|
+
|
|
133
|
+
### 5. Memory Storage
|
|
134
|
+
|
|
135
|
+
#### `cortex_add_memory`
|
|
136
|
+
Store a message with optional metadata.
|
|
137
|
+
|
|
138
|
+
**Parameters:**
|
|
139
|
+
- `content`: The message content
|
|
140
|
+
- `role`: `"user"`, `"assistant"`, or `"system"`
|
|
141
|
+
- `metadata`: Optional tags, importance, custom fields
|
|
142
|
+
|
|
143
|
+
**Example:**
|
|
144
|
+
```
|
|
145
|
+
cortex_add_memory(
|
|
146
|
+
content="User prefers TypeScript with strict mode enabled",
|
|
147
|
+
role="assistant",
|
|
148
|
+
metadata={"tags": ["preference", "typescript"], "importance": "high"}
|
|
149
|
+
)
|
|
79
150
|
```
|
|
80
151
|
|
|
81
|
-
|
|
152
|
+
#### `cortex_close_session`
|
|
153
|
+
Trigger memory extraction pipeline.
|
|
154
|
+
|
|
155
|
+
**IMPORTANT:** Call this periodically, not just at conversation end.
|
|
156
|
+
|
|
157
|
+
**When to call:**
|
|
158
|
+
- After completing a significant task
|
|
159
|
+
- After user shares important preferences
|
|
160
|
+
- When conversation topic shifts
|
|
161
|
+
- Every 10-20 exchanges
|
|
82
162
|
|
|
83
|
-
|
|
163
|
+
## Best Practices
|
|
84
164
|
|
|
85
|
-
###
|
|
165
|
+
### Token Optimization
|
|
86
166
|
|
|
87
|
-
|
|
167
|
+
```
|
|
168
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
169
|
+
│ Layer │ Tokens │ Use Case │
|
|
170
|
+
├───────┼─────────┼───────────────────────────────────────────┤
|
|
171
|
+
│ L0 │ ~100 │ Quick relevance check, filtering │
|
|
172
|
+
│ L1 │ ~2000 │ Understanding gist, moderate detail │
|
|
173
|
+
│ L2 │ Full │ Exact quotes, complete implementation │
|
|
174
|
+
└───────┴─────────┴───────────────────────────────────────────┘
|
|
175
|
+
|
|
176
|
+
Recommended workflow:
|
|
177
|
+
1. Start with L0 (cortex_search or cortex_get_abstract)
|
|
178
|
+
2. Use L1 if L0 is relevant (cortex_get_overview)
|
|
179
|
+
3. Use L2 only when necessary (cortex_get_content)
|
|
180
|
+
```
|
|
88
181
|
|
|
89
|
-
|
|
90
|
-
2. Ensure all required fields are correctly filled, especially the configuration sections related to LLM and Embedding.
|
|
91
|
-
3. Save the configuration file
|
|
182
|
+
### When to Use Each Tool
|
|
92
183
|
|
|
93
|
-
|
|
184
|
+
| Scenario | Tool |
|
|
185
|
+
|----------|------|
|
|
186
|
+
| Find information across all sessions | `cortex_search` |
|
|
187
|
+
| Browse memory structure | `cortex_ls` |
|
|
188
|
+
| Check if specific URI is relevant | `cortex_get_abstract` |
|
|
189
|
+
| Get more details on relevant URI | `cortex_get_overview` |
|
|
190
|
+
| Need exact content | `cortex_get_content` |
|
|
191
|
+
| Explore with purpose | `cortex_explore` |
|
|
192
|
+
| Store new information | `cortex_add_memory` |
|
|
193
|
+
| Trigger memory processing | `cortex_close_session` |
|
|
194
|
+
|
|
195
|
+
### Common Patterns
|
|
196
|
+
|
|
197
|
+
#### Pattern 1: Search → Refine
|
|
198
|
+
```
|
|
199
|
+
1. cortex_search(query="user preferences", return_layers=["L0"])
|
|
200
|
+
2. Identify relevant URIs from results
|
|
201
|
+
3. cortex_get_overview(uri="most_relevant_uri") for more context
|
|
202
|
+
```
|
|
94
203
|
|
|
95
|
-
|
|
204
|
+
#### Pattern 2: Browse → Access
|
|
205
|
+
```
|
|
206
|
+
1. cortex_ls(uri="cortex://session")
|
|
207
|
+
2. cortex_ls(uri="cortex://session/{session_id}/timeline", include_abstracts=true)
|
|
208
|
+
3. cortex_get_content(uri="interesting_file") for full details
|
|
209
|
+
```
|
|
96
210
|
|
|
97
|
-
|
|
211
|
+
#### Pattern 3: Explore → Match
|
|
212
|
+
```
|
|
213
|
+
1. cortex_explore(query="database schema", start_uri="cortex://session/{session_id}")
|
|
214
|
+
2. Review exploration_path for relevance scores
|
|
215
|
+
3. Use matches with requested layers
|
|
216
|
+
```
|
|
98
217
|
|
|
99
|
-
|
|
100
|
-
- Run `cortex_list_sessions` to check if the service is responding
|
|
101
|
-
- Check if Qdrant and cortex-mem-service are running (auto-start should handle this)
|
|
218
|
+
## Memory Structure
|
|
102
219
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
220
|
+
See [memory-structure.md](./references/memory-structure.md) for complete documentation of:
|
|
221
|
+
- URI structure and dimensions
|
|
222
|
+
- Three-layer architecture (L0/L1/L2)
|
|
223
|
+
- Session memory and timeline organization
|
|
224
|
+
- User and agent memory categories
|
|
225
|
+
- session_id configuration
|
|
108
226
|
|
|
109
227
|
## References
|
|
110
228
|
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
229
|
+
- [tools.md](./references/tools.md) - Detailed tool documentation
|
|
230
|
+
- [best-practices.md](./references/best-practices.md) - Advanced patterns
|
|
231
|
+
- [security.md](./references/security.md) - Security and trust information
|
|
232
|
+
- [memory-structure.md](./references/memory-structure.md) - Complete memory structure documentation
|