@romiluz/clawmongo 2026.3.25 → 2026.3.27

package/README.md

@@ -94,16 +94,28 @@ Full comparison with migration guidance: [ClawMongo vs Default Memory](docs/refe
 ClawMongo uses a canonical-truth-first architecture where **events are the single source of truth**. Everything else -- chunks, entities, relations, episodes, procedures -- is derived.
 
 ```text
-Inbound message / tool output
-  -> writeEventAndProject()
-       |
-       +-- events collection          (canonical, append-only)
-       +-- chunks collection          (projected from events, searchable)
-       +-- ingest_runs collection     (operational audit trail)
-       |
-       +-- extractAndUpsertEntities() (fire-and-forget)
-            +-- entities collection    (@mentions, #tags, URLs, paths, quoted names)
-            +-- relations collection   (links between entities, weighted, typed)
+Write Path:
+  Message / tool output -> writeEventAndProject()
+                           +-> events       (canonical, append-only)
+                           +-> chunks       (projected, searchable)
+                           +-> ingest_runs  (audit trail)
+                           +-> extractAndUpsertEntities()
+                                +-> entities   (@mentions, #tags, URLs, quoted names)
+                                +-> relations  (links between entities, weighted)
+                           +-> checkAutoEpisodeTriggers()
+                                +-> episodes   (materialized from event windows)
+
+Retrieval Path:
+  Query -> planRetrieval() -> score 8 paths by keyword heuristics
+           +-> active-critical  (high-salience recent)
+           +-> structured       (facts, preferences)
+           +-> episodic         (summarized threads)
+           +-> graph            ($graphLookup traversal)
+           +-> kb               (knowledge base docs)
+           +-> hybrid           ($rankFusion vector+text)
+           +-> raw-window       (recent events)
+           +-> procedural       (workflows)
+           -> rerankResults() -> deduplicate -> return to agent
 ```
 
 ### 20 Collections

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.3.25",
-  "commit": "ba55574d91f05487cbb2a81d269f9fe6528ec6f6",
-  "builtAt": "2026-03-22T11:51:16.866Z"
+  "version": "2026.3.27",
+  "commit": "20b81dc4cd0ac44e9001aa983753d9c0ec350205",
+  "builtAt": "2026-03-22T14:32:34.167Z"
 }

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-5cab91a06ed476e677050b89861baed3d839d13f1e94afd4b47dc984fce7faf2
+394a5d9034f4a78cfa90af252bc6079f55f43b523c7389e72038ef3d47cbd6b0

package/dist/{command-registry-8LCMETl9.js → command-registry-BEExVzem.js}

@@ -7,7 +7,7 @@ import "./subsystem-VzQeL-96.js";
 import "./ansi-BEJF8NKS.js";
 import "./boolean-C3GkJetE.js";
 import "./env-mRJH5TpF.js";
-import "./register.subclis-CfWnUdTd.js";
+import "./register.subclis-BlqPR8UO.js";
 import "./core-command-descriptors-LG6MYVik.js";
-import { n as registerCoreCliByName } from "./command-registry-HhghuS_n.js";
+import { n as registerCoreCliByName } from "./command-registry-Bow_kWfU.js";
 export { registerCoreCliByName };

package/dist/{command-registry-HhghuS_n.js → command-registry-Bow_kWfU.js}

@@ -1,5 +1,5 @@
 import { E as getPrimaryCommand, k as hasHelpOrVersion } from "./logger-CoEtkjhn.js";
-import { a as removeCommandByName, i as registerSubCliCommands, o as reparseProgramFromActionArgs } from "./register.subclis-CfWnUdTd.js";
+import { a as removeCommandByName, i as registerSubCliCommands, o as reparseProgramFromActionArgs } from "./register.subclis-BlqPR8UO.js";
 import { t as getCoreCliCommandDescriptors } from "./core-command-descriptors-LG6MYVik.js";
 //#region src/cli/program/command-registry.ts
 const shouldRegisterCorePrimaryOnly = (argv) => {
@@ -14,7 +14,7 @@ const coreEntries = [
 			hasSubcommands: false
 		}],
 		register: async ({ program }) => {
-			(await import("./register.setup-DTrlyJlW.js")).registerSetupCommand(program);
+			(await import("./register.setup-BD774nEM.js")).registerSetupCommand(program);
 		}
 	},
 	{
@@ -24,7 +24,7 @@ const coreEntries = [
 			hasSubcommands: false
 		}],
 		register: async ({ program }) => {
-			(await import("./register.onboard-DemZm7YR.js")).registerOnboardCommand(program);
+			(await import("./register.onboard-GSGJTcJk.js")).registerOnboardCommand(program);
 		}
 	},
 	{
@@ -81,7 +81,7 @@ const coreEntries = [
 			}
 		],
 		register: async ({ program }) => {
-			(await import("./register.maintenance-DVakq6Gu.js")).registerMaintenanceCommands(program);
+			(await import("./register.maintenance-CjOZ-w_0.js")).registerMaintenanceCommands(program);
 		}
 	},
 	{

package/dist/{completion-cli-CjPcdpbr.js → completion-cli-B4hJ8HjW.js}

@@ -9,8 +9,8 @@ import "./boolean-C3GkJetE.js";
 import "./env-mRJH5TpF.js";
 import "./utils-seFh26xW.js";
 import "./links-kyhxxZ1i.js";
-import { a as registerCompletionCli } from "./completion-cli-Ujj0nwzr.js";
-import "./register.subclis-CfWnUdTd.js";
-import "./command-registry-HhghuS_n.js";
+import { a as registerCompletionCli } from "./completion-cli-DQrts0Ip.js";
+import "./register.subclis-BlqPR8UO.js";
+import "./command-registry-Bow_kWfU.js";
 import "./program-context-BoWQV6OT.js";
 export { registerCompletionCli };

package/dist/{completion-cli-Ujj0nwzr.js → completion-cli-DQrts0Ip.js}

@@ -3,8 +3,8 @@ import { r as theme } from "./theme-CdOoMzRk.js";
 import { c as routeLogsToStderr } from "./subsystem-VzQeL-96.js";
 import { h as pathExists } from "./utils-seFh26xW.js";
 import { t as formatDocsLink } from "./links-kyhxxZ1i.js";
-import { r as registerSubCliByName, t as getSubCliEntries } from "./register.subclis-CfWnUdTd.js";
-import { n as registerCoreCliByName, t as getCoreCliCommandNames } from "./command-registry-HhghuS_n.js";
+import { r as registerSubCliByName, t as getSubCliEntries } from "./register.subclis-BlqPR8UO.js";
+import { n as registerCoreCliByName, t as getCoreCliCommandNames } from "./command-registry-Bow_kWfU.js";
 import { t as getProgramContext } from "./program-context-BoWQV6OT.js";
 import path from "node:path";
 import os from "node:os";

package/dist/{doctor-completion-D4wCwykH.js → doctor-completion-Dk8sgMOd.js}

@@ -1,7 +1,7 @@
 import { n as resolveOpenClawPackageRoot } from "./openclaw-root-CwSo78_f.js";
 import { n as resolveCliName } from "./cli-name-CflIHvyV.js";
 import { t as note } from "./note-BnDVMCVo.js";
-import { c as usesSlowDynamicCompletion, i as isCompletionInstalled, o as resolveCompletionCachePath, r as installCompletion, s as resolveShellFromEnv, t as completionCacheExists } from "./completion-cli-Ujj0nwzr.js";
+import { c as usesSlowDynamicCompletion, i as isCompletionInstalled, o as resolveCompletionCachePath, r as installCompletion, s as resolveShellFromEnv, t as completionCacheExists } from "./completion-cli-DQrts0Ip.js";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 //#region src/commands/doctor-completion.ts

package/dist/entry.js

@@ -199,7 +199,7 @@ function tryHandleRootHelpFastPath(argv, deps = {}) {
 }
 function runMainOrRootHelp(argv) {
 	if (tryHandleRootHelpFastPath(argv)) return;
-	import("./run-main-D88e0mh0.js").then(({ runCli }) => runCli(argv)).catch((error) => {
+	import("./run-main-C4Box4Zo.js").then(({ runCli }) => runCli(argv)).catch((error) => {
 		console.error("[openclaw] Failed to start CLI:", error instanceof Error ? error.stack ?? error.message : error);
 		process$1.exitCode = 1;
 	});

package/dist/{gateway-cli-BpLqS4sE.js → gateway-cli-BAueAYsk.js}

@@ -236,7 +236,7 @@ import { _ as computePreviousRunAtMs, g as computeNextRunAtMs, h as coerceFinite
 import { a as resolveNpmChannelTag, n as compareSemverStrings, p as normalizeUpdateChannel, t as checkUpdateStatus } from "./update-check-8M6LXFES.js";
 import { r as resolveConfiguredDeferredChannelPluginIds } from "./channel-plugin-ids-DfzIFHve.js";
 import "./setup.secret-input-DALXyJR2.js";
-import { t as runSetupWizard } from "./setup-C-dv8809.js";
+import { t as runSetupWizard } from "./setup-CjQJLNqB.js";
 import { a as resolveApnsAuthConfigFromEnv, c as shouldClearStoredApnsRegistration, d as parseMessageWithAttachments, f as formatForLog, g as setGatewayWsLogStyle, h as summarizeAgentEventForWsLog, l as resolveApnsRelayConfigFromEnv, m as shouldLogWs, n as loadApnsRegistration, o as sendApnsAlert, p as logWs, r as normalizeApnsEnvironment, s as sendApnsBackgroundWake, t as clearApnsRegistrationIfCurrent, u as normalizeRpcAttachmentsToChatAttachments } from "./push-apns-DQN5pcl6.js";
 import { _ as buildGogWatchStartArgs, g as buildGogWatchServeArgs, i as ensureTailscaleEndpoint, w as resolveGmailHookRuntimeConfig } from "./gmail-setup-utils-DvwS5fry.js";
 import { i as loadAgentIdentity, o as pruneAgentConfig, r as findAgentEntryIndex, t as applyAgentConfig } from "./agents.config-CDS6iAat.js";

package/dist/index.js

@@ -29,7 +29,7 @@ let saveSessionStore;
 let toWhatsappJid;
 let waitForever;
 async function loadLegacyCliDeps() {
-	const [{ installGaxiosFetchCompat }, { runCli }] = await Promise.all([import("./gaxios-fetch-compat-CZFw_C-b.js"), import("./run-main-D88e0mh0.js")]);
+	const [{ installGaxiosFetchCompat }, { runCli }] = await Promise.all([import("./gaxios-fetch-compat-CZFw_C-b.js"), import("./run-main-C4Box4Zo.js")]);
 	return {
 		installGaxiosFetchCompat,
 		runCli

package/dist/{onboard-c0331xiO.js → onboard-BF8cNljJ.js}

@@ -10,7 +10,7 @@ import "./daemon-runtime-DZ89fADl.js";
 import { a as ensureWorkspaceAndSessions, b as waitForGatewayReachable, c as handleReset, g as resolveControlUiLinks, m as randomToken, n as applyWizardMetadata, t as DEFAULT_WORKSPACE, u as normalizeGatewayTokenInput } from "./onboard-helpers-D3xV_T96.js";
 import { t as WizardCancelledError } from "./prompts-si9A7fzB.js";
 import { t as createClackPrompter } from "./clack-prompter-QEV3P7rT.js";
-import { t as runSetupWizard } from "./setup-C-dv8809.js";
+import { t as runSetupWizard } from "./setup-CjQJLNqB.js";
 import { n as logConfigUpdated } from "./logging-BM4mQ53W.js";
 import { i as resolveManifestProviderOnboardAuthFlags } from "./provider-auth-choices-BfWvatIg.js";
 import { n as isDeprecatedAuthChoice, r as normalizeLegacyOnboardAuthChoice } from "./auth-choice-legacy-DrWHCwV-.js";

package/dist/{onboarding-memory-DNeHKyRz.js → onboarding-memory-CTB-Vkbl.js}

@@ -12,6 +12,7 @@ import "./logger-DtlnPe_E.js";
 import "./exec-BnXF7JCz.js";
 import { t as resolveOpenClawPackageName } from "./openclaw-root-CwSo78_f.js";
 import "./workspace-DuH1agxz.js";
+import { t as WizardCancelledError } from "./prompts-si9A7fzB.js";
 import path from "node:path";
 import "node:fs/promises";
 //#region src/wizard/onboarding-memory.ts
@@ -19,19 +20,18 @@ function shouldShowNoDockerHint(reason) {
 	const lower = reason.toLowerCase();
 	return lower.includes("docker") || lower.includes("compose");
 }
-async function showNoDockerLocalHint(prompter) {
+async function showDockerRequiredHint(prompter) {
 	await prompter.note([
-		"Docker is optional. Local MongoDB works without Docker.",
+		"Docker is required for ClawMongo. The mongodb-atlas-local:preview Docker image bundles mongod + mongot in one container.",
 		"",
-		"Standalone (basic):",
-		"  mongod --dbpath ./data/db --port 27017",
+		"Install Docker Desktop: https://docs.docker.com/get-docker/",
 		"",
-		"Replica set (recommended for transactions + change streams):",
-		"  mongod --dbpath ./data/db --port 27017 --replSet rs0",
-		"  mongosh --eval \"rs.initiate()\"",
+		"Then start atlas-local:",
+		"  ./docker/mongodb/start-preview.sh",
 		"",
-		"Then continue with URI: mongodb://localhost:27017/openclaw"
-	].join("\n"), "Local MongoDB (No Docker)");
+		"Or manually:",
+		"  docker run -d -p 27017:27017 -e VOYAGE_API_KEY=$VOYAGE_API_KEY --name clawmongo-preview mongodb/mongodb-atlas-local:preview"
+	].join("\n"), "Docker Required");
 }
 /**
 * Interactive memory setup for the onboarding wizard.
@@ -41,12 +41,22 @@ async function setupMemoryBackend(config, prompter) {
 	return setupMongoDBMemory(config, prompter, await resolveOpenClawPackageName() === "@romiluz/clawmongo");
 }
 async function setupMongoDBMemory(config, prompter, isClawMongo) {
+	if (isClawMongo && !process.env.VOYAGE_API_KEY) {
+		const voyageKey = await prompter.text({
+			message: "Enter your Voyage AI API key (required for auto-embeddings)",
+			placeholder: "pa-...",
+			validate: (val) => !val?.trim() ? "Voyage AI API key is required" : void 0
+		});
+		if (typeof voyageKey === "symbol") throw new WizardCancelledError();
+		process.env.VOYAGE_API_KEY = voyageKey.trim();
+		await prompter.note("VOYAGE_API_KEY set for this session. Add it to your shell profile for persistence:\n  export VOYAGE_API_KEY=" + voyageKey.trim(), "Voyage AI");
+	}
 	if (isClawMongo) try {
 		const { attemptAutoSetup } = await import("./mongodb-auto-setup-QcwgZSN9.js");
 		const autoResult = await attemptAutoSetup(prompter);
 		if (autoResult.success) return continueMongoDBSetup(config, prompter, isClawMongo, autoResult.uri);
 		await prompter.note(autoResult.reason, "Auto-Setup");
-		if (shouldShowNoDockerHint(autoResult.reason)) await showNoDockerLocalHint(prompter);
+		if (shouldShowNoDockerHint(autoResult.reason)) await showDockerRequiredHint(prompter);
 	} catch {}
 	const existingUri = config.memory?.mongodb?.uri?.trim();
 	return continueMongoDBSetup(config, prompter, isClawMongo, (await prompter.text({

package/dist/{program-BcokVyDe.js → program-BjkVOzbF.js}

@@ -15,8 +15,8 @@ import "./registry-DgTkDMz3.js";
 import { n as resolveCliName } from "./cli-name-CflIHvyV.js";
 import "./ports-lsof-BLsmHaCG.js";
 import { n as resolveCliChannelOptions } from "./channel-options-DgceIrBT.js";
-import "./register.subclis-CfWnUdTd.js";
-import { i as registerProgramCommands } from "./command-registry-HhghuS_n.js";
+import "./register.subclis-BlqPR8UO.js";
+import { i as registerProgramCommands } from "./command-registry-Bow_kWfU.js";
 import { n as setProgramContext } from "./program-context-BoWQV6OT.js";
 import "./ports-D5BpbpwU.js";
 import { t as emitCliBanner } from "./banner-D9XjhoFM.js";

package/dist/{prompt-select-styled-z9pi54Hp.js → prompt-select-styled-6vDD4Gjv.js}

@@ -68,7 +68,7 @@ import { n as logConfigUpdated } from "./logging-BM4mQ53W.js";
 import { n as resolveProviderAuthLoginCommand, t as buildProviderAuthRecoveryHint } from "./provider-auth-guidance-D4-q7IHl.js";
 import { t as ensureSystemdUserLingerInteractive } from "./systemd-linger-DDDsik9S.js";
 import { t as formatHealthCheckFailure } from "./health-format-D5jsS7Ch.js";
-import { n as doctorShellCompletion } from "./doctor-completion-D4wCwykH.js";
+import { n as doctorShellCompletion } from "./doctor-completion-Dk8sgMOd.js";
 import { a as stripUnknownConfigKeys, i as resolveConfigPathTarget, n as formatConfigPath, r as noteOpencodeProviderOverrides, t as runDoctorConfigPreflight } from "./doctor-config-preflight-BJ0lGLTO.js";
 import { a as isMattermostMutableAllowEntry, i as isMSTeamsMutableAllowEntry, n as isGoogleChatMutableAllowEntry, o as isSlackMutableAllowEntry, r as isIrcMutableAllowEntry, s as isZalouserMutableGroupEntry, t as isDiscordMutableAllowEntry } from "./mutable-allowlist-detectors-ppdORIro.js";
 import { t as resolveDefaultChannelAccountContext } from "./channel-account-context-DZhZw4oo.js";

package/dist/{register.maintenance-DVakq6Gu.js → register.maintenance-CjOZ-w_0.js}

@@ -183,9 +183,9 @@ import "./matrix-migration-snapshot-CRKiHq6Y.js";
 import "./setup-group-access-BYV3O8yu.js";
 import "./skills-status-Cr-YPNJU.js";
 import "./note-BnDVMCVo.js";
-import "./completion-cli-Ujj0nwzr.js";
-import "./register.subclis-CfWnUdTd.js";
-import "./command-registry-HhghuS_n.js";
+import "./completion-cli-DQrts0Ip.js";
+import "./register.subclis-BlqPR8UO.js";
+import "./command-registry-Bow_kWfU.js";
 import "./program-context-BoWQV6OT.js";
 import "./heartbeat-summary-CMwt9qam.js";
 import "./health-DU_pBiid.js";
@@ -197,8 +197,8 @@ import "./logging-BM4mQ53W.js";
 import "./provider-auth-guidance-D4-q7IHl.js";
 import "./systemd-linger-DDDsik9S.js";
 import "./health-format-D5jsS7Ch.js";
-import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-z9pi54Hp.js";
-import "./doctor-completion-D4wCwykH.js";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-6vDD4Gjv.js";
+import "./doctor-completion-Dk8sgMOd.js";
 import "./doctor-config-preflight-BJ0lGLTO.js";
 import "./channel-account-context-DZhZw4oo.js";
 import "./doctor-state-migrations-Cdk3ep_f.js";

package/dist/{register.onboard-DemZm7YR.js → register.onboard-GSGJTcJk.js}

@@ -165,12 +165,12 @@ import "./onboard-helpers-D3xV_T96.js";
 import "./note-BnDVMCVo.js";
 import "./clack-prompter-QEV3P7rT.js";
 import "./setup.secret-input-DALXyJR2.js";
-import "./setup-C-dv8809.js";
+import "./setup-CjQJLNqB.js";
 import "./logging-BM4mQ53W.js";
 import { i as resolveManifestProviderOnboardAuthFlags } from "./provider-auth-choices-BfWvatIg.js";
 import "./provider-wizard-DQd5eYhX.js";
 import { n as formatAuthChoiceChoicesForCli } from "./auth-choice-options-DvqJHFOp.js";
-import { n as CORE_ONBOARD_AUTH_FLAGS, t as setupWizardCommand } from "./onboard-c0331xiO.js";
+import { n as CORE_ONBOARD_AUTH_FLAGS, t as setupWizardCommand } from "./onboard-BF8cNljJ.js";
 //#region src/cli/program/register.onboard.ts
 function resolveInstallDaemonFlag(command, opts) {
 	if (!command || typeof command !== "object") return;

package/dist/{register.setup-DTrlyJlW.js → register.setup-BD774nEM.js}

@@ -166,10 +166,10 @@ import "./onboard-helpers-D3xV_T96.js";
 import "./note-BnDVMCVo.js";
 import "./clack-prompter-QEV3P7rT.js";
 import "./setup.secret-input-DALXyJR2.js";
-import "./setup-C-dv8809.js";
+import "./setup-CjQJLNqB.js";
 import { n as logConfigUpdated, t as formatConfigPath } from "./logging-BM4mQ53W.js";
 import "./provider-auth-choices-BfWvatIg.js";
-import { t as setupWizardCommand } from "./onboard-c0331xiO.js";
+import { t as setupWizardCommand } from "./onboard-BF8cNljJ.js";
 import JSON5 from "json5";
 import fs from "node:fs/promises";
 //#region src/commands/setup.ts

package/dist/{register.subclis-CfWnUdTd.js → register.subclis-BlqPR8UO.js}

@@ -58,7 +58,7 @@ const entries = [
 		description: "Run, inspect, and query the WebSocket Gateway",
 		hasSubcommands: true,
 		register: async (program) => {
-			(await import("./gateway-cli-BpLqS4sE.js")).registerGatewayCli(program);
+			(await import("./gateway-cli-BAueAYsk.js")).registerGatewayCli(program);
 		}
 	},
 	{
@@ -264,7 +264,7 @@ const entries = [
 		description: "Update OpenClaw and inspect update channel status",
 		hasSubcommands: true,
 		register: async (program) => {
-			(await import("./update-cli-mNuSw-3W.js")).registerUpdateCli(program);
+			(await import("./update-cli-mBB0aHxZ.js")).registerUpdateCli(program);
 		}
 	},
 	{
@@ -280,7 +280,7 @@ const entries = [
 		description: "Generate shell completion script",
 		hasSubcommands: false,
 		register: async (program) => {
-			(await import("./completion-cli-CjPcdpbr.js")).registerCompletionCli(program);
+			(await import("./completion-cli-B4hJ8HjW.js")).registerCompletionCli(program);
 		}
 	}
 ];

package/dist/{register.subclis-DmsAQrVB.js → register.subclis-CeG9qCbt.js}

@@ -7,6 +7,6 @@ import "./subsystem-VzQeL-96.js";
 import "./ansi-BEJF8NKS.js";
 import "./boolean-C3GkJetE.js";
 import "./env-mRJH5TpF.js";
-import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName } from "./register.subclis-CfWnUdTd.js";
+import { n as loadValidatedConfigForPluginRegistration, r as registerSubCliByName } from "./register.subclis-BlqPR8UO.js";
 import "./subcli-descriptors-rdyciU1f.js";
 export { loadValidatedConfigForPluginRegistration, registerSubCliByName };

package/dist/{run-main-D88e0mh0.js → run-main-C4Box4Zo.js}

@@ -381,7 +381,7 @@ async function runCli(argv = process$1.argv) {
 		}
 		if (await tryRouteCli(normalizedArgv)) return;
 		enableConsoleCapture();
-		const { buildProgram } = await import("./program-BcokVyDe.js");
+		const { buildProgram } = await import("./program-BjkVOzbF.js");
 		const program = buildProgram();
 		const { installUnhandledRejectionHandler } = await import("./unhandled-rejections-O6cVOz2D.js");
 		installUnhandledRejectionHandler();
@@ -395,10 +395,10 @@ async function runCli(argv = process$1.argv) {
 			const { getProgramContext } = await import("./program-context-BpsjGnnn.js");
 			const ctx = getProgramContext(program);
 			if (ctx) {
-				const { registerCoreCliByName } = await import("./command-registry-8LCMETl9.js");
+				const { registerCoreCliByName } = await import("./command-registry-BEExVzem.js");
 				await registerCoreCliByName(program, ctx, primary, parseArgv);
 			}
-			const { registerSubCliByName } = await import("./register.subclis-DmsAQrVB.js");
+			const { registerSubCliByName } = await import("./register.subclis-CeG9qCbt.js");
 			await registerSubCliByName(program, primary);
 		}
 		if (!shouldSkipPluginCommandRegistration({
@@ -407,7 +407,7 @@ async function runCli(argv = process$1.argv) {
 			hasBuiltinPrimary: primary !== null && program.commands.some((command) => command.name() === primary)
 		})) {
 			const { registerPluginCliCommands } = await import("./cli-FF5823nM.js");
-			const { loadValidatedConfigForPluginRegistration } = await import("./register.subclis-DmsAQrVB.js");
+			const { loadValidatedConfigForPluginRegistration } = await import("./register.subclis-CeG9qCbt.js");
 			const config = await loadValidatedConfigForPluginRegistration();
 			if (config) registerPluginCliCommands(program, config);
 		}

package/dist/{setup-C-dv8809.js → setup-CjQJLNqB.js}

@@ -278,7 +278,7 @@ async function runSetupWizard(opts, runtime = defaultRuntime, prompter) {
 	try {
 		const { resolveOpenClawPackageName } = await import("./openclaw-root-UnGmA1la.js");
 		if (await resolveOpenClawPackageName() === "@romiluz/clawmongo") {
-			const { setupMemoryBackend } = await import("./onboarding-memory-DNeHKyRz.js");
+			const { setupMemoryBackend } = await import("./onboarding-memory-CTB-Vkbl.js");
 			nextConfig = await setupMemoryBackend(nextConfig, prompter);
 		}
 	} catch (err) {}
@@ -387,7 +387,7 @@ async function runSetupWizard(opts, runtime = defaultRuntime, prompter) {
 		mode
 	});
 	await writeConfigFile(nextConfig);
-	const { finalizeSetupWizard } = await import("./setup.finalize-B11Mi8BM.js");
+	const { finalizeSetupWizard } = await import("./setup.finalize-ChczeW6V.js");
 	const { launchedTui } = await finalizeSetupWizard({
 		flow,
 		opts,

package/dist/{setup.finalize-B11Mi8BM.js → setup.finalize-ChczeW6V.js}

@@ -173,16 +173,16 @@ import "./launchd-BkEfiyeS.js";
 import { n as resolveGatewayService, t as describeGatewayServiceRestart } from "./service-CruMJqe9.js";
 import { i as isSystemdUserServiceAvailable } from "./systemd-CvJKJn75.js";
 import "./note-BnDVMCVo.js";
-import { r as installCompletion } from "./completion-cli-Ujj0nwzr.js";
-import "./register.subclis-CfWnUdTd.js";
-import "./command-registry-HhghuS_n.js";
+import { r as installCompletion } from "./completion-cli-DQrts0Ip.js";
+import "./register.subclis-BlqPR8UO.js";
+import "./command-registry-Bow_kWfU.js";
 import "./program-context-BoWQV6OT.js";
 import "./heartbeat-summary-CMwt9qam.js";
 import { r as healthCommand } from "./health-DU_pBiid.js";
 import { t as ensureControlUiAssetsBuilt } from "./control-ui-assets-B8co16VR.js";
 import { t as resolveSetupSecretInputString } from "./setup.secret-input-DALXyJR2.js";
 import { t as formatHealthCheckFailure } from "./health-format-D5jsS7Ch.js";
-import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-D4wCwykH.js";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-Dk8sgMOd.js";
 import { t as runTui } from "./tui-Dj52JiFV.js";
 import path from "node:path";
 import os from "node:os";

package/dist/{update-cli-mNuSw-3W.js → update-cli-mBB0aHxZ.js}

@@ -198,9 +198,9 @@ import "./note-BnDVMCVo.js";
 import "./npm-pack-install-BBxs0rto.js";
 import "./skill-scanner-tuyTk8QC.js";
 import "./installs-hUBrmugM.js";
-import { r as installCompletion } from "./completion-cli-Ujj0nwzr.js";
-import "./register.subclis-CfWnUdTd.js";
-import "./command-registry-HhghuS_n.js";
+import { r as installCompletion } from "./completion-cli-DQrts0Ip.js";
+import "./register.subclis-BlqPR8UO.js";
+import "./command-registry-Bow_kWfU.js";
 import "./program-context-BoWQV6OT.js";
 import { n as renderTable, t as getTerminalTableWidth } from "./table-BnaYTso2.js";
 import "./heartbeat-summary-CMwt9qam.js";
@@ -215,8 +215,8 @@ import "./provider-auth-guidance-D4-q7IHl.js";
 import { n as updateNpmInstalledPlugins, t as syncPluginsForUpdateChannel } from "./update-BLx9BWCo.js";
 import "./systemd-linger-DDDsik9S.js";
 import "./health-format-D5jsS7Ch.js";
-import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-z9pi54Hp.js";
-import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-D4wCwykH.js";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-6vDD4Gjv.js";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-Dk8sgMOd.js";
 import "./doctor-config-preflight-BJ0lGLTO.js";
 import "./channel-account-context-DZhZw4oo.js";
 import "./doctor-state-migrations-Cdk3ep_f.js";

package/docs/plans/2026-03-22-clawmongo-presentation-plan.md

@@ -496,27 +496,23 @@ to a working personal AI assistant with MongoDB-native memory in about 10 minute
 ### Required
 
 - **Node.js 22+** (24 recommended)
-- **MongoDB 7.0+** with mongot (MongoDB Community Search)
-- **Voyage AI API key** (for automated embeddings)
+- **MongoDB** via `mongodb-atlas-local:preview` Docker image (bundles mongod + mongot + auto-embeddings)
+- **Voyage AI API key** (set as VOYAGE_API_KEY env var on the container)
 - **LLM API key** (Anthropic Claude recommended, or OpenAI, Google, etc.)
 
 ### MongoDB Setup Options
 
-#### Option A: Docker (Quickest)
+#### Option A: Docker with atlas-local:preview (Quickest)
 
-[Docker compose with mongodb + mongot, ready to go]
+[Single container: docker compose -f docker/mongodb/docker-compose.preview.yml up -d]
 
-#### Option B: Local Install
+#### Option B: Atlas CLI Local Deployment
 
-[mongod + mongot install steps for macOS/Linux]
-
-#### Option C: MongoDB Atlas
-
-[Atlas cluster with Search enabled, connection string]
+[atlas deployments setup clawmongo --type local --port 27017]
 
 ### Voyage AI Setup
 
-[Sign up at voyageai.com, get API key, configure in mongot]
+[Sign up at voyageai.com, get API key, set VOYAGE_API_KEY env var on container]
 
 ## Install ClawMongo
 

package/docs/reference/mongodb-capabilities.md

@@ -33,7 +33,7 @@ With mongot's `autoEmbed`, ClawMongo eliminates the embedding pipeline entirely.
 
 mongot delegates to the Voyage AI API using the `autoEmbed` field type in vector search index definitions. At index time, mongot reads the text field from each document and sends it to `voyage-4-large` for embedding. At query time, `$vectorSearch` sends the query text to mongot, which embeds it and runs approximate nearest neighbor (ANN) search.
 
-Configuration: set `memory.mongodb.embeddingMode = "automated"` in ClawMongo config. Provide a Voyage AI API key in your mongot configuration.
+Configuration: set `memory.mongodb.embeddingMode = "automated"` in ClawMongo config. Set the `VOYAGE_API_KEY` environment variable on the `mongodb-atlas-local:preview` container (or pass it to `start-preview.sh`).
 
 ### Configuration Example
 

package/docs/research/2026-03-22-atlas-local-preview-web.md

@@ -0,0 +1,270 @@
+# Web Research: MongoDB Atlas Local (Preview) — mongod + mongot bundled Docker image
+
+## Execution
+- Preferred backend: websearch+webfetch
+- Allowed fallbacks: websearch-only, webfetch-only
+- Research round: 1 (understanding Atlas Local and why it supersedes separate mongod + mongot)
+
+## Sources Used
+- WebFetch on `raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-docker.txt` — official Atlas CLI Docker deployment docs (verbatim RST source)
+- WebFetch on `raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-local.txt` — official Atlas CLI local deployment docs (verbatim RST source)
+- WebFetch on `raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-fts.txt` — Atlas CLI FTS + AVS docs
+- Docker Hub API `hub.docker.com/v2/repositories/mongodb/mongodb-atlas-local/tags/` — confirmed all available tags including `preview`
+- Live page fetch `mongodb.com/docs/atlas/atlas-vector-search/crud-embeddings/create-embeddings-automatic/` — auto-embedding feature docs with full content extraction
+- Live page fetch `mongodb.com/docs/atlas/atlas-vector-search/deployment-options/` — deployment option recommendations
+
+**Bright Data:** Not available; fell back to WebFetch + curl for raw sources.
+
+## Research Quality
+- Status: COMPLETE
+- Quality level: high
+- Backend mode: websearch+webfetch
+
+---
+
+## 1. What Is MongoDB Atlas Local?
+
+MongoDB Atlas Local (`mongodb/mongodb-atlas-local`) is an official Docker image that packages a **single-node MongoDB replica set** alongside the **mongot search process** (the same Apache Lucene-based Atlas Search / Atlas Vector Search engine that runs in the cloud) into one container. It provides a self-contained local development environment that mirrors the Atlas cloud experience — including Atlas Search indexes ($search), Atlas Vector Search ($vectorSearch), and the preview auto-embedding feature — without requiring a cloud account or a separate mongot installation.
+
+The image is maintained by MongoDB and published to Docker Hub at:
+
+```
+mongodb/mongodb-atlas-local
+```
+
+---
+
+## 2. Docker Image Tags
+
+Confirmed from the Docker Hub API (as of 2026-03-20, the latest rebuild date):
+
+| Tag pattern | Purpose |
+|---|---|
+| `latest` | Current stable release (maps to latest MongoDB 8.x + mongot) |
+| `8.2`, `8.2.6`, `8.2.6-20260320T081259Z` | Stable MongoDB 8.2.x + mongot |
+| `8.0`, `8.0.20`, etc. | Stable MongoDB 8.0.x + mongot |
+| `7.0`, `7.0.31`, etc. | Stable MongoDB 7.0.x + mongot |
+| `preview` | **Pre-release channel** — currently tracks MongoDB 8.2 + mongot with auto-embedding (Voyage AI) enabled. Separate from `latest`; ~70 MB smaller per arch than `latest` as of 2026-03-20 |
+
+The `preview` digest as of 2026-03-20: `sha256:4f4c43e8711ce31660b931bd96e76e679b311702a0cc49e03c926615aaf4c868`
+
+The `latest` digest as of same date: `sha256:a3a49321a2be227f5de99015ac939be2c89d90725d8548c6f81147f175f70d8f` (different — they are distinct builds)
+
+Both support `linux/amd64` and `linux/arm64`.
+
+---
+
+## 3. What the Image Bundles
+
+- **mongod** — MongoDB Community Edition (the database engine, configured as a single-node replica set)
+- **mongot** — MongoDB's internal search/vector search process (Apache Lucene-based), which handles:
+  - `$search` queries (full-text, fuzzy, phrase, wildcard, boolean)
+  - `$vectorSearch` queries (ANN, ENN)
+  - Atlas Search index management
+  - Automated embedding generation (in `preview` tag, requires Voyage AI API key)
+- **Built-in health check** — the container reports `healthy` when both mongod and mongot are ready, so no custom health check is required in Docker Compose
+- **Authentication support** — via `MONGODB_INITDB_ROOT_USERNAME` / `MONGODB_INITDB_ROOT_PASSWORD` environment variables
+- **Data persistence** — via Docker volumes on `/data/db` and `/data/configdb`
+
+---
+
+## 4. Why This Supersedes Running mongod + mongot Separately
+
+### Before Atlas Local
+
+Running Atlas Search + Vector Search locally required:
+1. Install MongoDB Community or Enterprise Edition (`mongod`)
+2. Separately download, install, and configure `mongot` (the search process)
+3. Configure `mongot` to bind to `mongod` via keyfile / keyfile path
+4. Manage startup order (mongot must start before search indexes are built)
+5. Manage both processes separately (logs, restarts, upgrades)
+6. No official Docker image bundled them together — DIY setup was complex
+
+### With Atlas Local
+
+Single command replaces all of the above:
+```sh
+docker run -p 27017:27017 mongodb/mongodb-atlas-local
+```
+
+Or with Docker Compose:
+```yaml
+services:
+  mongodb:
+    image: mongodb/mongodb-atlas-local
+    environment:
+      - MONGODB_INITDB_ROOT_USERNAME=user
+      - MONGODB_INITDB_ROOT_PASSWORD=pass
+    ports:
+      - 27017:27017
+    volumes:
+      - data:/data/db
+      - config:/data/configdb
+volumes:
+  data:
+  config:
+```
+
+Key advantages:
+- **Single container, single pull** — one image contains everything
+- **Correct startup sequencing** — the entrypoint ensures mongot starts in the right order relative to mongod; do not override the `command` in Docker Compose or it breaks this
+- **Built-in health check** — poll `docker inspect .State.Health.Status` to know when to connect; no custom scripts needed
+- **Parity with Atlas cloud** — the same mongot binary that runs in Atlas runs in this container, so `$search` / `$vectorSearch` index definitions, aggregation pipeline stages, and behavior match production exactly
+- **CLI-managed** — the Atlas CLI (`atlas deployments setup`) uses this image under the hood; it handles the full lifecycle (create, pause, start, delete, logs)
+- **Version-pinned deployments** — use `mongodb/mongodb-atlas-local:8.0` or `:7.0` to pin the MongoDB version across team environments
+- **Preview channel** — `mongodb/mongodb-atlas-local:preview` gives access to in-development features (auto-embeddings) ahead of stable release
+
+---
+
+## 5. Auto-Embedding / Voyage AI Integration (Preview Feature)
+
+### What It Is
+
+"Automated Embedding" is a Preview feature available in MongoDB Community Edition **v8.2 and later**, delivered via the `preview` Docker tag.
+
+Official statement from the docs:
+> "Automated embedding is available as a Preview feature only for MongoDB Community Edition v8.2 and later. The feature and the corresponding documentation might change at any time during the Preview period."
+
+### How It Works
+
+When deploying `mongodb/mongodb-atlas-local:preview` (or MongoDB 8.2 with mongot started with Voyage AI API keys), you provide a Voyage AI API key at startup. mongot uses this key to:
+
+1. **Index-time**: automatically call the Voyage AI embedding API for every text field you designate as `autoEmbed` type in the Vector Search index definition. Embeddings are generated for existing documents and kept in sync as documents are inserted/updated.
+2. **Query-time**: automatically call the Voyage AI embedding API to embed the query text before running `$vectorSearch`. You pass a plain string via `query.text` instead of a pre-computed vector.
+
+The generated embeddings are stored in a **separate system collection** on the same cluster (not in the user-facing document).
+
+### Index Definition (autoEmbed type)
+
+```json
+{
+  "fields": [
+    {
+      "type": "vectorSearch",
+      "path": "summary",
+      "autoEmbed": {
+        "embeddingModel": "voyage-4"
+      }
+    }
+  ]
+}
+```
+
+### Query (natural language text, no pre-computed vector)
+
+```js
+db.collection.aggregate([
+  {
+    "$vectorSearch": {
+      "index": "myVectorIndex",
+      "path": "summary",
+      "query": { "text": "properties near amusement parks" },
+      "numCandidates": 100,
+      "limit": 10
+    }
+  }
+])
+```
+
+### Supported Voyage AI Embedding Models
+
+| Model | Use Case |
+|---|---|
+| `voyage-4-lite` | High-volume, cost-sensitive applications |
+| `voyage-4` (recommended) | General text search, balanced performance |
+| `voyage-4-large` | Maximum accuracy for complex semantic relationships |
+| `voyage-code-3` | Code search and technical documentation |
+
+### API Key Recommendation
+
+MongoDB recommends two separate Voyage AI API keys:
+- One for **indexing operations** (higher throughput, tolerant of delays)
+- One for **query operations** (low-latency, user-facing)
+
+Keys can be generated via Atlas UI (which also provides monitoring + rate limiting UI) or directly from Voyage AI.
+
+### Why This Matters for ClawMongo
+
+ClawMongo v2 currently calls the Voyage AI API externally from application code (via the `mongodb-search.ts` / hybrid pipeline). With auto-embedding in the `preview` image:
+- No application code needed to call Voyage AI at index time or query time
+- mongot handles embedding generation and sync automatically
+- `$vectorSearch` queries can use plain text (`query.text`) instead of pre-computed vectors
+- This simplifies the architecture: ClawMongo could delegate all embedding lifecycle to mongot
+
+---
+
+## 6. Key Limitations (Preview Status)
+
+From the official auto-embedding docs (as of 2026-03-22):
+
+1. **Preview means unstable** — "The feature and the corresponding documentation might change at any time during the Preview period." API surface, behavior, or index definition syntax may break between preview releases.
+
+2. **Deployment scope** — Auto-embedding is **not yet available** for:
+   - Atlas clusters (cloud)
+   - Local Atlas deployments via the Atlas CLI (`atlas deployments setup`)
+   - MongoDB Enterprise Edition
+   - It is **only** available for MongoDB Community Edition with mongot deployed via Docker, tarball, or package manager, or via the MongoDB Controllers for Kubernetes Operator with MongoDB 8.2+.
+
+3. **Minimum version** — MongoDB Community Edition v8.2+ required (8.0 and 7.0 tags do not include auto-embedding support in mongot).
+
+4. **Cost** — Every insert/update/query triggers Voyage AI API calls billed to your Voyage AI account. Pricing is per-token.
+
+5. **Standard Atlas Local limitations** (not preview-specific):
+   - No concurrent search queries
+   - Max 1024 boolean clauses in a single search query
+   - Single-node replica set only (no sharding)
+   - For CLI-managed local deployments: only deployments created via `atlas deployments` CLI are manageable through it
+   - Tested OS: macOS 13.2+, RHEL/CentOS 8/9, Ubuntu 22.04/24.04, Debian 11/12, Amazon Linux 2023, Windows 10/11; min 2 CPU cores, 2 GB RAM
+
+6. **Do not override ENTRYPOINT** — The `mongodb/mongodb-atlas-local` image has a custom entrypoint that starts both mongod and mongot in the correct sequence. If you add a `command:` key in Docker Compose, it overrides the entrypoint and mongot will not start correctly. This is the #1 gotcha when migrating from `mongo:` image.
+
+---
+
+## 7. Comparison: mongod Standalone vs Atlas Local vs Preview
+
+| Aspect | `mongo:8.0` (raw mongod) | `mongodb/mongodb-atlas-local` (stable) | `mongodb/mongodb-atlas-local:preview` |
+|---|---|---|---|
+| Atlas Search ($search) | No | Yes | Yes |
+| Atlas Vector Search ($vectorSearch) | No | Yes | Yes |
+| Auto-embeddings (Voyage AI) | No | No | Yes (Preview) |
+| Built-in health check | No | Yes | Yes |
+| Single container | Yes | Yes | Yes |
+| Production-safe | Yes | Dev/test only | No (Preview) |
+| Min MongoDB version | Any | 7.0+ | 8.2+ |
+
+---
+
+## What Changed the Recommendation
+
+The single highest-signal finding: **auto-embedding in the `preview` tag requires MongoDB 8.2+ and is a Preview feature that is explicitly NOT available in the stable tags or via `atlas deployments setup`.** Users wanting auto-embeddings must use `mongodb/mongodb-atlas-local:preview` directly via Docker (not through the Atlas CLI `atlas deployments` command).
+
+For ClawMongo users who want the simpler zero-embedding-code experience with Voyage AI, the `preview` tag is the only supported path today. For users who want a stable embedding pipeline, the stable `8.2` tag (without `preview`) with manually-managed Voyage AI calls in application code is the safer choice.
+
+---
+
+## Gotchas / Warnings
+
+- **Never add `command:` to Docker Compose when using `mongodb-atlas-local`** — it overrides the entrypoint and mongot will not start. Remove any `command:` from existing Docker Compose files when migrating from `mongo:` image.
+- **Preview tag is not stable** — documentation and behavior can change at any time; do not use `preview` in production.
+- **`preview` and `latest` are different builds** — they have different digests and different sizes. Do not assume `preview` is ahead of `latest`; they track different feature channels.
+- **MongoDB 8.2 is the minimum for auto-embeddings** — using `preview` tag with MongoDB 7.0 base image equivalent would not give auto-embedding; the `preview` tag ships with the 8.2 server.
+- **Health check polling required** — wait for `docker inspect .State.Health.Status == healthy` before connecting; the container takes time for both mongod and mongot to initialize.
+- **Connection string must include `directConnection=true`** — single-node replica set requires direct connection: `mongodb://localhost:27017/?directConnection=true`.
+- **Voyage AI API key at startup** — for auto-embeddings, the API key must be passed to mongot at container startup time (via environment variable or config), not after the fact.
+- **Token billing starts immediately** — as soon as auto-embedding is configured, every document insert/update/query incurs Voyage AI token charges.
+- **Not for production workloads** — Atlas Local is a dev/test image; it is a single-node replica set with no HA, no backups, and no enterprise support.
+
+---
+
+## References
+
+- https://hub.docker.com/r/mongodb/mongodb-atlas-local (Docker Hub — confirmed tag list via API)
+- https://raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-docker.txt (official Docker deployment tutorial source)
+- https://raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-local.txt (official local deployment tutorial source)
+- https://raw.githubusercontent.com/mongodb/docs-atlas-cli/master/source/atlas-cli-deploy-pvt-registry.txt (private registry / tag info)
+- https://www.mongodb.com/docs/atlas/atlas-vector-search/crud-embeddings/create-embeddings-automatic/ (auto-embedding feature documentation — key source)
+- https://www.mongodb.com/docs/atlas/atlas-vector-search/deployment-options/ (deployment option recommendations)
+
+---
+
+Web research complete.

package/docs/start/clawmongo-getting-started.md

@@ -252,7 +252,7 @@ ClawMongo falls back to BSON `$text` indexes when mongot is unavailable, but vec
 
 ### Voyage AI embedding errors
 
-Verify your Voyage AI API key is correctly configured in mongot. Test embedding generation:
+Verify the `VOYAGE_API_KEY` environment variable is set on the atlas-local container. Test embedding generation:
 
 ```bash
 curl -X POST "https://api.voyageai.com/v1/embeddings" \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@romiluz/clawmongo",
-  "version": "2026.3.25",
+  "version": "2026.3.27",
   "description": "OpenClaw, but it remembers. Full AI assistant (22 channels, 78 extensions, voice, apps) with MongoDB memory - vector search, knowledge graph, event-sourcing, KB, and 8 retrieval paths. Nothing is ever lost.",
   "keywords": [
     "agent-memory",