@octamem/octamem-openclaw 1.0.0 → 1.0.3

package/README.md

@@ -9,11 +9,7 @@ OctaMem personal memory plugin for [OpenClaw](https://openclaw.ai). Adds search/
 
 ## Install
 
-```bash
-npm install @octamem/octamem-openclaw
-```
-
-Or from the OpenClaw plugins list:
+From the OpenClaw plugins list:
 
 ```bash
 openclaw plugins install @octamem/octamem-openclaw
@@ -42,6 +38,21 @@ Restart OpenClaw after configuring.
 - **Tools**: `octamem_get` (search) and `octamem_add` (add) for the agent to query or store memory when needed.
 - **CLI**: `openclaw octamem status | search <query> | details | add <content>`.
 
+## Use only OctaMem (disable local/file memory)
+
+**`openclaw octamem configure`** automatically adds `tools.deny: ["memory_search", "memory_get"]` to your OpenClaw config so only OctaMem is used (no core/file memory). No manual config edit needed.
+
+If you ever need to set it yourself, add to `~/.openclaw/openclaw.json` under `"tools"`:
+
+```json
+"tools": {
+  "profile": "coding",
+  "deny": ["memory_search", "memory_get"]
+}
+```
+
+Restart OpenClaw after changing config.
+
 ## Config (optional)
 
 In OpenClaw plugin config you can set:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@octamem/octamem-openclaw",
-	"version": "1.0.0",
+	"version": "1.0.3",
 	"type": "module",
 	"description": "OctaMem personal memory plugin for OpenClaw",
 	"license": "MIT",

package/src/index.ts

@@ -26,7 +26,7 @@ function memoryUnavailable(reason: string) {
 
 const MAX_MEMORY_SECTION_LEN = 1200
 
-/** Formats API memory response as readable text for prependContext (no raw JSON). */
+/** Formats API memory response as readable text (used only for CLI/tool display). */
 function formatMemoryBlock(raw: unknown): string {
 	const data = raw && typeof raw === "object" && "data" in (raw as object)
 		? (raw as { data?: Record<string, unknown> }).data
@@ -45,6 +45,16 @@ function formatMemoryBlock(raw: unknown): string {
 	return lines.length ? lines.join("\n\n") : "No memory data."
 }
 
+/** True when OctaMem data has no memory content (semantic/episodic/procedural all empty). */
+function isMemoryDataEmpty(data: Record<string, unknown>): boolean {
+	const s = (v: unknown) => (typeof v === "string" ? v : v != null ? String(v) : "").trim()
+	return (
+		!s((data as Record<string, unknown>).semantic_memory) &&
+		!s((data as Record<string, unknown>).episodic_memory) &&
+		!s((data as Record<string, unknown>).procedural_memory)
+	)
+}
+
 /**
  * OpenClaw plugin: OctaMem personal memory (search, add, auto-recall, auto-capture).
  * Registers tools octamem_get / octamem_add, CLI (octamem status/search/details/add), and lifecycle hooks.
@@ -229,15 +239,50 @@ export default {
 					const r = await client.search(clean, prevCtx)
 					if (!r.success) {
 						const msg = r.error ?? "Search failed."
-						// appendSystemContext: inject into system prompt so it is not stored with the user message (docs.openclaw.ai/plugin).
-						return { appendSystemContext: `\n\n### Personal Memory\nIn your response, tell the user: Personal memory is temporarily unavailable. ${msg}` } as { prependContext?: string }
+						return {
+							appendSystemContext: `\n\n### Personal Memory\nIn your response, tell the user: Personal memory is temporarily unavailable. ${msg}`,
+						}
 					}
 					const raw = r.data
+					// Pass search response as-is to the LLM (inner data payload as JSON).
+					const dataPayload =
+						raw && typeof raw === "object" && "data" in (raw as object)
+							? (raw as { data?: unknown }).data
+							: raw
+					const hasPayload = dataPayload != null && typeof dataPayload === "object"
+					const isEmpty =
+						!hasPayload ||
+						(hasPayload && isMemoryDataEmpty(dataPayload as Record<string, unknown>))
 					const block =
-						typeof raw === "string"
-							? raw
-							: formatMemoryBlock(raw)
-					return { appendSystemContext: `\n\n### Personal Memory\n${block}` } as { prependContext?: string }
+						hasPayload && !isEmpty
+							? JSON.stringify(dataPayload, null, 2)
+							: isEmpty
+								? "No memory data."
+								: typeof raw === "string"
+									? raw
+									: JSON.stringify(raw ?? {}, null, 2)
+					const sourceRule =
+						"Personal memory is OctaMem only. If the user asks where memory/data comes from, you MUST answer: from OctaMem. Never say local, workspace, or not Octamem."
+					const summarizeInstruction =
+						"The following is the raw memory search result from OctaMem. Summarize it in a clear, natural response for the user; do not dump the raw structure. "
+					const memoryOnlyInstruction =
+						"[SOURCE: All memory below is from OctaMem only. When asked where memory comes from, always answer: from OctaMem. Never say 'local', 'workspace', or 'not Octamem'.] " +
+						summarizeInstruction +
+						"For 'who is X?', 'what do you know about X?', or any fact about people/places/things the user may have told you: base your answer ONLY on the memory data below. Do not use general knowledge or invent details. " +
+						(isEmpty
+							? "[CRITICAL: The section below is EMPTY (No memory data). You MUST reply only that you don't have that in your personal memory (OctaMem). Do not guess, invent, or use your training knowledge.] "
+							: "") +
+						"When asked the source of memory data, reply: It comes from OctaMem. Never say local or workspace.\n\n"
+					const memoryBlockContent = isEmpty
+						? "No memory data.\n[If you answer from general knowledge here, you are wrong. Reply only: I don't have that in my personal memory.]"
+						: block
+					const prepend = isEmpty
+						? `\n\n[Memory source rule] ${sourceRule}\n[When Personal Memory is empty below, you MUST NOT use general knowledge. Say only: I don't have that in my personal memory.]\n`
+						: `\n\n[Memory source rule] ${sourceRule}\n`
+					return {
+						prependSystemContext: prepend,
+						appendSystemContext: `\n\n### Personal Memory (OctaMem)\n${memoryOnlyInstruction}${memoryBlockContent}`,
+					}
 				} catch {
 					// skip
 				}

package/src/openclaw-config.ts

@@ -78,6 +78,18 @@ export function writeOctaMemPluginConfig(
 	plugins.entries = entries
 	data.plugins = plugins
 
+	// So only OctaMem is used for memory: disable core memory tools (file-based).
+	const coreMemoryToolsToDeny = ["memory_search", "memory_get"]
+	const tools = (data.tools && typeof data.tools === "object"
+		? { ...(data.tools as Record<string, unknown>) }
+		: {}) as Record<string, unknown>
+	let deny = Array.isArray(tools.deny) ? [...(tools.deny as string[])] : []
+	for (const id of coreMemoryToolsToDeny) {
+		if (!deny.includes(id)) deny.push(id)
+	}
+	tools.deny = deny
+	data.tools = tools
+
 	const dir = path.dirname(configPath)
 	if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
 	fs.writeFileSync(configPath, JSON.stringify(data, null, 2), "utf-8")