openclaw-plugin-memory-engine 4.0.0 → 4.0.1
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 +25 -31
- package/openclaw.plugin.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,48 +1,42 @@
|
|
|
1
|
-
# Memory Engine
|
|
1
|
+
# Memory Engine — OpenClaw Plugin
|
|
2
2
|
|
|
3
|
-
Native memory engine for OpenClaw:
|
|
4
|
-
|
|
3
|
+
Native memory engine for OpenClaw: **45 agent tools**, event-driven session ingest,
|
|
4
|
+
semantic search, backup/import/export, learning, a conservative curator, and a
|
|
5
|
+
native Control UI page — all in one plugin, no external MCP server.
|
|
6
|
+
|
|
7
|
+
Successor of the Python `memory-engine` MCP server (same versioning lineage).
|
|
5
8
|
|
|
6
9
|
## Features
|
|
7
10
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
- **
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
- **
|
|
16
|
-
- **
|
|
17
|
-
ingests `session_msg` atoms and generates/refreshes `session_digest` atoms (7-day TTL)
|
|
11
|
+
**45 memory tools:**
|
|
12
|
+
- **Core**: recall (FTS + ranking, optional semantic merge), working_set (token-budgeted context pack), remember, get_atom, list_atoms, stats, memory_summary
|
|
13
|
+
- **Knowledge graph**: link, search_graph, contradict, impact, suggest_bonds(+all), find_similar
|
|
14
|
+
- **Curator**: memory_curator_run — conservative maintenance (extractive body_compact, auto-bonds by domain/keyword/pattern, isolated atom classification, promotion and merge candidates). Dry-run by default. memory_cognitive_status for graph health metrics
|
|
15
|
+
- **Semantic** (Ollama): semantic_search with FTS fallback, reindex_embeddings, optional `semantic:true` on recall
|
|
16
|
+
- **Maintenance**: decay_run, cleanup_sessions, cleanup_duplicates, merge_atoms, delete_atom (soft by default), unlink, update_domain, classify_memory_tier
|
|
17
|
+
- **Backup**: backup_database, restore_database (confirm required), list_backups, export_all, export_atom, import_data, import_markdown
|
|
18
|
+
- **Learning**: learning_run, ask_pending, answer_human (human_questions flow)
|
|
19
|
+
- **Errors**: error_check, error_log, error_list, list_contradictions, preference_search
|
|
18
20
|
|
|
19
|
-
|
|
21
|
+
**Native Control UI page** (5 tabs): live cognitive stats, FTS atom search with type/domain filters, atom detail with bonds, curator dry-run/apply, backup management, pending human questions with inline answers.
|
|
20
22
|
|
|
21
|
-
|
|
22
|
-
openclaw plugins install memory-engine-ts
|
|
23
|
-
```
|
|
23
|
+
**Event hooks**: buffers chat messages and periodically (60s, only when changed) ingests `session_msg` atoms and refreshes `session_digest` atoms (7-day TTL).
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
## Install
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
openclaw plugins install
|
|
28
|
+
openclaw plugins install clawhub:openclaw-plugin-memory-engine
|
|
29
|
+
# or from npm
|
|
30
|
+
openclaw plugins install npm:openclaw-plugin-memory-engine
|
|
29
31
|
```
|
|
30
32
|
|
|
31
33
|
## Configuration
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
Curator tuning (optional) via plugin config `curator`: max_atoms_per_run,
|
|
38
|
-
compact_min_body_chars, bond_limit_per_atom, stale_after_days and more —
|
|
39
|
-
sensible defaults apply.
|
|
40
|
-
|
|
41
|
-
## Session hooks
|
|
35
|
+
- `MEMORY_DB_PATH` — SQLite database path (default `/data/memory.db`, schema created on first use)
|
|
36
|
+
- `OLLAMA_HOST` — Ollama base URL for embeddings (default `http://ollama:11434`)
|
|
37
|
+
- `ME_EMBED_MODEL` — embedding model (default `nomic-embed-text`)
|
|
42
38
|
|
|
43
|
-
|
|
44
|
-
- every 60s: ingest new messages as episodic `session_msg` atoms (7-day TTL)
|
|
45
|
-
and refresh the session digest atom
|
|
39
|
+
Enable the plugin UI page once via **Control UI → Settings → Labs → Custom plugin UI**.
|
|
46
40
|
|
|
47
41
|
## License
|
|
48
42
|
|
package/openclaw.plugin.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"id": "memory-engine",
|
|
3
3
|
"name": "Memory Engine",
|
|
4
4
|
"description": "Native Memory Engine: 45 memory tools, session ingest/digest, curator and Control UI.",
|
|
5
|
-
"version": "4.0.
|
|
5
|
+
"version": "4.0.1",
|
|
6
6
|
"configSchema": {
|
|
7
7
|
"type": "object",
|
|
8
8
|
"additionalProperties": false,
|