@openviking/openclaw-plugin 2026.8.19 → 2026.8.28

package/README.md

@@ -269,7 +269,7 @@ They serve different roles:
 Resource and skill imports are intentionally separate because they land in different OpenViking namespaces and use different server APIs:
 
 - resources go through `/api/v1/resources` and land under `viking://resources/...`
-- skills go through `/api/v1/skills` and land under `viking://user/skills/...`
+- skills go through `/api/v1/skills` and land under `viking://user/<uid>/skills/...`
 
 The plugin also registers explicit slash commands for manual imports:
 
@@ -277,7 +277,7 @@ The plugin also registers explicit slash commands for manual imports:
 /add-resource ./README.md --to viking://resources/openviking-readme --wait
 /add-skill ./skills/install-openviking-memory --wait
 /ov-search "OpenViking install" --uri viking://resources/openviking-readme
-/ov-search "memory install skill" --uri viking://user/skills
+/ov-search "memory install skill" --uri viking://~/skills
 ```
 
 Resource import supports remote URLs, Git URLs, local files, local directories, and uploaded zip files. OpenViking's built-in parsers cover common documents and media such as Markdown, text, PDF, HTML, Word, PowerPoint, Excel, EPUB, images, audio, and video. Directory imports also accept common code, documentation, and config file extensions such as `.py`, `.js`, `.ts`, `.go`, `.rs`, `.java`, `.cpp`, `.json`, `.yaml`, `.toml`, `.csv`, `.rst`, `.proto`, `.tf`, and `.vue`.

package/client.ts

@@ -36,7 +36,7 @@ export type FsListResult = FsListEntry[];
 
 export type CaptureMode = "semantic" | "keyword";
 function userSessionUri(sessionId: string): string {
-  return `viking://user/sessions/${encodeURIComponent(sessionId)}`;
+  return `viking://~/sessions/${encodeURIComponent(sessionId)}`;
 }
 
 export type OpenVikingClientOptions = {

package/config.ts

@@ -136,7 +136,7 @@ export type ParsedMemoryOpenVikingConfig = Required<
 };
 
 const DEFAULT_BASE_URL = "http://127.0.0.1:1933";
-const DEFAULT_TARGET_URI = "viking://user/memories";
+const DEFAULT_TARGET_URI = "viking://~/memories";
 const DEFAULT_TIMEOUT_MS = 15000;
 const DEFAULT_CAPTURE_MODE = "semantic";
 const DEFAULT_CAPTURE_MAX_LENGTH = 24000;

package/dist/client.js

@@ -8,7 +8,7 @@ import { Zip, ZipDeflate } from "fflate";
 import { defaultHttpTransport } from "./adapters/http-transport.js";
 import { defaultResourcePackager, } from "./adapters/resource-packager.js";
 function userSessionUri(sessionId) {
-    return `viking://user/sessions/${encodeURIComponent(sessionId)}`;
+    return `viking://~/sessions/${encodeURIComponent(sessionId)}`;
 }
 const DEFAULT_WAIT_REQUEST_TIMEOUT_MS = 120_000;
 export const DEFAULT_PHASE2_POLL_TIMEOUT_MS = 300_000;

package/dist/config.js

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import { readFileSync } from "node:fs";
 import { getEnv } from "./runtime-utils.js";
 const DEFAULT_BASE_URL = "http://127.0.0.1:1933";
-const DEFAULT_TARGET_URI = "viking://user/memories";
+const DEFAULT_TARGET_URI = "viking://~/memories";
 const DEFAULT_TIMEOUT_MS = 15000;
 const DEFAULT_CAPTURE_MODE = "semantic";
 const DEFAULT_CAPTURE_MAX_LENGTH = 24000;

package/dist/memory-ranking.js

@@ -181,9 +181,9 @@ function inferResourceType(item) {
         return "resource";
     if (item.uri.startsWith("viking://session/"))
         return "session";
-    if (item.uri.startsWith("viking://user/skills") || item.uri.startsWith("viking://skills"))
+    if (item.uri.startsWith("viking://user/skills") || item.uri.startsWith("viking://~/skills") || item.uri.startsWith("viking://skills"))
         return "agent";
-    if (item.uri.startsWith("viking://user/"))
+    if (item.uri.startsWith("viking://user/") || item.uri.startsWith("viking://~/"))
         return "user";
     return undefined;
 }

package/dist/plugin/openviking-query-runtime.js

@@ -279,7 +279,7 @@ export function createOpenVikingQueryRuntime(deps) {
             };
             const [resourcesSettled, skillsSettled] = await Promise.allSettled([
                 runSearch("viking://resources"),
-                runSearch("viking://user/skills"),
+                runSearch("viking://~/skills"),
             ]);
             const successful = [];
             if (resourcesSettled.status === "fulfilled") {

package/dist/plugin/openviking-recall-trace-runtime.js

@@ -57,9 +57,9 @@ function inferUriType(uri) {
         return "resource";
     if (uri.startsWith("viking://session/"))
         return "session";
-    if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://skills"))
+    if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://~/skills") || uri.startsWith("viking://skills"))
         return "skill";
-    if (uri.startsWith("viking://user/"))
+    if (uri.startsWith("viking://user/") || uri.startsWith("viking://~/"))
         return "user_memory";
     if (uri.includes("/archive") || uri.includes("/history/"))
         return "archive";

package/dist/plugin/openviking-runtime-utils.js

@@ -8,9 +8,11 @@ export function previewText(value, maxChars) {
 export function inferRecallResourceType(uri) {
     if (uri.startsWith("viking://resources"))
         return "resource";
-    if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://skills"))
+    // viking://~ is the home alias for the caller's own user space; configured target
+    // URIs use it, while server responses come back canonical as viking://user/<uid>/...
+    if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://~/skills") || uri.startsWith("viking://skills"))
         return "agent";
-    if (uri.startsWith("viking://user/"))
+    if (uri.startsWith("viking://user/") || uri === "viking://~" || uri.startsWith("viking://~/"))
         return "user";
     return undefined;
 }

package/dist/routing/memory-uri.js

@@ -1,6 +1,10 @@
 const MEMORY_URI_PATTERNS = [
     /^viking:\/\/user\/(?:[^/]+(?:\/agent\/[^/]+)?\/)?memories(?:\/|$)/,
     /^viking:\/\/user\/[^/]+\/peers\/[^/]+\/memories(?:\/|$)/,
+    // viking://~ is the home alias for the caller's own user space. Configured targets and
+    // model-supplied URIs may use it; server responses stay canonical viking://user/<uid>/...
+    /^viking:\/\/~\/memories(?:\/|$)/,
+    /^viking:\/\/~\/peers\/[^/]+\/memories(?:\/|$)/,
     /^viking:\/\/agent\/(?:[^/]+(?:\/user\/[^/]+)?\/)?memories(?:\/|$)/,
 ];
 export function isMemoryUri(uri) {

package/dist/services/context-lifecycle-service.js

@@ -196,10 +196,14 @@ function isSessionNotFoundError(err) {
     return errorMessage.includes("[NOT_FOUND]") && errorMessage.includes("Session not found");
 }
 export async function assembleOpenVikingSession({ sessionId, sessionKey, messages, tokenBudget, runtimeContext, isMainAssemble, cfg, getClient, logger, resolveAgentId, rememberSessionAgentId, isBypassedSession, queryConfigStore, traceRecorder, diag, roughEstimate, messageDigest, extractAgentMessageText, hasAutoRecallBlock, prependRecallToLatestUserMessage, }) {
-    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
-    const sender = extractRuntimeSenderId(runtimeContext);
     const latestMessage = messages.at(-1);
     const isTransformContextAssemble = !isMainAssemble;
+    // Tool-loop calls do no recall work on non-user tails; avoid scanning the full history.
+    if (isTransformContextAssemble && latestMessage?.role !== "user") {
+        return { messages, estimatedTokens: 0 };
+    }
+    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+    const sender = extractRuntimeSenderId(runtimeContext);
     const originalTokens = roughEstimate(messages);
     rememberSessionAgentId?.({
         sessionId,
@@ -220,16 +224,6 @@ export async function assembleOpenVikingSession({ sessionId, sessionKey, message
         return assemblePassthrough({ diag, ovSessionId, reason: "session_bypassed", liveMessages: messages, originalTokens });
     }
     if (isTransformContextAssemble) {
-        if (latestMessage?.role !== "user") {
-            return assemblePassthrough({
-                diag,
-                ovSessionId,
-                reason: "transform_context_non_user_tail",
-                liveMessages: messages,
-                originalTokens,
-                extra: { latestRole: latestMessage?.role ?? null },
-            });
-        }
         if (!cfg.autoRecall) {
             return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_auto_recall_disabled", liveMessages: messages, originalTokens });
         }

package/memory-ranking.ts

@@ -232,8 +232,8 @@ function lexicalOverlapBoost(tokens: string[], text: string, maxBoost = DEFAULT_
 function inferResourceType(item: FindResultItem): string | undefined {
   if (item.uri.startsWith("viking://resources")) return "resource";
   if (item.uri.startsWith("viking://session/")) return "session";
-  if (item.uri.startsWith("viking://user/skills") || item.uri.startsWith("viking://skills")) return "agent";
-  if (item.uri.startsWith("viking://user/")) return "user";
+  if (item.uri.startsWith("viking://user/skills") || item.uri.startsWith("viking://~/skills") || item.uri.startsWith("viking://skills")) return "agent";
+  if (item.uri.startsWith("viking://user/") || item.uri.startsWith("viking://~/")) return "user";
   return undefined;
 }
 

package/openclaw.plugin.json

@@ -120,7 +120,7 @@
     },
     "targetUri": {
       "label": "Search Target URI",
-      "placeholder": "viking://user/memories",
+      "placeholder": "viking://~/memories",
       "help": "Default OpenViking target URI for memory search"
     },
     "timeoutMs": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openviking/openclaw-plugin",
-  "version": "2026.8.19",
+  "version": "2026.8.28",
   "displayName": "OpenViking",
   "description": "OpenClaw context-engine plugin — OpenViking AI memory, long-term memory, knowledge base, semantic search, RAG, context engine. 长期记忆 · 知识库 · 语义检索 · 上下文引擎",
   "type": "module",

package/plugin/openviking-query-runtime.ts

@@ -386,7 +386,7 @@ export function createOpenVikingQueryRuntime<TQueryConfigContext>(deps: OpenViki
       };
       const [resourcesSettled, skillsSettled] = await Promise.allSettled([
         runSearch("viking://resources"),
-        runSearch("viking://user/skills"),
+        runSearch("viking://~/skills"),
       ]);
       const successful: FindResult[] = [];
       if (resourcesSettled.status === "fulfilled") {

package/plugin/openviking-recall-trace-runtime.ts

@@ -120,8 +120,8 @@ function toLimitedInteger(value: unknown, fallback: number, min: number, max: nu
 function inferUriType(uri: string): string {
   if (uri.startsWith("viking://resources") || uri.startsWith("viking://resource")) return "resource";
   if (uri.startsWith("viking://session/")) return "session";
-  if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://skills")) return "skill";
-  if (uri.startsWith("viking://user/")) return "user_memory";
+  if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://~/skills") || uri.startsWith("viking://skills")) return "skill";
+  if (uri.startsWith("viking://user/") || uri.startsWith("viking://~/")) return "user_memory";
   if (uri.includes("/archive") || uri.includes("/history/")) return "archive";
   return "unknown";
 }

package/plugin/openviking-runtime-utils.ts

@@ -10,8 +10,10 @@ export function previewText(value: unknown, maxChars: number): string | undefine
 
 export function inferRecallResourceType(uri: string): RecallResourceType | undefined {
   if (uri.startsWith("viking://resources")) return "resource";
-  if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://skills")) return "agent";
-  if (uri.startsWith("viking://user/")) return "user";
+  // viking://~ is the home alias for the caller's own user space; configured target
+  // URIs use it, while server responses come back canonical as viking://user/<uid>/...
+  if (uri.startsWith("viking://user/skills") || uri.startsWith("viking://~/skills") || uri.startsWith("viking://skills")) return "agent";
+  if (uri.startsWith("viking://user/") || uri === "viking://~" || uri.startsWith("viking://~/")) return "user";
   return undefined;
 }
 

package/routing/memory-uri.ts

@@ -1,6 +1,10 @@
 const MEMORY_URI_PATTERNS = [
   /^viking:\/\/user\/(?:[^/]+(?:\/agent\/[^/]+)?\/)?memories(?:\/|$)/,
   /^viking:\/\/user\/[^/]+\/peers\/[^/]+\/memories(?:\/|$)/,
+  // viking://~ is the home alias for the caller's own user space. Configured targets and
+  // model-supplied URIs may use it; server responses stay canonical viking://user/<uid>/...
+  /^viking:\/\/~\/memories(?:\/|$)/,
+  /^viking:\/\/~\/peers\/[^/]+\/memories(?:\/|$)/,
   /^viking:\/\/agent\/(?:[^/]+(?:\/user\/[^/]+)?\/)?memories(?:\/|$)/,
 ];
 

package/services/context-lifecycle-service.ts

@@ -441,10 +441,16 @@ export async function assembleOpenVikingSession({
   hasAutoRecallBlock,
   prependRecallToLatestUserMessage,
 }: AssembleOpenVikingSessionParams): Promise<AssembleOpenVikingSessionResult> {
-  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
-  const sender = extractRuntimeSenderId(runtimeContext);
   const latestMessage = messages.at(-1);
   const isTransformContextAssemble = !isMainAssemble;
+
+  // Tool-loop calls do no recall work on non-user tails; avoid scanning the full history.
+  if (isTransformContextAssemble && latestMessage?.role !== "user") {
+    return { messages, estimatedTokens: 0 };
+  }
+
+  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+  const sender = extractRuntimeSenderId(runtimeContext);
   const originalTokens = roughEstimate(messages);
 
   rememberSessionAgentId?.({
@@ -468,16 +474,6 @@ export async function assembleOpenVikingSession({
   }
 
   if (isTransformContextAssemble) {
-    if (latestMessage?.role !== "user") {
-      return assemblePassthrough({
-        diag,
-        ovSessionId,
-        reason: "transform_context_non_user_tail",
-        liveMessages: messages,
-        originalTokens,
-        extra: { latestRole: latestMessage?.role ?? null },
-      });
-    }
     if (!cfg.autoRecall) {
       return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_auto_recall_disabled", liveMessages: messages, originalTokens });
     }

package/skills/install-openviking-memory/SKILL.md

@@ -590,7 +590,7 @@ These are the keys under `plugins.entries.openviking.config` in `openclaw.json`.
 | `peer_prefix` | `""` | Optional prefix for assistant `peer_id` / actor peer values when `peer_role=assistant`. Letters / digits / `_` / `-`. |
 | `accountId` | — | Required when `apiKey` is a root key. |
 | `userId` | — | Required when `apiKey` is a root key. |
-| `targetUri` | `viking://user/memories` | Default search scope URI. |
+| `targetUri` | `viking://~/memories` | Default search scope URI. |
 | `timeoutMs` | (plugin default) | HTTP timeout for OpenViking calls. |
 | `autoCapture` | `true` | Auto-append turn messages to the OpenViking session at `afterTurn`; extraction runs only after a threshold commit, `/compact`, or explicit `memory_store`. |
 | `captureMode` | `"semantic"` | Filter mode used by the server-side extraction pipeline: `semantic` or `keyword`. |

package/skills/openviking-context-database/SKILL.md

@@ -67,7 +67,7 @@ Core config lives under `plugins.entries.openviking.config`:
 | `peer_role` | `assistant` | Peer identity mode: `none`, `assistant`, or `person`. Session messages use body `peer_id`; data-plane recall/search uses `X-OpenViking-Actor-Peer`. |
 | `peer_prefix` | empty | Optional prefix for assistant `peer_id` / actor peer values when `peer_role=assistant`. |
 | `accountId` / `userId` | empty | Advanced tenant identity headers for root-key or trusted deployments. |
-| `targetUri` | `viking://user/memories` | Default search scope for legacy targeted memory search. |
+| `targetUri` | `viking://~/memories` | Default search scope for legacy targeted memory search. |
 | `autoCapture` | `true` | Append sanitized turn text to OpenViking sessions. |
 | `captureMode` | `semantic` | `semantic` or `keyword`; affects server-side extraction filtering. |
 | `captureMaxLength` | `24000` | Max sanitized text length per captured turn. |
@@ -196,7 +196,7 @@ The current OpenClaw tool exposes the parameters above. The underlying client al
 
 ### `add_skill`
 
-Import Agent Skills into `viking://user/skills/...`.
+Import Agent Skills into `viking://~/skills/...`.
 
 | Parameter | Required | Description |
 |---|---|---|

package/skills/ov-experience-memory/SKILL.md

@@ -50,7 +50,7 @@ context or deeper intent analysis is useful.
 3. Search only the current user's Experience root:
 
    ```text
-   viking://user/memories/experiences
+   viking://~/memories/experiences
    ```
 
    For tools using MCP-style parameters, set `target_uri` to this root. For