@memtensor/memos-local-openclaw-plugin 0.1.7 → 0.1.8

package/README.md

@@ -305,23 +305,23 @@ Query → FTS5 + Vector dual recall → RRF Fusion → MMR Rerank
 1. **Auto-recall (hook)** — On every turn, the plugin runs a memory search using the user's message and injects LLM-filtered relevant memories into the agent's context (via `before_agent_start`). The agent sees this as system context; the user does not.
 2. **When nothing is recalled** — If the user's message is long, vague, or no matches are found, the plugin injects a short hint telling the agent to call **`memory_search`** with a **self-generated short query** (e.g. key topics or a rephrased question).
 3. **Bundled skill** — The plugin installs `memos-memory-guide` into `~/.openclaw/workspace/skills/memos-memory-guide/` and `~/.openclaw/skills/memos-memory-guide/`. This skill documents all memory tools, when to call them, and how to write good search queries. Add `skills.load.extraDirs: ["~/.openclaw/skills"]` in `openclaw.json` if you want the skill to appear in the OpenClaw skills dashboard.
-4. **Search results** — `memory_search` returns **excerpts** (original content snippets) and IDs (`chunkId`, `task_id`), not summaries. The agent uses `task_summary(taskId)`, `memory_timeline(chunkId)`, and `skill_get(skillId|taskId)` to drill down when needed. There is no `memory_get`; full context is obtained via `task_summary` or `memory_timeline`.
+4. **Search results** — `memory_search` returns **excerpts** (original content snippets) and IDs (`chunkId`, `task_id`), not summaries. The agent uses `memory_get(chunkId)` for full original text, `task_summary(taskId)` for structured task context, `memory_timeline(chunkId)` for surrounding conversation, and `skill_get(skillId|taskId)` for reusable experience guides.
 
 ## Agent Tools
 
-The plugin registers **6 tools** and auto-installs the **memos-memory-guide** skill:
+The plugin provides **8 smart tools** (7 registered tools + auto-recall) and auto-installs the **memos-memory-guide** skill:
 
 | Tool | Purpose | When to Use |
 |------|---------|-------------|
-| `memory_search` | Search memories; returns excerpts + `chunkId` / `task_id` | When auto-recall returned nothing or you need a different query; use a short, self-generated query if the user's message was long or unclear |
+| `auto_recall` | Automatically injects relevant memories into agent context each turn (via `before_agent_start` hook) | Runs automatically — no manual call needed |
+| `memory_search` | Search memories; returns excerpts + `chunkId` / `task_id` | When auto-recall returned nothing or you need a different query |
+| `memory_get` | Get full original text of a memory chunk | When you need to verify exact details from a search hit |
+| `memory_timeline` | Surrounding conversation around a chunk | When you need the exact dialogue before/after a hit |
 | `task_summary` | Full structured summary of a completed task | When a hit has `task_id` and you need the full story (goal, steps, result) |
-| `memory_timeline` | Surrounding conversation around a chunk | When you need the exact dialogue before/after a hit; pass `chunkId` from the hit |
 | `skill_get` | Get skill content by `skillId` or `taskId` | When a hit has a linked task/skill and you want the reusable experience guide |
 | `skill_install` | Install a skill into the agent workspace | When the skill should be permanently available for future turns |
 | `memory_viewer` | Get the URL of the Memory Viewer web UI | When the user asks where to view or manage their memories |
 
-There is no `memory_get`; search returns excerpts and IDs; use `task_summary` or `memory_timeline` for deeper context.
-
 ### Search Parameters
 
 | Parameter | Default | Range | Description |
@@ -427,40 +427,40 @@ Then restart the gateway.
 
 ## Troubleshooting
 
-### 常见问题排查
+### Common Issues
 
-1. **确认报错内容** — 记下完整报错，例如：`plugin not found`、`Cannot find module 'xxx'`、`Invalid config` 等。
+1. **Note the exact error** — e.g. `plugin not found`, `Cannot find module 'xxx'`, `Invalid config`.
 
-2. **看插件状态**
+2. **Check plugin status**
    ```bash
    openclaw plugins list
    ```
-   - Status 为 **error** → 记下错误信息
-   - 列表中没有 MemOS Local → 未安装或未放到 `~/.openclaw/extensions/memos-local`
+   - Status is **error** → note the error message
+   - Not listed → not installed or not placed in `~/.openclaw/extensions/memos-local`
 
-3. **看网关日志**
+3. **Check gateway logs**
    ```bash
    tail -50 ~/.openclaw/logs/gateway.log
    ```
-   搜索 `memos-local`、`failed to load`、`Error`、`Cannot find module`。
+   Search for `memos-local`, `failed to load`, `Error`, `Cannot find module`.
 
-4. **检查环境**
-   - Node 版本：`node -v`（需要 **>= 18**）
-   - 插件目录存在：`ls ~/.openclaw/extensions/memos-local/package.json`
-   - 依赖已安装：`ls ~/.openclaw/extensions/memos-local/node_modules/@sinclair/typebox`
-     若不存在：`cd ~/.openclaw/extensions/memos-local && npm install --omit=dev`
+4. **Check environment**
+   - Node version: `node -v` (requires **>= 18**)
+   - Plugin directory exists: `ls ~/.openclaw/extensions/memos-local/package.json`
+   - Dependencies installed: `ls ~/.openclaw/extensions/memos-local/node_modules/@sinclair/typebox`
+     If missing: `cd ~/.openclaw/extensions/memos-local && npm install --omit=dev`
 
-5. **检查配置** — 打开 `~/.openclaw/openclaw.json`，确认：
-   - `agents.defaults.memorySearch.enabled` = `false`（关闭内置记忆）
+5. **Check configuration** — Open `~/.openclaw/openclaw.json` and verify:
+   - `agents.defaults.memorySearch.enabled` = `false` (disable built-in memory)
    - `plugins.slots.memory` = `"memos-local"`
    - `plugins.entries.memos-local.enabled` = `true`
 
-6. **记忆和 OpenClaw 内置记忆冲突** — 如果看到 agent 同时调用了内置的 memory 搜索和插件的 `memory_search`，说明 `agents.defaults.memorySearch.enabled` 没有设为 `false`。
+6. **Memory conflict with built-in search** — If the agent calls both the built-in memory search and the plugin's `memory_search`, it means `agents.defaults.memorySearch.enabled` is not set to `false`.
 
-7. **技能不生成** — 检查：
-   - `skillEvolution.enabled` 是否为 `true`
-   - 任务是否有足够内容（默认需要 ≥ 6 chunks）
-   - 查看日志中 `SkillEvolver` 相关输出
+7. **Skills not generating** — Check:
+   - `skillEvolution.enabled` is `true`
+   - Tasks have enough content (default requires >= 6 chunks)
+   - Look for `SkillEvolver` output in the gateway log
 
 ## Data Location
 

package/index.ts

@@ -2,7 +2,7 @@
  * OpenClaw Plugin Entry — memos-local
  *
  * Full-write local memory with hybrid retrieval (RRF + MMR + recency).
- * Provides: memory_search, memory_timeline, memory_get, memory_viewer
+ * Provides: memory_search, memory_get, memory_timeline, task_summary, skill_get, skill_install, memory_viewer
  */
 
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
@@ -324,15 +324,56 @@ const memosLocalPlugin = {
 
           return {
             content: [{ type: "text", text: `Timeline (${entries.length} entries):\n\n${text}` }],
-            details: { entries, anchorRef: { sessionKey, chunkId, turnId, seq } },
+            details: { entries, anchorRef: { sessionKey: anchorChunk.sessionKey, chunkId, turnId: anchorChunk.turnId, seq: anchorChunk.seq } },
           };
         }),
       },
       { name: "memory_timeline" },
     );
 
-    // memory_get removed — search results are pre-filtered by LLM for relevance;
-    // agents use task_summary for broader context and skill_get for experience guides.
+    // ─── Tool: memory_get ───
+
+    api.registerTool(
+      {
+        name: "memory_get",
+        label: "Memory Get",
+        description:
+          "Get the full original text of a memory chunk. Use to verify exact details from a search hit.",
+        parameters: Type.Object({
+          chunkId: Type.String({ description: "From search hit ref.chunkId" }),
+          maxChars: Type.Optional(
+            Type.Number({ description: `Max chars (default ${DEFAULTS.getMaxCharsDefault}, max ${DEFAULTS.getMaxCharsMax})` }),
+          ),
+        }),
+        execute: trackTool("memory_get", async (_toolCallId: any, params: any) => {
+          const { chunkId, maxChars } = params as { chunkId: string; maxChars?: number };
+          const limit = Math.min(maxChars ?? DEFAULTS.getMaxCharsDefault, DEFAULTS.getMaxCharsMax);
+
+          const chunk = store.getChunk(chunkId);
+          if (!chunk) {
+            return {
+              content: [{ type: "text", text: `Chunk not found: ${chunkId}` }],
+              details: { error: "not_found" },
+            };
+          }
+
+          const content = chunk.content.length > limit
+            ? chunk.content.slice(0, limit) + "\u2026"
+            : chunk.content;
+
+          const who = chunk.role === "user" ? "USER said" : chunk.role === "assistant" ? "ASSISTANT replied" : chunk.role === "tool" ? "TOOL returned" : chunk.role.toUpperCase();
+
+          return {
+            content: [{ type: "text", text: `[${who}] (session: ${chunk.sessionKey})\n\n${content}` }],
+            details: {
+              ref: { sessionKey: chunk.sessionKey, chunkId: chunk.id, turnId: chunk.turnId, seq: chunk.seq },
+              source: { ts: chunk.createdAt, role: chunk.role, sessionKey: chunk.sessionKey },
+            },
+          };
+        }),
+      },
+      { name: "memory_get" },
+    );
 
     // ─── Tool: task_summary ───
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memtensor/memos-local-openclaw-plugin",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "MemOS Local memory plugin for OpenClaw — full-write, hybrid-recall, progressive retrieval",
   "type": "module",
   "main": "index.ts",