@remnic/plugin-openclaw 9.3.563 → 9.3.564

package/README.md

@@ -49,7 +49,7 @@ The package metadata keeps the installer compatibility floor at the single
 `>=2026.4.1` shape OpenClaw setup expects because that older floor is still
 more permissive than the active 60-day requirement. The peer and plugin-API
 compatibility ranges explicitly include reviewed prerelease hosts in that
-window. The adapter separately records `2026.6.2-alpha.1` as the latest
+window. The adapter separately records `2026.6.2-alpha.2` as the latest
 reviewed OpenClaw source-tag target.
 
 When adding newer OpenClaw manifest surfaces, keep older-compatible metadata in
@@ -192,11 +192,11 @@ for the Remnic adapter surfaces. The May 31 sweep checked source tags
 #1203 through #1245, excluding unrelated issue #1211. The June 2 sweep reviewed
 Remnic issues #1258, #1259, #1266, and #1271 against OpenClaw tags
 `v2026.5.31-beta.4`, `v2026.6.1-alpha.1`, `v2026.6.1-alpha.2`,
-`v2026.6.1-alpha.3`, `v2026.6.1-beta.1`, `v2026.6.1-beta.2`, and
-`v2026.6.2-alpha.1`. The existing SDK snapshot still matched (`14 registrars,
-22 hooks, 2 manifest contracts`) for each tag. `v2026.6.2-alpha.1` exists as an
-upstream source tag, but as of June 2, 2026 it is not a GitHub release page or
-published npm package.
+`v2026.6.1-alpha.3`, `v2026.6.1-beta.1`, `v2026.6.1-beta.2`,
+`v2026.6.2-alpha.1`, and `v2026.6.2-alpha.2`. The existing SDK snapshot still
+matched (`14 registrars, 22 hooks, 2 manifest contracts`) for each tag.
+`v2026.6.2-alpha.1` and `v2026.6.2-alpha.2` exist as upstream source tags, but
+as of June 2, 2026 they are not GitHub release pages or published npm packages.
 
 OpenClaw 2026.5.16 package-entry discovery prefers explicit built runtime
 entries for installed packages. The published Remnic adapter declares
@@ -236,15 +236,31 @@ because the adapter owns mixed memory-slot hooks, lifecycle handlers, slash
 command metadata, public artifacts, and runtime tools rather than only static
 tools.
 
-OpenClaw 2026.5.20-beta.2 through the reviewed `2026.6.2-alpha.1` source tag
+OpenClaw 2026.5.20-beta.2 through the reviewed `2026.6.2-alpha.2` source tag
 keep the Remnic-required plugin install, ClawHub fallback, manifest contract,
 hook, memory-slot, gateway LLM, and plugin security-scan surfaces compatible.
 OpenClaw 2026.5.31-beta.4 added optional `plugin-sdk/chat-channel-ids` and
 `plugin-sdk/memory-core-host-embedding-registry` subpaths, and
-`2026.6.2-alpha.1` adds quoted-reply metadata fields to inbound and
-`before_dispatch` hook contexts. Remnic does not consume those optional
-surfaces in the memory adapter, so no runtime adapter code change is required.
-The package metadata now records `2026.6.2-alpha.1` as the reviewed OpenClaw
+`2026.6.2-alpha.1`/`2026.6.2-alpha.2` add quoted-reply metadata fields to
+inbound and `before_dispatch` hook contexts. Remnic consumes those optional
+surfaces only through compatibility gates:
+
+- `hostEmbeddingProviderEnabled` (default `true`) lets Remnic prefer
+  OpenClaw memory/generic embedding providers for semantic fallback and
+  embedded vector backends when the host SDK exposes them. Provider creation
+  failures fall back to Remnic's existing embedding path.
+- `openclawMessageReceivedCaptureEnabled` (default `true`) captures inbound
+  `message_received` content into transcripts when the host emits that hook.
+- `openclawReplyMetadataCaptureEnabled` (default `true`) stores bounded
+  `messageId`, `threadId`, `replyToId`, `replyToBody`, and `replyToSender`
+  transcript metadata.
+- `openclawReplyMetadataExtractionHintsEnabled` (default `false`) prepends
+  bounded quoted-reply context to user turns before extraction.
+- `openclawChannelEnvelopeCleaningEnabled` (default `true`) uses OpenClaw's
+  canonical channel envelope prefixes when the SDK subpath exists, with the
+  legacy OpenClaw-only cleaner preserved for older hosts.
+
+The package metadata now records `2026.6.2-alpha.2` as the reviewed OpenClaw
 source-tag target and keeps the stable `>=2026.4.1` installer floor plus
 reviewed prerelease peer/plugin-API hosts eligible.
 

package/dist/index.js

@@ -24,6 +24,7 @@ import * as day_summary_star from "@remnic/core/day-summary";
 // ../../src/index.ts
 import OpenAI from "openai";
 import { createRequire } from "module";
+import { createHash as createHash2 } from "crypto";
 
 // ../../src/config.ts
 var config_exports = {};
@@ -2943,13 +2944,23 @@ import { readEnvVar, resolveHomeDir } from "@remnic/core/runtime/env";
 import { migrateFromEngram, rollbackFromEngramMigration } from "@remnic/core/migrate/from-engram";
 
 // ../../src/user-message-cleaning.ts
-function cleanUserMessage(content) {
+var DEFAULT_CHANNEL_ENVELOPE_PREFIXES = ["OpenClaw"];
+function createOpenClawUserMessageCleaner(prefixes, options = {}) {
+  const normalized = normalizeOpenClawChannelEnvelopePrefixes(prefixes);
+  const includeLegacyChannelEnvelopePattern = options.includeLegacyChannelEnvelopePattern ?? true;
+  const platformHeaderPattern = channelEnvelopeHeaderPattern(
+    normalized,
+    includeLegacyChannelEnvelopePattern === true
+  );
+  return (content) => cleanUserMessageWithPattern(content, platformHeaderPattern);
+}
+function cleanUserMessageWithPattern(content, platformHeaderPattern) {
   let cleaned = content;
   cleaned = cleaned.replace(
     /<supermemory-context[^>]*>[\s\S]*?<\/supermemory-context>\s*/gi,
     ""
   );
-  const platformHeader = cleaned.match(/^\[\w+\s+.+?\s+id:\d+\s+[^\]]+\]\s*/);
+  const platformHeader = cleaned.match(platformHeaderPattern);
   const hasPlatformHeader = platformHeader !== null;
   if (platformHeader) {
     cleaned = cleaned.slice(platformHeader[0].length);
@@ -2963,6 +2974,21 @@ function cleanUserMessage(content) {
   }
   return cleaned.trim();
 }
+function normalizeOpenClawChannelEnvelopePrefixes(prefixes) {
+  const cleaned = prefixes.map((prefix) => typeof prefix === "string" ? prefix.trim() : "").filter((prefix) => prefix.length > 0);
+  return cleaned.length > 0 ? cleaned : [...DEFAULT_CHANNEL_ENVELOPE_PREFIXES];
+}
+function channelEnvelopeHeaderPattern(prefixes, includeLegacyChannelEnvelopePattern) {
+  const alternatives = prefixes.map(escapeRegExp).join("|");
+  const patterns = [`\\[(?:${alternatives})\\s+.+?\\s+id:\\d+\\s+[^\\]]+\\]`];
+  if (includeLegacyChannelEnvelopePattern) {
+    patterns.push("\\[\\w+\\s+.+?\\s+id:\\d+\\s+[^\\]]+\\]");
+  }
+  return new RegExp(`^(?:${patterns.join("|")})\\s*`);
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 
 // src/public-artifacts.ts
 import { readdir, access, stat, lstat, realpath } from "fs/promises";
@@ -3484,7 +3510,7 @@ async function syncHeartbeatSurfaceEntries(params) {
   }
   return { created, updated, linked: 0 };
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function buildDelimitedBoundaryClass() {
@@ -3495,7 +3521,7 @@ function compileDelimitedPhrasePattern(value) {
   if (normalized.length === 0) return null;
   const boundaryClass = buildDelimitedBoundaryClass();
   return new RegExp(
-    `(^|[^${boundaryClass}])${escapeRegExp(normalized)}([^${boundaryClass}]|$)`
+    `(^|[^${boundaryClass}])${escapeRegExp2(normalized)}([^${boundaryClass}]|$)`
   );
 }
 function matchesDelimitedPattern(haystack, pattern) {
@@ -4074,6 +4100,7 @@ function buildTurnFingerprint(input) {
 // ../../src/index.ts
 import { planRecallMode } from "@remnic/core/intent";
 import { resolvePrincipal, resolveAgentAccessAuthToken as resolveAgentAccessAuthCredential, expandTildePath } from "@remnic/core";
+import { normalizeHostEmbeddingVector, registerHostEmbeddingProvider } from "@remnic/core/host-embedding-provider";
 
 // ../../src/resolve-provider-secret.ts
 var resolve_provider_secret_exports = {};
@@ -4372,6 +4399,8 @@ function buildServiceKeys(serviceId) {
   const suffix = `::${serviceId}`;
   return {
     REGISTERED_GUARD: `__openclawEngramRegistered${suffix}`,
+    HOST_EMBEDDING_UNREGISTER: `__openclawEngramHostEmbeddingUnregister${suffix}`,
+    HOST_EMBEDDING_SIGNATURE: `__openclawEngramHostEmbeddingSignature${suffix}`,
     HOOK_APIS: `__openclawEngramHookApis${suffix}`,
     ACCESS_SERVICE: `__openclawEngramAccessService${suffix}`,
     ACCESS_HTTP_SERVER: `__openclawEngramAccessHttpServer${suffix}`,
@@ -4570,6 +4599,211 @@ function tryDefinePluginEntry(def) {
     return def;
   }
 }
+var MAX_OBSERVED_INBOUND_MESSAGE_IDS = 1024;
+var MAX_OBSERVED_INLINE_EXPLICIT_CAPTURE_KEYS = 1024;
+function requireOpenClawSdkSubpath(subpath) {
+  try {
+    const _require = createRequire(import.meta.url);
+    return _require(subpath);
+  } catch {
+    return null;
+  }
+}
+function resolveChannelEnvelopePrefixes(cfg) {
+  if (!cfg.openclawChannelEnvelopeCleaningEnabled) {
+    return { prefixes: ["OpenClaw"], includeLegacyChannelEnvelopePattern: true };
+  }
+  const sdk = requireOpenClawSdkSubpath("openclaw/plugin-sdk/chat-channel-ids");
+  const prefixes = sdk?.BUNDLED_CHAT_CHANNEL_ENVELOPE_PREFIXES;
+  if (!Array.isArray(prefixes)) {
+    return { prefixes: ["OpenClaw"], includeLegacyChannelEnvelopePattern: true };
+  }
+  const cleaned = prefixes.filter((value) => typeof value === "string");
+  return {
+    prefixes: cleaned.length > 0 ? cleaned : ["OpenClaw"],
+    includeLegacyChannelEnvelopePattern: false
+  };
+}
+function registerOpenClawHostEmbeddingProvider(params) {
+  const { api, cfg, serviceId } = params;
+  if (cfg.hostEmbeddingProviderEnabled === false) return null;
+  const selected = selectOpenClawEmbeddingAdapter(api, cfg.hostEmbeddingProviderId);
+  if (!selected) return null;
+  const model = cfg.hostEmbeddingProviderModel || selected.adapter.defaultModel || "text-embedding-3-small";
+  const workspaceDir = getOpenClawRuntimeWorkspaceDir(api);
+  let providerPromise = null;
+  let providerInstance = null;
+  const resolveProvider = async () => {
+    if (providerInstance) return providerInstance;
+    providerPromise ??= selected.adapter.create({
+      config: api.config ?? {},
+      workspaceDir,
+      agentDir: workspaceDir,
+      provider: cfg.hostEmbeddingProviderId || selected.adapter.id,
+      model
+    }).then((result) => {
+      providerInstance = result && typeof result === "object" ? result.provider ?? null : null;
+      if (!providerInstance) {
+        logger_exports.log.debug(
+          `OpenClaw host embedding provider ${selected.adapter.id} did not create a provider; using Remnic fallback embeddings`
+        );
+      }
+      return providerInstance;
+    }).catch((error) => {
+      logger_exports.log.debug(
+        `OpenClaw host embedding provider ${selected.adapter.id} unavailable: ${error}`
+      );
+      return null;
+    }).finally(() => {
+      if (!providerInstance) {
+        providerPromise = null;
+      }
+    });
+    return providerPromise;
+  };
+  const hostProvider = {
+    id: `openclaw:${selected.kind}:${selected.adapter.id}`,
+    model: `${selected.kind}:${selected.adapter.id}/${model}`,
+    async embed(text, options) {
+      const provider = await resolveProvider();
+      if (!provider) return null;
+      return embedWithOpenClawProvider(selected.kind, provider, text, options);
+    },
+    async embedBatch(texts, options) {
+      const provider = await resolveProvider();
+      if (!provider) return texts.map(() => null);
+      return embedBatchWithOpenClawProvider(selected.kind, provider, texts, options);
+    },
+    async close() {
+      const close = providerInstance && typeof providerInstance === "object" ? providerInstance.close : void 0;
+      if (typeof close === "function") {
+        await close.call(providerInstance);
+      }
+    }
+  };
+  const unregister = registerHostEmbeddingProvider(cfg.memoryDir, hostProvider);
+  logger_exports.log.info(
+    `registered OpenClaw host embedding provider bridge (${selected.adapter.id}) for ${serviceId}`
+  );
+  return unregister;
+}
+function getOpenClawRuntimeWorkspaceDir(api) {
+  const runtimeWorkspaceDir = api.runtime?.agent?.workspaceDir;
+  return typeof runtimeWorkspaceDir === "string" && runtimeWorkspaceDir.length > 0 ? runtimeWorkspaceDir : void 0;
+}
+function stableOpenClawConfigSignature(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null) return "null";
+  const valueType = typeof value;
+  if (valueType === "string" || valueType === "number" || valueType === "boolean") {
+    return JSON.stringify(value);
+  }
+  if (valueType === "bigint") return JSON.stringify(String(value));
+  if (valueType === "undefined" || valueType === "function" || valueType === "symbol") {
+    return JSON.stringify(`[${valueType}]`);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((entry) => stableOpenClawConfigSignature(entry, seen)).join(",")}]`;
+  }
+  if (value && valueType === "object") {
+    if (seen.has(value)) return JSON.stringify("[Circular]");
+    seen.add(value);
+    const entries = Object.keys(value).sort().map(
+      (key) => `${JSON.stringify(key)}:${stableOpenClawConfigSignature(
+        value[key],
+        seen
+      )}`
+    );
+    seen.delete(value);
+    return `{${entries.join(",")}}`;
+  }
+  return JSON.stringify(String(value));
+}
+function openClawHostEmbeddingConfigSignature(cfg, apiConfig, workspaceDir) {
+  return `sha256:${createHash2("sha256").update(JSON.stringify({
+    enabled: cfg.hostEmbeddingProviderEnabled !== false,
+    memoryDir: cfg.memoryDir,
+    providerId: cfg.hostEmbeddingProviderId ?? "",
+    providerModel: cfg.hostEmbeddingProviderModel ?? "",
+    workspaceDir: workspaceDir ?? "",
+    openClawConfig: stableOpenClawConfigSignature(apiConfig)
+  })).digest("hex")}`;
+}
+function selectOpenClawEmbeddingAdapter(api, requestedId) {
+  const memorySdk = loadOpenClawMemoryEmbeddingSdk();
+  const memoryAdapters = memorySdk?.listMemoryEmbeddingProviders?.(api.config) ?? [];
+  const selectedMemory = selectAdapter(memoryAdapters, requestedId);
+  if (selectedMemory) {
+    return { kind: "memory", adapter: selectedMemory };
+  }
+  const genericSdk = requireOpenClawSdkSubpath("openclaw/plugin-sdk/embedding-providers");
+  const genericAdapters = genericSdk?.listEmbeddingProviders?.(api.config) ?? [];
+  const selectedGeneric = selectAdapter(genericAdapters, requestedId);
+  if (selectedGeneric) {
+    return { kind: "generic", adapter: selectedGeneric };
+  }
+  return null;
+}
+function loadOpenClawMemoryEmbeddingSdk() {
+  return selectOpenClawMemoryEmbeddingSdk(
+    requireOpenClawSdkSubpath("openclaw/plugin-sdk/memory-core-host-engine-embeddings"),
+    requireOpenClawSdkSubpath("openclaw/plugin-sdk/memory-core-host-embedding-registry")
+  );
+}
+function selectOpenClawMemoryEmbeddingSdk(currentSdk, legacySdk) {
+  return currentSdk ?? legacySdk;
+}
+function selectAdapter(adapters, requestedId) {
+  const valid = adapters.filter(isOpenClawEmbeddingAdapter);
+  if (valid.length === 0) return null;
+  if (requestedId) {
+    return valid.find((adapter) => adapter.id === requestedId) ?? null;
+  }
+  return valid[0] ?? null;
+}
+function isOpenClawEmbeddingAdapter(value) {
+  return Boolean(value) && typeof value === "object" && typeof value.id === "string" && typeof value.create === "function";
+}
+async function embedWithOpenClawProvider(_kind, provider, text, options) {
+  if (!provider || typeof provider !== "object") return null;
+  const record = provider;
+  if (options?.inputType === "query" && typeof record.embedQuery === "function") {
+    return normalizeHostEmbeddingVector(
+      await record.embedQuery.call(provider, text, { signal: options.signal })
+    );
+  }
+  if (typeof record.embed === "function") {
+    return normalizeHostEmbeddingVector(
+      await record.embed.call(provider, text, {
+        signal: options?.signal,
+        inputType: options?.inputType
+      })
+    );
+  }
+  if (typeof record.embedBatch === "function") {
+    const vectors = await record.embedBatch.call(provider, [text], {
+      signal: options?.signal,
+      inputType: options?.inputType
+    });
+    return normalizeHostEmbeddingVector(Array.isArray(vectors) ? vectors[0] : null);
+  }
+  return null;
+}
+async function embedBatchWithOpenClawProvider(kind, provider, texts, options) {
+  if (!provider || typeof provider !== "object") return texts.map(() => null);
+  const record = provider;
+  if (typeof record.embedBatch === "function") {
+    const vectors = await record.embedBatch.call(provider, texts, {
+      signal: options?.signal,
+      inputType: options?.inputType
+    });
+    return texts.map(
+      (_, index) => normalizeHostEmbeddingVector(Array.isArray(vectors) ? vectors[index] : null)
+    );
+  }
+  return Promise.all(
+    texts.map((text) => embedWithOpenClawProvider(kind, provider, text, options))
+  );
+}
 var sdkCaps;
 var NON_RUNTIME_REGISTRATION_MODES = /* @__PURE__ */ new Set([
   "discovery",
@@ -4644,10 +4878,47 @@ var pluginDefinition = {
         `[remnic] memory slot not assigned to ${serviceId}; running passively`
       );
     }
+    const channelEnvelopeCleaning = resolveChannelEnvelopePrefixes(cfg);
+    const cleanOpenClawUserMessage = createOpenClawUserMessageCleaner(
+      channelEnvelopeCleaning.prefixes,
+      {
+        includeLegacyChannelEnvelopePattern: channelEnvelopeCleaning.includeLegacyChannelEnvelopePattern
+      }
+    );
     const existing = globalThis[keys.ORCHESTRATOR];
     const orchestrator = existing?.recall ? existing : new Orchestrator(cfg);
     const isFirstRegistration = !globalThis[keys.REGISTERED_GUARD];
     globalThis[keys.REGISTERED_GUARD] = true;
+    const unregisterExistingHostEmbeddingProvider = () => {
+      const unregisterHostEmbedding = globalThis[keys.HOST_EMBEDDING_UNREGISTER];
+      unregisterHostEmbedding?.();
+      delete globalThis[keys.HOST_EMBEDDING_UNREGISTER];
+      delete globalThis[keys.HOST_EMBEDDING_SIGNATURE];
+    };
+    if (passiveMode) {
+      unregisterExistingHostEmbeddingProvider();
+    } else {
+      const hostEmbeddingSignature = openClawHostEmbeddingConfigSignature(
+        cfg,
+        api.config,
+        getOpenClawRuntimeWorkspaceDir(api)
+      );
+      const existingHostEmbeddingSignature = globalThis[keys.HOST_EMBEDDING_SIGNATURE];
+      if (globalThis[keys.HOST_EMBEDDING_UNREGISTER] && existingHostEmbeddingSignature !== hostEmbeddingSignature) {
+        unregisterExistingHostEmbeddingProvider();
+      }
+      if (!globalThis[keys.HOST_EMBEDDING_UNREGISTER]) {
+        const unregisterHostEmbedding = registerOpenClawHostEmbeddingProvider({
+          api,
+          cfg,
+          serviceId
+        });
+        if (unregisterHostEmbedding) {
+          globalThis[keys.HOST_EMBEDDING_UNREGISTER] = unregisterHostEmbedding;
+          globalThis[keys.HOST_EMBEDDING_SIGNATURE] = hostEmbeddingSignature;
+        }
+      }
+    }
     const hookApis = globalThis[keys.HOOK_APIS] ??= /* @__PURE__ */ new WeakSet();
     if (hookApis.has(api)) {
       logger_exports.log.debug(
@@ -4884,7 +5155,83 @@ Keep the reflection grounded in the evidence below.
       }
     );
     if (!passiveMode) {
-      let resolveStoredCodexThreadId2 = function(sessionKey) {
+      let rememberObservedInboundMessageId2 = function(messageKey) {
+        if (!observedInboundMessageIds.has(messageKey)) {
+          observedInboundMessageIds.add(messageKey);
+          observedInboundMessageIdOrder.push(messageKey);
+        }
+        while (observedInboundMessageIdOrder.length > MAX_OBSERVED_INBOUND_MESSAGE_IDS) {
+          const expired = observedInboundMessageIdOrder.shift();
+          if (expired) {
+            observedInboundMessageIds.delete(expired);
+            inboundReplyMetadataByMessageKey.delete(expired);
+          }
+        }
+      }, rememberObservedInboundMessageKeys2 = function(messageKeys) {
+        for (const messageKey of messageKeys) {
+          rememberObservedInboundMessageId2(messageKey);
+        }
+      }, rememberObservedInboundContentFingerprint2 = function(contentFingerprint) {
+        if (!contentFingerprint) return;
+        if (!observedInboundContentFingerprints.has(contentFingerprint)) {
+          observedInboundContentFingerprints.add(contentFingerprint);
+          observedInboundContentFingerprintOrder.push(contentFingerprint);
+        }
+        while (observedInboundContentFingerprintOrder.length > MAX_OBSERVED_INBOUND_MESSAGE_IDS) {
+          const expired = observedInboundContentFingerprintOrder.shift();
+          if (expired) observedInboundContentFingerprints.delete(expired);
+        }
+      }, rememberPendingSparseInboundContentFingerprint2 = function(contentFingerprint) {
+        if (!contentFingerprint) return;
+        if (!pendingSparseInboundContentFingerprints.has(contentFingerprint)) {
+          pendingSparseInboundContentFingerprints.add(contentFingerprint);
+          pendingSparseInboundContentFingerprintOrder.push(contentFingerprint);
+        }
+        while (pendingSparseInboundContentFingerprintOrder.length > MAX_OBSERVED_INBOUND_MESSAGE_IDS) {
+          const expired = pendingSparseInboundContentFingerprintOrder.shift();
+          if (expired) pendingSparseInboundContentFingerprints.delete(expired);
+        }
+      }, consumePendingSparseInboundContentFingerprint2 = function(contentFingerprint) {
+        if (!contentFingerprint || !pendingSparseInboundContentFingerprints.has(contentFingerprint)) {
+          return false;
+        }
+        pendingSparseInboundContentFingerprints.delete(contentFingerprint);
+        const index = pendingSparseInboundContentFingerprintOrder.indexOf(contentFingerprint);
+        if (index >= 0) pendingSparseInboundContentFingerprintOrder.splice(index, 1);
+        return true;
+      }, rememberInboundReplyMetadata2 = function(messageKeys, metadata) {
+        if (!metadata?.replyToBody?.trim()) return;
+        for (const messageKey of messageKeys) {
+          if (!inboundReplyMetadataByMessageKey.has(messageKey)) {
+            inboundReplyMetadataKeyOrder.push(messageKey);
+          }
+          inboundReplyMetadataByMessageKey.set(messageKey, metadata);
+        }
+        while (inboundReplyMetadataKeyOrder.length > MAX_OBSERVED_INBOUND_MESSAGE_IDS) {
+          const expired = inboundReplyMetadataKeyOrder.shift();
+          if (expired && !observedInboundMessageIds.has(expired)) {
+            inboundReplyMetadataByMessageKey.delete(expired);
+          }
+        }
+      }, getInboundReplyMetadata2 = function(messageKeys) {
+        for (const messageKey of messageKeys) {
+          const metadata = inboundReplyMetadataByMessageKey.get(messageKey);
+          if (metadata?.replyToBody?.trim()) return metadata;
+        }
+        return null;
+      }, rememberObservedInlineExplicitCaptureKey2 = function(noteKey) {
+        if (!observedInlineExplicitCaptureKeys.has(noteKey)) {
+          observedInlineExplicitCaptureKeys.add(noteKey);
+          observedInlineExplicitCaptureKeyOrder.push(noteKey);
+        }
+        while (observedInlineExplicitCaptureKeyOrder.length > MAX_OBSERVED_INLINE_EXPLICIT_CAPTURE_KEYS) {
+          const expired = observedInlineExplicitCaptureKeyOrder.shift();
+          if (expired) observedInlineExplicitCaptureKeys.delete(expired);
+        }
+      }, buildInlineExplicitCaptureDedupeKey2 = function(messageKey, note) {
+        if (!messageKey) return null;
+        return `${messageKey}:inline-memory-note:${createHash2("sha256").update(JSON.stringify(note)).digest("hex")}`;
+      }, resolveStoredCodexThreadId2 = function(sessionKey) {
         const threadId = codexThreadBySession.get(sessionKey);
         return typeof threadId === "string" && threadId.length > 0 ? threadId : null;
       }, resolveStoredCodexBufferKey2 = function(sessionKey) {
@@ -5171,7 +5518,7 @@ Keep the reflection grounded in the evidence below.
         const lowered = prompt.trim().toLowerCase();
         return lowered.startsWith("read heartbeat.md") || lowered.startsWith("run the following periodic tasks");
       };
-      var resolveStoredCodexThreadId = resolveStoredCodexThreadId2, resolveStoredCodexBufferKey = resolveStoredCodexBufferKey2, addSessionToCodexIndex = addSessionToCodexIndex2, removeSessionFromCodexIndex = removeSessionFromCodexIndex2, resolveCodexCompactionBaselineKey = resolveCodexCompactionBaselineKey2, resolveCodexPromptCacheKey = resolveCodexPromptCacheKey2, rememberCodexThread = rememberCodexThread2, forgetCodexThread = forgetCodexThread2, clearCodexCompatCaches = clearCodexCompatCaches2, hasExplicitProviderIdentity = hasExplicitProviderIdentity2, cachePromptMemoryLines = cachePromptMemoryLines2, consumePromptMemoryLines = consumePromptMemoryLines2, resolveSessionIdentity = resolveSessionIdentity2, hasBufferedTurns = hasBufferedTurns2, resolveExtractionBufferKey = resolveExtractionBufferKey2, buildMemoryContextLines = buildMemoryContextLines2, renderMemoryContextPrompt = renderMemoryContextPrompt2, isHeartbeatTrigger = isHeartbeatTrigger2, resolveHeartbeatPromptCandidates = resolveHeartbeatPromptCandidates2, matchHeartbeatEntry = matchHeartbeatEntry2, looksLikeHeartbeatPrompt = looksLikeHeartbeatPrompt2;
+      var rememberObservedInboundMessageId = rememberObservedInboundMessageId2, rememberObservedInboundMessageKeys = rememberObservedInboundMessageKeys2, rememberObservedInboundContentFingerprint = rememberObservedInboundContentFingerprint2, rememberPendingSparseInboundContentFingerprint = rememberPendingSparseInboundContentFingerprint2, consumePendingSparseInboundContentFingerprint = consumePendingSparseInboundContentFingerprint2, rememberInboundReplyMetadata = rememberInboundReplyMetadata2, getInboundReplyMetadata = getInboundReplyMetadata2, rememberObservedInlineExplicitCaptureKey = rememberObservedInlineExplicitCaptureKey2, buildInlineExplicitCaptureDedupeKey = buildInlineExplicitCaptureDedupeKey2, resolveStoredCodexThreadId = resolveStoredCodexThreadId2, resolveStoredCodexBufferKey = resolveStoredCodexBufferKey2, addSessionToCodexIndex = addSessionToCodexIndex2, removeSessionFromCodexIndex = removeSessionFromCodexIndex2, resolveCodexCompactionBaselineKey = resolveCodexCompactionBaselineKey2, resolveCodexPromptCacheKey = resolveCodexPromptCacheKey2, rememberCodexThread = rememberCodexThread2, forgetCodexThread = forgetCodexThread2, clearCodexCompatCaches = clearCodexCompatCaches2, hasExplicitProviderIdentity = hasExplicitProviderIdentity2, cachePromptMemoryLines = cachePromptMemoryLines2, consumePromptMemoryLines = consumePromptMemoryLines2, resolveSessionIdentity = resolveSessionIdentity2, hasBufferedTurns = hasBufferedTurns2, resolveExtractionBufferKey = resolveExtractionBufferKey2, buildMemoryContextLines = buildMemoryContextLines2, renderMemoryContextPrompt = renderMemoryContextPrompt2, isHeartbeatTrigger = isHeartbeatTrigger2, resolveHeartbeatPromptCandidates = resolveHeartbeatPromptCandidates2, matchHeartbeatEntry = matchHeartbeatEntry2, looksLikeHeartbeatPrompt = looksLikeHeartbeatPrompt2;
       const hooksPolicy = readPluginHooksPolicy(api.config, serviceId);
       const promptInjectionAllowed = coerceRawConfigBoolean(hooksPolicy?.allowPromptInjection) !== false;
       const useMemoryPromptSection = sdkCaps.hasRegisterMemoryPromptSection && typeof api.registerMemoryPromptSection === "function" && promptInjectionAllowed;
@@ -5183,7 +5530,62 @@ Keep the reflection grounded in the evidence below.
       const codexSessionsByThread = /* @__PURE__ */ new Map();
       const codexSessionsByBufferKey = /* @__PURE__ */ new Map();
       const codexMessageCountByBufferKey = /* @__PURE__ */ new Map();
+      const observedInboundMessageIds = /* @__PURE__ */ new Set();
+      const observedInboundMessageIdOrder = [];
+      const observedInboundContentFingerprints = /* @__PURE__ */ new Set();
+      const observedInboundContentFingerprintOrder = [];
+      const pendingSparseInboundContentFingerprints = /* @__PURE__ */ new Set();
+      const pendingSparseInboundContentFingerprintOrder = [];
+      const inboundReplyMetadataByMessageKey = /* @__PURE__ */ new Map();
+      const inboundReplyMetadataKeyOrder = [];
+      const observedInlineExplicitCaptureKeys = /* @__PURE__ */ new Set();
+      const observedInlineExplicitCaptureKeyOrder = [];
       let codexCompactionModeLogged = false;
+      async function processInlineExplicitCaptureNotes(notes, messageKeys) {
+        let processed = 0;
+        for (const note of notes) {
+          const noteKeys = (messageKeys ?? []).map((messageKey) => buildInlineExplicitCaptureDedupeKey2(messageKey, note)).filter((noteKey) => typeof noteKey === "string");
+          if (noteKeys.length > 0 && noteKeys.some((noteKey) => observedInlineExplicitCaptureKeys.has(noteKey))) {
+            continue;
+          }
+          try {
+            await (0, explicit_capture_exports.persistExplicitCapture)(
+              orchestrator,
+              (0, explicit_capture_exports.validateExplicitCaptureInput)(note),
+              "inline"
+            );
+            orchestrator.requestQmdMaintenanceForTool("inline.memory_note");
+            for (const noteKey of noteKeys) {
+              rememberObservedInlineExplicitCaptureKey2(noteKey);
+            }
+            processed += 1;
+          } catch (error) {
+            try {
+              const queued = await (0, explicit_capture_exports.queueExplicitCaptureForReview)(
+                orchestrator,
+                note,
+                "inline",
+                error
+              );
+              orchestrator.requestQmdMaintenanceForTool(
+                "inline.memory_note.review"
+              );
+              for (const noteKey of noteKeys) {
+                rememberObservedInlineExplicitCaptureKey2(noteKey);
+              }
+              processed += 1;
+              logger_exports.log.warn(
+                `explicit inline capture queued for review: ${queued.id}${queued.duplicateOf ? ` (duplicate of ${queued.duplicateOf})` : ""}`
+              );
+            } catch (queueError) {
+              logger_exports.log.warn(
+                `explicit inline capture rejected: ${error}; review queue fallback failed: ${queueError}`
+              );
+            }
+          }
+        }
+        return processed;
+      }
       async function flushAndForgetCodexThreadOnProviderSwitch(sessionKey, sessionIdentity) {
         if (sessionIdentity.isCodex || !sessionIdentity.previousCodexThreadId) {
           return;
@@ -6007,6 +6409,86 @@ Keep the reflection grounded in the evidence below.
         const capabilityDesc = typeof api.registerMemoryCapability === "function" ? `memory capability with publicArtifacts provider${builderDesc}` : "split memory runtime/flush-plan surfaces";
         logger_exports.log.info(`registered ${capabilityDesc}`);
       }
+      if (cfg.openclawMessageReceivedCaptureEnabled) {
+        api.on(
+          "message_received",
+          async (event, ctx) => {
+            if (cfg.heartbeat.enabled && cfg.heartbeat.gateExtractionDuringHeartbeat && isHeartbeatTrigger2(event, ctx)) {
+              logger_exports.log.debug(
+                `message_received: skipping transcript capture during heartbeat run for ${ctx?.sessionKey ?? "default"}`
+              );
+              return;
+            }
+            const content = typeof event.content === "string" ? event.content.trim() : "";
+            if (content.length === 0) return;
+            const sessionKey = normalizeOptionalString(ctx.sessionKey) ?? normalizeOptionalString(event.sessionKey) ?? "default";
+            const inboundMessageKeys = getOpenClawMessageDedupeKeys(event, event, ctx, sessionKey);
+            if (inboundMessageKeys.some((key) => observedInboundMessageIds.has(key))) return;
+            const metadata = buildOpenClawMessageMetadata(event, event, ctx, cfg);
+            const inboundReplyHintMetadata = cfg.openclawReplyMetadataExtractionHintsEnabled ? buildOpenClawMessageMetadata(event, event, ctx, {
+              openclawReplyMetadataCaptureEnabled: true
+            }) : metadata;
+            const eventDate = typeof event.timestamp === "number" && Number.isFinite(event.timestamp) ? new Date(event.timestamp) : /* @__PURE__ */ new Date();
+            const timestamp = Number.isFinite(eventDate.getTime()) ? eventDate.toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+            const cleaned = cleanOpenClawUserMessage(content);
+            const inlineCaptureEnabled = (0, explicit_capture_exports.shouldProcessInlineExplicitCapture)(
+              orchestrator.config
+            );
+            const explicitNotes = inlineCaptureEnabled ? (0, explicit_capture_exports.parseInlineExplicitCaptureNotes)(cleaned) : [];
+            const transcriptContent = inlineCaptureEnabled && (0, explicit_capture_exports.hasInlineExplicitCaptureMarkup)(cleaned) ? (0, explicit_capture_exports.stripInlineExplicitCaptureNotes)(cleaned) : cleaned;
+            const inboundContentFingerprint = buildOpenClawInboundContentFingerprint(
+              transcriptContent,
+              event,
+              event,
+              ctx,
+              sessionKey
+            );
+            const sparseInboundContentFingerprint = buildOpenClawSparseInboundContentFingerprint(
+              transcriptContent,
+              sessionKey
+            );
+            if (inboundContentFingerprint && observedInboundContentFingerprints.has(inboundContentFingerprint)) {
+              return;
+            }
+            const inlineCaptureDedupeKeys = inboundMessageKeys.length > 0 ? inboundMessageKeys : inboundContentFingerprint ? [inboundContentFingerprint] : sparseInboundContentFingerprint ? [sparseInboundContentFingerprint] : [];
+            const processedExplicitNotes = explicitNotes.length > 0 ? await processInlineExplicitCaptureNotes(
+              explicitNotes,
+              inlineCaptureDedupeKeys
+            ) : 0;
+            if (!orchestrator.config.transcriptEnabled || transcriptContent.length === 0) {
+              rememberInboundReplyMetadata2(inboundMessageKeys, inboundReplyHintMetadata);
+              if (processedExplicitNotes > 0) {
+                rememberObservedInboundMessageKeys2(inboundMessageKeys);
+                rememberObservedInboundContentFingerprint2(inboundContentFingerprint);
+                if (inboundMessageKeys.length === 0) {
+                  rememberPendingSparseInboundContentFingerprint2(sparseInboundContentFingerprint);
+                }
+              }
+              return;
+            }
+            try {
+              await orchestrator.transcript.append({
+                timestamp,
+                role: "user",
+                content: transcriptContent,
+                sessionKey,
+                turnId: crypto.randomUUID(),
+                ...metadata ? { metadata } : {}
+              });
+              if (inboundMessageKeys.length > 0) {
+                rememberObservedInboundMessageKeys2(inboundMessageKeys);
+                rememberInboundReplyMetadata2(inboundMessageKeys, inboundReplyHintMetadata);
+              }
+              rememberObservedInboundContentFingerprint2(inboundContentFingerprint);
+              if (inboundMessageKeys.length === 0) {
+                rememberPendingSparseInboundContentFingerprint2(sparseInboundContentFingerprint);
+              }
+            } catch (err) {
+              logger_exports.log.debug(`message_received transcript append failed: ${err}`);
+            }
+          }
+        );
+      }
       api.on(
         "agent_end",
         async (event, ctx) => {
@@ -6089,52 +6571,58 @@ Keep the reflection grounded in the evidence below.
               const role = rawRole;
               const content = extractTextContent(msg);
               if (content.length < 10) continue;
-              const cleaned = role === "user" ? cleanUserMessage(content) : content;
+              const cleaned = role === "user" ? cleanOpenClawUserMessage(content) : content;
               const inlineCaptureEnabled = (0, explicit_capture_exports.shouldProcessInlineExplicitCapture)(
                 orchestrator.config
               );
               const explicitNotes = inlineCaptureEnabled ? (0, explicit_capture_exports.parseInlineExplicitCaptureNotes)(cleaned) : [];
               const stripped = inlineCaptureEnabled && (0, explicit_capture_exports.hasInlineExplicitCaptureMarkup)(cleaned) ? (0, explicit_capture_exports.stripInlineExplicitCaptureNotes)(cleaned) : cleaned;
-              for (const note of explicitNotes) {
-                try {
-                  await (0, explicit_capture_exports.persistExplicitCapture)(
-                    orchestrator,
-                    (0, explicit_capture_exports.validateExplicitCaptureInput)(note),
-                    "inline"
-                  );
-                  orchestrator.requestQmdMaintenanceForTool("inline.memory_note");
-                } catch (error) {
-                  try {
-                    const queued = await (0, explicit_capture_exports.queueExplicitCaptureForReview)(
-                      orchestrator,
-                      note,
-                      "inline",
-                      error
-                    );
-                    orchestrator.requestQmdMaintenanceForTool(
-                      "inline.memory_note.review"
-                    );
-                    logger_exports.log.warn(
-                      `explicit inline capture queued for review: ${queued.id}${queued.duplicateOf ? ` (duplicate of ${queued.duplicateOf})` : ""}`
-                    );
-                  } catch (queueError) {
-                    logger_exports.log.warn(
-                      `explicit inline capture rejected: ${error}; review queue fallback failed: ${queueError}`
-                    );
-                  }
-                }
-              }
-              if (orchestrator.config.transcriptEnabled && stripped.length > 0) {
+              const messageMetadata = buildOpenClawMessageMetadata(
+                msg,
+                event,
+                ctx,
+                cfg
+              );
+              const messageDedupeKeys = getOpenClawMessageDedupeKeys(msg, event, ctx, sessionKey);
+              const messageContentFingerprint = buildOpenClawInboundContentFingerprint(
+                stripped,
+                msg,
+                event,
+                ctx,
+                sessionKey
+              );
+              const sparseMessageContentFingerprint = buildOpenClawSparseInboundContentFingerprint(stripped, sessionKey);
+              const cachedReplyHintMetadata = role === "user" && cfg.openclawReplyMetadataExtractionHintsEnabled ? getInboundReplyMetadata2(messageDedupeKeys) : null;
+              const replyHintMetadata = cfg.openclawReplyMetadataExtractionHintsEnabled ? cachedReplyHintMetadata ?? buildOpenClawMessageMetadata(msg, event, ctx, {
+                openclawReplyMetadataCaptureEnabled: true
+              }) : messageMetadata;
+              const messageDedupeKey = messageDedupeKeys[0];
+              const sparseInboundAlreadyCaptured = role === "user" && messageDedupeKeys.length === 0 && consumePendingSparseInboundContentFingerprint2(sparseMessageContentFingerprint);
+              const transcriptAlreadyCaptured = role === "user" && (messageDedupeKeys.length > 0 && messageDedupeKeys.some((key) => observedInboundMessageIds.has(key)) || sparseInboundAlreadyCaptured || messageContentFingerprint !== null && observedInboundContentFingerprints.has(messageContentFingerprint));
+              const inlineCaptureDedupeKeys = messageDedupeKeys.length > 0 ? messageDedupeKeys : messageContentFingerprint ? [messageContentFingerprint] : sparseMessageContentFingerprint ? [sparseMessageContentFingerprint] : [];
+              await processInlineExplicitCaptureNotes(
+                explicitNotes,
+                inlineCaptureDedupeKeys
+              );
+              if (orchestrator.config.transcriptEnabled && stripped.length > 0 && !transcriptAlreadyCaptured) {
                 await orchestrator.transcript.append({
                   timestamp: eventTimestamp,
                   role,
                   content: stripped,
                   sessionKey,
-                  turnId: crypto.randomUUID()
+                  turnId: crypto.randomUUID(),
+                  ...messageMetadata ? { metadata: messageMetadata } : {}
                 });
+                if (role === "user") {
+                  if (messageDedupeKey) {
+                    rememberObservedInboundMessageKeys2(messageDedupeKeys);
+                  }
+                  rememberObservedInboundContentFingerprint2(messageContentFingerprint);
+                }
               }
               if (stripped.length > 0) {
-                await orchestrator.processTurn(role, stripped, sessionKey, {
+                const extractionContent = role === "user" && cfg.openclawReplyMetadataExtractionHintsEnabled ? withReplyExtractionHint(stripped, replyHintMetadata) : stripped;
+                await orchestrator.processTurn(role, extractionContent, sessionKey, {
                   bufferKey: resolveExtractionBufferKey2(
                     sessionKey,
                     sessionIdentity.logicalSessionKey
@@ -6143,7 +6631,7 @@ Keep the reflection grounded in the evidence below.
                   providerThreadId: sessionIdentity.providerThreadId,
                   turnFingerprint: buildTurnFingerprint({
                     role,
-                    content: stripped,
+                    content: extractionContent,
                     logicalSessionKey: sessionIdentity.logicalSessionKey,
                     providerThreadId: sessionIdentity.providerThreadId,
                     maxContentChars: cfg.extractionMaxTurnChars,
@@ -6990,6 +7478,10 @@ Keep the reflection grounded in the evidence below.
           stopHeartbeatWatcher = null;
           removeDreamingObserver?.();
           removeDreamingObserver = null;
+          const unregisterOpenClawHostEmbeddingProvider = globalThis[keys.HOST_EMBEDDING_UNREGISTER];
+          unregisterOpenClawHostEmbeddingProvider?.();
+          delete globalThis[keys.HOST_EMBEDDING_UNREGISTER];
+          delete globalThis[keys.HOST_EMBEDDING_SIGNATURE];
           delete globalThis[keys.ACCESS_HTTP_SERVER];
           delete globalThis[keys.ACCESS_HTTP_AUTH_STATE];
           delete globalThis[keys.ACCESS_SERVICE];
@@ -7025,6 +7517,97 @@ function extractTextContent(msg) {
   }
   return "";
 }
+function buildOpenClawMessageMetadata(message, event, ctx, cfg) {
+  if (!cfg.openclawReplyMetadataCaptureEnabled) return null;
+  const metadata = {};
+  const messageId = getOpenClawMessageId(message, event, ctx);
+  if (messageId) metadata.messageId = truncateMetadataValue(messageId, 512);
+  const threadId = normalizeThreadId(message.threadId) ?? normalizeThreadId(event.threadId) ?? normalizeThreadId(ctx.threadId);
+  if (threadId) metadata.threadId = truncateMetadataValue(threadId, 512);
+  const replyToId = normalizeOptionalString(message.replyToId) ?? normalizeOptionalString(event.replyToId) ?? normalizeOptionalString(ctx.replyToId);
+  if (replyToId) metadata.replyToId = truncateMetadataValue(replyToId, 512);
+  const replyToBody = normalizeOptionalString(message.replyToBody) ?? normalizeOptionalString(event.replyToBody) ?? normalizeOptionalString(ctx.replyToBody);
+  if (replyToBody) metadata.replyToBody = truncateMetadataValue(replyToBody, 1e3);
+  const replyToSender = normalizeOptionalString(message.replyToSender) ?? normalizeOptionalString(event.replyToSender) ?? normalizeOptionalString(ctx.replyToSender);
+  if (replyToSender) metadata.replyToSender = truncateMetadataValue(replyToSender, 256);
+  return Object.keys(metadata).length > 0 ? metadata : null;
+}
+function getOpenClawMessageId(message, event, ctx) {
+  const messageId = normalizeOptionalString(message.messageId) ?? normalizeOptionalString(event.messageId) ?? normalizeOptionalString(ctx.messageId);
+  return messageId ? truncateMetadataValue(messageId, 512) : void 0;
+}
+function getOpenClawMessageDedupeKeys(message, event, ctx, sessionKey) {
+  const messageId = getOpenClawMessageId(message, event, ctx);
+  if (!messageId) return [];
+  const sessionScope = normalizeOptionalString(message.sessionKey) ?? normalizeOptionalString(event.sessionKey) ?? normalizeOptionalString(ctx.sessionKey) ?? sessionKey;
+  const threadScope = truncateMetadataValue(
+    normalizeThreadId(message.threadId) ?? normalizeThreadId(event.threadId) ?? normalizeThreadId(ctx.threadId) ?? "",
+    512
+  );
+  const runScope = truncateMetadataValue(
+    normalizeOptionalString(message.runId) ?? normalizeOptionalString(event.runId) ?? normalizeOptionalString(ctx.runId) ?? "",
+    512
+  );
+  const sessionPart = truncateMetadataValue(sessionScope, 512);
+  const dedupeScopes = /* @__PURE__ */ new Set();
+  if (threadScope) dedupeScopes.add(threadScope);
+  if (runScope) dedupeScopes.add(runScope);
+  dedupeScopes.add("");
+  return [...dedupeScopes].map((scope) => `${sessionPart}\0${scope}\0${messageId}`);
+}
+function buildOpenClawInboundContentFingerprint(content, message, event, ctx, sessionKey) {
+  const normalizedContent = content.trim();
+  if (!normalizedContent) return null;
+  const sessionPart = truncateMetadataValue(sessionKey || "default", 512);
+  const runScope = truncateMetadataValue(
+    normalizeOptionalString(message.runId) ?? normalizeOptionalString(event.runId) ?? normalizeOptionalString(ctx.runId) ?? "",
+    512
+  );
+  const rawTimestamp = normalizeOptionalString(message.timestamp) ?? normalizeOptionalString(event.timestamp) ?? normalizeOptionalString(ctx.timestamp) ?? (typeof message.timestamp === "number" && Number.isFinite(message.timestamp) ? String(message.timestamp) : void 0) ?? (typeof event.timestamp === "number" && Number.isFinite(event.timestamp) ? String(event.timestamp) : void 0) ?? (typeof ctx.timestamp === "number" && Number.isFinite(ctx.timestamp) ? String(ctx.timestamp) : void 0);
+  const timestampScope = rawTimestamp ? truncateMetadataValue(rawTimestamp, 512) : "";
+  if (!runScope && !timestampScope) return null;
+  const threadScope = truncateMetadataValue(
+    normalizeThreadId(message.threadId) ?? normalizeThreadId(event.threadId) ?? normalizeThreadId(ctx.threadId) ?? "",
+    512
+  );
+  const contentHash = createHash2("sha256").update(normalizedContent).digest("hex");
+  return [
+    sessionPart,
+    "content",
+    threadScope,
+    runScope,
+    timestampScope,
+    contentHash
+  ].join("\0");
+}
+function buildOpenClawSparseInboundContentFingerprint(content, sessionKey) {
+  const normalizedContent = content.trim();
+  if (!normalizedContent) return null;
+  const sessionPart = truncateMetadataValue(sessionKey || "default", 512);
+  const contentHash = createHash2("sha256").update(normalizedContent).digest("hex");
+  return `${sessionPart}\0sparse-content\0${contentHash}`;
+}
+function withReplyExtractionHint(content, metadata) {
+  const replyBody = metadata?.replyToBody?.trim();
+  if (!replyBody) return content;
+  const sender = metadata?.replyToSender?.trim();
+  const prefix = sender ? `Reply context from ${sender}: ${replyBody}` : `Reply context: ${replyBody}`;
+  return `${prefix}
+
+Current message: ${content}`;
+}
+function normalizeOptionalString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function normalizeThreadId(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return normalizeOptionalString(value);
+}
+function truncateMetadataValue(value, maxChars) {
+  return value.length <= maxChars ? value : value.slice(0, maxChars);
+}
 
 // src/bridge.ts
 import fs from "fs";
@@ -7273,4 +7856,4 @@ async function checkDaemonHealth(host, port) {
   }
 }
 var export_loadDaySummaryPrompt = day_summary_exports.loadDaySummaryPrompt;
-export { checkDaemonHealth, src_default as default, detectBridgeMode, listRemnicPublicArtifacts, export_loadDaySummaryPrompt as loadDaySummaryPrompt, loadHourlySummaryCronJobsData, parseHourlySummaryCronJobsData };
+export { checkDaemonHealth, src_default as default, detectBridgeMode, embedWithOpenClawProvider, listRemnicPublicArtifacts, export_loadDaySummaryPrompt as loadDaySummaryPrompt, loadHourlySummaryCronJobsData, loadOpenClawMemoryEmbeddingSdk, parseHourlySummaryCronJobsData, selectOpenClawMemoryEmbeddingSdk };

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.563",
+  "version": "9.3.564",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
   "setup": {
@@ -371,6 +371,19 @@
         "default": "auto",
         "description": "Embedding provider selection for semantic fallback"
       },
+      "hostEmbeddingProviderEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Prefer OpenClaw host-registered embedding providers for Remnic's semantic fallback and embedded vector backends when the OpenClaw SDK exposes them. Falls back to Remnic's existing embedding provider path on older hosts or provider setup failures."
+      },
+      "hostEmbeddingProviderId": {
+        "type": "string",
+        "description": "Optional OpenClaw embedding provider adapter id to use. Leave unset for automatic selection from OpenClaw's memory/generic embedding provider registry."
+      },
+      "hostEmbeddingProviderModel": {
+        "type": "string",
+        "description": "Optional embedding model id passed to the selected OpenClaw host embedding provider."
+      },
       "embeddingFallbackModel": {
         "type": "string",
         "description": "Optional model identifier for embedding fallback requests. Defaults to localLlmModel for legacy installs."
@@ -801,6 +814,26 @@
         "default": 600,
         "description": "Maximum snippet size returned by the OpenClaw memory tool adapters."
       },
+      "openclawMessageReceivedCaptureEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Capture OpenClaw message_received hook content into transcripts when that hook is emitted by the host. Older OpenClaw versions that never emit the hook continue through agent_end capture."
+      },
+      "openclawReplyMetadataCaptureEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Persist bounded OpenClaw messageId, threadId, replyToId, replyToBody, and replyToSender fields in transcript metadata when available."
+      },
+      "openclawReplyMetadataExtractionHintsEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "When true, prepend bounded quoted-reply context to user turns before Remnic extraction. Leave false to store reply metadata without changing extraction behavior."
+      },
+      "openclawChannelEnvelopeCleaningEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Use OpenClaw's canonical chat-channel envelope prefixes when the SDK exposes plugin-sdk/chat-channel-ids, while keeping the legacy OpenClaw-only cleaner on older hosts."
+      },
       "sessionTogglesEnabled": {
         "type": "boolean",
         "default": true,
@@ -4883,6 +4916,41 @@
       "label": "Enable QMD",
       "help": "Enable QMD for memory search/indexing"
     },
+    "hostEmbeddingProviderEnabled": {
+      "label": "Use Host Embeddings",
+      "advanced": true,
+      "help": "Prefer OpenClaw's registered embedding providers when available; Remnic falls back automatically."
+    },
+    "hostEmbeddingProviderId": {
+      "label": "Host Embedding Provider",
+      "advanced": true,
+      "placeholder": "openai-compatible"
+    },
+    "hostEmbeddingProviderModel": {
+      "label": "Host Embedding Model",
+      "advanced": true,
+      "placeholder": "text-embedding-3-small"
+    },
+    "openclawMessageReceivedCaptureEnabled": {
+      "label": "Capture Inbound Messages",
+      "advanced": true,
+      "help": "Use OpenClaw message_received transcript capture when the host emits it."
+    },
+    "openclawReplyMetadataCaptureEnabled": {
+      "label": "Capture Reply Metadata",
+      "advanced": true,
+      "help": "Store bounded message/thread/reply fields in transcript metadata."
+    },
+    "openclawReplyMetadataExtractionHintsEnabled": {
+      "label": "Use Reply Extraction Hints",
+      "advanced": true,
+      "help": "Include bounded quoted-reply context in extraction prompts. Off by default."
+    },
+    "openclawChannelEnvelopeCleaningEnabled": {
+      "label": "Clean Channel Envelopes",
+      "advanced": true,
+      "help": "Use OpenClaw's canonical channel envelope prefixes when available."
+    },
     "qmdCollection": {
       "label": "QMD Collection",
       "advanced": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "9.3.563",
+  "version": "9.3.564",
   "description": "OpenClaw adapter for Remnic memory with bundled @remnic/core runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -28,11 +28,11 @@
       "./dist/index.js"
     ],
     "compat": {
-      "pluginApi": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.2-alpha.1"
+      "pluginApi": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.2-alpha.1 || 2026.6.2-alpha.2"
     },
     "build": {
-      "openclawVersion": "2026.6.2-alpha.1",
-      "pluginSdkVersion": "2026.6.2-alpha.1"
+      "openclawVersion": "2026.6.2-alpha.2",
+      "pluginSdkVersion": "2026.6.2-alpha.2"
     },
     "install": {
       "clawhubSpec": "clawhub:@remnic/plugin-openclaw",
@@ -72,17 +72,17 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.0",
     "openai": "^6.0.0",
-    "@remnic/core": "^9.3.563"
+    "@remnic/core": "^9.3.564"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.2-alpha.1"
+    "openclaw": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.2-alpha.1 || 2026.6.2-alpha.2"
   },
   "devDependencies": {
     "@openclaw/plugin-inspector": "0.3.10",
     "acorn": "^8.16.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "@remnic/core": "^9.3.563"
+    "@remnic/core": "^9.3.564"
   },
   "license": "MIT",
   "repository": {