@bamdra/bamdra-openclaw-memory 0.3.4 → 0.3.5
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/dist/package.json +3 -3
- package/package.json +8 -7
- package/skills/bamdra-memory-operator/SKILL.md +37 -5
- package/LICENSE +0 -21
package/dist/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bamdra/bamdra-openclaw-memory",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.5",
|
|
4
4
|
"description": "Unified topic-aware memory plugin for OpenClaw with durable SQLite recall and bounded context growth.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://www.bamdra.com",
|
|
@@ -59,8 +59,8 @@
|
|
|
59
59
|
}
|
|
60
60
|
},
|
|
61
61
|
"dependencies": {
|
|
62
|
-
"@bamdra/bamdra-user-bind": "^0.1.
|
|
63
|
-
"@bamdra/bamdra-memory-vector": "^0.1.
|
|
62
|
+
"@bamdra/bamdra-user-bind": "^0.1.2",
|
|
63
|
+
"@bamdra/bamdra-memory-vector": "^0.1.2"
|
|
64
64
|
},
|
|
65
65
|
"devDependencies": {
|
|
66
66
|
"@types/node": "^24.5.2"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bamdra/bamdra-openclaw-memory",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.5",
|
|
4
4
|
"description": "Unified topic-aware memory plugin for OpenClaw with durable SQLite recall and bounded context growth.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://www.bamdra.com",
|
|
@@ -32,6 +32,10 @@
|
|
|
32
32
|
"engines": {
|
|
33
33
|
"node": ">=22"
|
|
34
34
|
},
|
|
35
|
+
"scripts": {
|
|
36
|
+
"bundle": "node ../../scripts/run-local-bin.mjs tsup && cp ../../packages/memory-sqlite/src/schema.sql ./dist/ && node ../../scripts/prepare-plugin-dist.mjs bamdra-openclaw-memory",
|
|
37
|
+
"prepublishOnly": "pnpm run bundle"
|
|
38
|
+
},
|
|
35
39
|
"openclaw": {
|
|
36
40
|
"id": "bamdra-openclaw-memory",
|
|
37
41
|
"type": "context-engine",
|
|
@@ -55,13 +59,10 @@
|
|
|
55
59
|
}
|
|
56
60
|
},
|
|
57
61
|
"dependencies": {
|
|
58
|
-
"@bamdra/bamdra-user-bind": "^0.1.
|
|
59
|
-
"@bamdra/bamdra-memory-vector": "^0.1.
|
|
62
|
+
"@bamdra/bamdra-user-bind": "^0.1.2",
|
|
63
|
+
"@bamdra/bamdra-memory-vector": "^0.1.2"
|
|
60
64
|
},
|
|
61
65
|
"devDependencies": {
|
|
62
66
|
"@types/node": "^24.5.2"
|
|
63
|
-
},
|
|
64
|
-
"scripts": {
|
|
65
|
-
"bundle": "node ../../scripts/run-local-bin.mjs tsup && cp ../../packages/memory-sqlite/src/schema.sql ./dist/ && node ../../scripts/prepare-plugin-dist.mjs bamdra-openclaw-memory"
|
|
66
67
|
}
|
|
67
|
-
}
|
|
68
|
+
}
|
|
@@ -9,6 +9,8 @@ Use `bamdra-memory` tools to preserve continuity without making the conversation
|
|
|
9
9
|
|
|
10
10
|
This skill is an optional behavior layer. It improves tool judgment, but the runtime memory chain must still be provided by the plugin itself.
|
|
11
11
|
|
|
12
|
+
Treat `bamdra-user-bind` as the primary user personalization layer. In practice it should cover most of what a per-user `USER.md` file would normally do: preferred address, long-lived preferences, role, personality notes, and other stable profile traits for the current bound user.
|
|
13
|
+
|
|
12
14
|
## Operating Goal
|
|
13
15
|
|
|
14
16
|
Make memory feel natural:
|
|
@@ -18,6 +20,7 @@ Make memory feel natural:
|
|
|
18
20
|
- recover prior context quietly when it helps
|
|
19
21
|
- avoid leaking unrelated memory into the current answer
|
|
20
22
|
- avoid narrating internal storage mechanics unless the user asks
|
|
23
|
+
- personalize tone and defaults from the bound user profile when that improves the response
|
|
21
24
|
|
|
22
25
|
## Decision Policy
|
|
23
26
|
|
|
@@ -31,6 +34,7 @@ Prefer memory tools when one of these is true:
|
|
|
31
34
|
- the conversation appears to branch into a new thread
|
|
32
35
|
- the answer may already exist in memory
|
|
33
36
|
- the user explicitly asks to keep topics separate, resume an older branch, or start fresh
|
|
37
|
+
- the answer should adapt to a stable user preference or role that is likely already in the bound profile
|
|
34
38
|
|
|
35
39
|
Do not reach for memory tools when one of these is true:
|
|
36
40
|
|
|
@@ -38,6 +42,26 @@ Do not reach for memory tools when one of these is true:
|
|
|
38
42
|
- the user is casually brainstorming and has not signaled that a detail should persist
|
|
39
43
|
- using a tool would add noise without improving continuity or accuracy
|
|
40
44
|
- the request would cross agent or user boundaries that should remain isolated
|
|
45
|
+
- the profile signal is already sufficient and an extra memory lookup would only add noise
|
|
46
|
+
|
|
47
|
+
## User Profile Policy
|
|
48
|
+
|
|
49
|
+
Treat the bound user profile as the first personalization source for the current user.
|
|
50
|
+
|
|
51
|
+
Use it for:
|
|
52
|
+
|
|
53
|
+
- preferred form of address
|
|
54
|
+
- stable output preferences such as tone, structure, formatting, or brevity
|
|
55
|
+
- role-aware defaults such as whether to optimize for management summaries, technical detail, or documentation quality
|
|
56
|
+
- personality or collaboration style cues when they improve phrasing
|
|
57
|
+
|
|
58
|
+
Do not use it for:
|
|
59
|
+
|
|
60
|
+
- making up facts that are not actually present in the bound profile
|
|
61
|
+
- inferring private details about other users
|
|
62
|
+
- overriding an explicit instruction the user gives in the current turn
|
|
63
|
+
|
|
64
|
+
If the current turn conflicts with the stored profile, follow the current turn and let later updates refresh the profile deliberately.
|
|
41
65
|
|
|
42
66
|
## Topic Judgment
|
|
43
67
|
|
|
@@ -63,11 +87,17 @@ When uncertain:
|
|
|
63
87
|
|
|
64
88
|
## Tool Selection
|
|
65
89
|
|
|
66
|
-
- Use `
|
|
67
|
-
- Use `
|
|
68
|
-
- Use `
|
|
69
|
-
- Use `
|
|
70
|
-
- Use `
|
|
90
|
+
- Use `bamdra_memory_save_fact` for stable facts the user is likely to expect later.
|
|
91
|
+
- Use `bamdra_memory_search` before asking the user to restate a stable fact or prior decision.
|
|
92
|
+
- Use `bamdra_memory_list_topics` when you need to inspect available branches before switching.
|
|
93
|
+
- Use `bamdra_memory_switch_topic` when the user clearly wants to move to, resume, or isolate a branch.
|
|
94
|
+
- Use `bamdra_memory_compact_topic` after a branch has materially changed and its summary is stale.
|
|
95
|
+
|
|
96
|
+
If `bamdra-memory-vector` is enabled, treat `bamdra_memory_search` as a hybrid recall entrypoint rather than a pure keyword lookup. Use it especially when:
|
|
97
|
+
|
|
98
|
+
- the user references something fuzzily
|
|
99
|
+
- the user says “之前提过”, “你还记得吗”, “知识库里有没有”
|
|
100
|
+
- the answer may live in shared Markdown knowledge, not only session memory
|
|
71
101
|
|
|
72
102
|
## Privacy And Isolation
|
|
73
103
|
|
|
@@ -75,6 +105,7 @@ When uncertain:
|
|
|
75
105
|
- Respect user isolation. Do not retrieve or reveal information outside the current user/session boundary.
|
|
76
106
|
- Do not surface unrelated facts from memory just because they were found.
|
|
77
107
|
- If memory retrieval feels privacy-sensitive or contextually risky, narrow the search or answer conservatively.
|
|
108
|
+
- Treat `bamdra-user-bind` profile data as private-by-default user context, not as a global team directory.
|
|
78
109
|
|
|
79
110
|
## Working Style
|
|
80
111
|
|
|
@@ -82,3 +113,4 @@ When uncertain:
|
|
|
82
113
|
- Mention it briefly only when it helps the user trust continuity.
|
|
83
114
|
- Use normal conversational language rather than tool narration.
|
|
84
115
|
- Do not explain topic IDs, database actions, or storage internals unless asked.
|
|
116
|
+
- Let personalization feel natural. The user should experience it as “you remembered me”, not as “you loaded my profile record”.
|
package/LICENSE
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|