@openclaw/whatsapp 2026.5.10-beta.3 → 2026.5.10-beta.5

package/dist/api.js

@@ -5,12 +5,12 @@ import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BK
 import "./reaction-level-2m9sWGCw.js";
 import { c as assertWebChannel, d as markdownToWhatsApp, f as resolveJidToE164, l as isSelfChatMode, m as toWhatsappJidWithLid, n as normalizeE164, p as toWhatsappJid, r as resolveUserPath, u as jidToE164 } from "./text-runtime-CMxQczvs.js";
 import "./send-DBfXQDd4.js";
-import { t as whatsappPlugin } from "./channel-yfTKmDAy.js";
+import { t as whatsappPlugin } from "./channel-D8JseTzy.js";
 import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-BgtywpNm.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.js";
-import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint } from "./shared-CcuxfjaQ.js";
+import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint } from "./shared-Ihk-Sj__.js";
 import "./config-schema-Dmo66Ubb.js";
-import { t as whatsappSetupPlugin } from "./channel.setup-k1Ro0czO.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-BuK8IaLl.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-DLGCIbfl.js";
 import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-CE74HYlw.js";
 import { t as __testing } from "./access-control-BEpPB-Jx.js";

package/dist/{channel-yfTKmDAy.js → channel-D8JseTzy.js}

@@ -10,7 +10,7 @@ import { t as createWhatsAppLoginTool } from "./agent-tools-login-DpRxLNRB.js";
 import { t as createWhatsAppOutboundBase } from "./outbound-base-BgtywpNm.js";
 import { t as getWhatsAppRuntime } from "./runtime-6fZ67abR.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.js";
-import { a as resolveWhatsAppGroupToolPolicy, c as formatWhatsAppConfigAllowFromEntries, i as resolveWhatsAppGroupRequireMention, n as loadWhatsAppChannelRuntime, o as resolveWhatsAppGroupIntroHint, r as whatsappSetupWizardProxy, s as resolveWhatsAppMentionStripRegexes, t as createWhatsAppPluginBase } from "./shared-CcuxfjaQ.js";
+import { a as resolveWhatsAppGroupToolPolicy, c as formatWhatsAppConfigAllowFromEntries, i as resolveWhatsAppGroupRequireMention, n as loadWhatsAppChannelRuntime, o as resolveWhatsAppGroupIntroHint, r as whatsappSetupWizardProxy, s as resolveWhatsAppMentionStripRegexes, t as createWhatsAppPluginBase } from "./shared-Ihk-Sj__.js";
 import { d as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-_ScMvp7r.js";
 import { t as whatsappSetupAdapter } from "./setup-core-DZKvpzbH.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-Bm0S67yH.js";

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappPlugin } from "./channel-yfTKmDAy.js";
+import { t as whatsappPlugin } from "./channel-D8JseTzy.js";
 export { whatsappPlugin };

package/dist/{channel.runtime-U2LumvwN.js → channel.runtime-BHVFPFlu.js}

@@ -1,7 +1,7 @@
 import { startWebLoginWithQr as startWebLoginWithQr$1, waitForWebLogin as waitForWebLogin$1 } from "./login-qr-runtime.js";
 import { a as getWebAuthAgeMs$1, b as webAuthExists$1, d as readWebAuthExistsForDecision$1, f as readWebAuthSnapshot$1, h as readWebSelfId$1, m as readWebAuthState$1, o as logWebSelfId$1, p as readWebAuthSnapshotBestEffort$1, s as logoutWeb$1, u as readWebAuthExistsBestEffort$1 } from "./auth-store-_ScMvp7r.js";
 import { t as getActiveWebListener$1 } from "./active-listener-DTbKS-j-.js";
-import { t as monitorWebChannel$1 } from "./monitor-DcfFBU0V.js";
+import { t as monitorWebChannel$1 } from "./monitor-BUZiKfTw.js";
 import { t as loginWeb$1 } from "./login-eiyCwLI5.js";
 import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-DJAu-uxi.js";
 //#region extensions/whatsapp/src/channel.runtime.ts

package/dist/{channel.setup-k1Ro0czO.js → channel.setup-BuK8IaLl.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint, r as whatsappSetupWizardProxy, t as createWhatsAppPluginBase } from "./shared-CcuxfjaQ.js";
+import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint, r as whatsappSetupWizardProxy, t as createWhatsAppPluginBase } from "./shared-Ihk-Sj__.js";
 import { m as readWebAuthState } from "./auth-store-_ScMvp7r.js";
 import { t as whatsappSetupAdapter } from "./setup-core-DZKvpzbH.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-Bm0S67yH.js";

package/dist/{monitor-DcfFBU0V.js → monitor-BUZiKfTw.js}

@@ -482,7 +482,7 @@ async function attachWebInboxToSocket(options) {
 		}
 		const messageTimestampMs = msg.messageTimestamp ? Number(msg.messageTimestamp) * 1e3 : void 0;
 		const access = await checkInboundAccessControl({
-			cfg: options.cfg,
+			cfg: options.loadConfig?.() ?? options.cfg,
 			accountId: options.accountId,
 			from,
 			selfE164: self.e164 ?? null,
@@ -2261,9 +2261,9 @@ async function processMessage(params) {
 //#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/on-message.ts
 function createWebOnMessageHandler(params) {
-	const processForRoute = async (msg, route, groupHistoryKey, opts) => {
+	const processForRoute = async (cfg, msg, route, groupHistoryKey, opts) => {
 		const processParams = {
-			cfg: params.cfg,
+			cfg,
 			msg,
 			route,
 			groupHistoryKey,
@@ -2288,10 +2288,11 @@ function createWebOnMessageHandler(params) {
 		return processMessage(processParams);
 	};
 	return async (msg) => {
+		const cfg = params.loadConfig?.() ?? params.cfg;
 		const conversationId = msg.conversationId ?? msg.from;
 		const peerId = resolvePeerId(msg);
 		const baseRoute = resolveAgentRoute({
-			cfg: getRuntimeConfig$1(),
+			cfg,
 			channel: "whatsapp",
 			accountId: msg.accountId,
 			peer: {
@@ -2306,6 +2307,11 @@ function createWebOnMessageHandler(params) {
 			peerKind: "group",
 			peerId
 		}) : route.sessionKey;
+		const account = resolveWhatsAppAccount({
+			cfg,
+			accountId: route.accountId ?? msg.accountId ?? params.account.accountId
+		});
+		const baseMentionConfig = buildMentionConfig(cfg);
 		if (msg.from === msg.to) logVerbose(`📱 Same-phone mode detected (from === to: ${msg.from})`);
 		if (params.echoTracker.has(msg.body)) {
 			logVerbose("Skipping auto-reply: detected echo (message matches recently sent text)");
@@ -2320,7 +2326,7 @@ function createWebOnMessageHandler(params) {
 		const runAudioPreflightOnce = async () => {
 			if (preflightAudioTranscript !== void 0 || !canRunEarlyAudioPreflight || !hasAudioBody || !msg.mediaPath) return;
 			ackReaction = await maybeSendAckReaction({
-				cfg: params.cfg,
+				cfg,
 				msg,
 				agentId: route.agentId,
 				sessionKey: route.sessionKey,
@@ -2345,7 +2351,7 @@ function createWebOnMessageHandler(params) {
 						OriginatingTo: conversationId,
 						AccountId: route.accountId
 					},
-					cfg: params.cfg
+					cfg
 				}) ?? null;
 			} catch {
 				preflightAudioTranscript = null;
@@ -2370,7 +2376,7 @@ function createWebOnMessageHandler(params) {
 				OriginatingTo: conversationId
 			};
 			updateLastRouteInBackground({
-				cfg: params.cfg,
+				cfg,
 				backgroundTasks: params.backgroundTasks,
 				storeAgentId: route.agentId,
 				sessionKey: route.sessionKey,
@@ -2381,16 +2387,16 @@ function createWebOnMessageHandler(params) {
 				warn: params.replyLogger.warn.bind(params.replyLogger)
 			});
 			let gating = await applyGroupGating({
-				cfg: params.cfg,
+				cfg,
 				msg,
 				deferMissingMention: hasAudioBody && Boolean(msg.mediaPath),
 				conversationId,
 				groupHistoryKey,
 				agentId: route.agentId,
 				sessionKey: route.sessionKey,
-				baseMentionConfig: params.baseMentionConfig,
-				authDir: params.account.authDir,
-				selfChatMode: params.account.selfChatMode,
+				baseMentionConfig,
+				authDir: account.authDir,
+				selfChatMode: account.selfChatMode,
 				groupHistories: params.groupHistories,
 				groupHistoryLimit: params.groupHistoryLimit,
 				groupMemberNames: params.groupMemberNames,
@@ -2400,16 +2406,16 @@ function createWebOnMessageHandler(params) {
 			if (!gating.shouldProcess && "needsMentionText" in gating && gating.needsMentionText === true) {
 				await runAudioPreflightOnce();
 				gating = await applyGroupGating({
-					cfg: params.cfg,
+					cfg,
 					msg,
 					...typeof preflightAudioTranscript === "string" ? { mentionText: preflightAudioTranscript } : {},
 					conversationId,
 					groupHistoryKey,
 					agentId: route.agentId,
 					sessionKey: route.sessionKey,
-					baseMentionConfig: params.baseMentionConfig,
-					authDir: params.account.authDir,
-					selfChatMode: params.account.selfChatMode,
+					baseMentionConfig,
+					authDir: account.authDir,
+					selfChatMode: account.selfChatMode,
 					groupHistories: params.groupHistories,
 					groupHistoryLimit: params.groupHistoryLimit,
 					groupMemberNames: params.groupMemberNames,
@@ -2430,7 +2436,7 @@ function createWebOnMessageHandler(params) {
 		}
 		await runAudioPreflightOnce();
 		if (await maybeBroadcastMessage({
-			cfg: params.cfg,
+			cfg,
 			msg,
 			peerId,
 			route,
@@ -2439,9 +2445,9 @@ function createWebOnMessageHandler(params) {
 			...preflightAudioTranscript !== void 0 ? { preflightAudioTranscript } : {},
 			...ackAlreadySent && msg.chatType !== "group" ? { ackAlreadySent: true } : {},
 			...ackReaction && msg.chatType !== "group" ? { ackReaction } : {},
-			processMessage: (m, r, k, opts) => processForRoute(m, r, k, opts)
+			processMessage: (m, r, k, opts) => processForRoute(cfg, m, r, k, opts)
 		})) return;
-		await processForRoute(msg, route, groupHistoryKey, {
+		await processForRoute(cfg, msg, route, groupHistoryKey, {
 			...preflightAudioTranscript !== void 0 ? { preflightAudioTranscript } : {},
 			...ackAlreadySent ? { ackAlreadySent: true } : {},
 			...ackReaction ? { ackReaction } : {}
@@ -2458,6 +2464,34 @@ function loadReplyResolverRuntime() {
 	replyResolverRuntimePromise ??= import("./reply-resolver.runtime-rIVWohXr.js");
 	return replyResolverRuntimePromise;
 }
+function resolveWebMonitorConfigSnapshot(params) {
+	const account = resolveWhatsAppAccount({
+		cfg: params.cfg,
+		accountId: params.accountId
+	});
+	return {
+		cfg: {
+			...params.cfg,
+			channels: {
+				...params.cfg.channels,
+				whatsapp: {
+					...params.cfg.channels?.whatsapp,
+					ackReaction: account.ackReaction,
+					messagePrefix: account.messagePrefix,
+					allowFrom: account.allowFrom,
+					groupAllowFrom: account.groupAllowFrom,
+					groupPolicy: account.groupPolicy,
+					textChunkLimit: account.textChunkLimit,
+					chunkMode: account.chunkMode,
+					mediaMaxMb: account.mediaMaxMb,
+					blockStreaming: account.blockStreaming,
+					groups: account.groups
+				}
+			}
+		},
+		account
+	};
+}
 function normalizeReconnectAccountId(accountId) {
 	return (accountId ?? "").trim() || "default";
 }
@@ -2522,29 +2556,14 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 	statusController.emit();
 	const baseCfg = getRuntimeConfig$1();
 	const sourceCfg = getRuntimeConfigSourceSnapshot();
-	const account = resolveWhatsAppAccount({
+	const { cfg, account } = resolveWebMonitorConfigSnapshot({
 		cfg: baseCfg,
 		accountId: tuning.accountId
 	});
-	const cfg = {
-		...baseCfg,
-		channels: {
-			...baseCfg.channels,
-			whatsapp: {
-				...baseCfg.channels?.whatsapp,
-				ackReaction: account.ackReaction,
-				messagePrefix: account.messagePrefix,
-				allowFrom: account.allowFrom,
-				groupAllowFrom: account.groupAllowFrom,
-				groupPolicy: account.groupPolicy,
-				textChunkLimit: account.textChunkLimit,
-				chunkMode: account.chunkMode,
-				mediaMaxMb: account.mediaMaxMb,
-				blockStreaming: account.blockStreaming,
-				groups: account.groups
-			}
-		}
-	};
+	const loadCurrentMonitorConfig = () => resolveWebMonitorConfigSnapshot({
+		cfg: getRuntimeConfig$1(),
+		accountId: account.accountId
+	}).cfg;
 	const maxMediaBytes = resolveWhatsAppMediaMaxBytes(account);
 	const heartbeatSeconds = resolveHeartbeatSeconds(cfg, tuning.heartbeatSeconds);
 	const reconnectPolicy = resolveReconnectPolicy(cfg, tuning.reconnect);
@@ -2611,6 +2630,7 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 					createListener: async ({ sock, connection }) => {
 						const onMessage = createWebOnMessageHandler({
 							cfg,
+							loadConfig: loadCurrentMonitorConfig,
 							verbose,
 							connectionId,
 							maxMediaBytes,
@@ -2626,6 +2646,7 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 						});
 						return await (listenerFactory ?? attachWebInboxToSocket)({
 							cfg,
+							loadConfig: loadCurrentMonitorConfig,
 							verbose,
 							accountId: account.accountId,
 							authDir: account.authDir,
@@ -2686,6 +2707,40 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 					}
 				});
 			} catch (error) {
+				if (getStatusCode(error) === 428) {
+					const retryDecision = controller.consumeReconnectAttempt();
+					statusController.noteReconnectAttempts(retryDecision.reconnectAttempts);
+					statusController.noteClose({
+						statusCode: 428,
+						error: formatError(error),
+						reconnectAttempts: retryDecision.reconnectAttempts,
+						healthState: retryDecision.healthState
+					});
+					if (retryDecision.action === "stop") {
+						reconnectLogger.warn({
+							connectionId,
+							status: 428,
+							reconnectAttempts: retryDecision.reconnectAttempts,
+							maxAttempts: reconnectPolicy.maxAttempts
+						}, "web reconnect: 428 during opening; max attempts reached");
+						runtime.error(`WhatsApp Web connection closed during setup (status 428) after ${retryDecision.reconnectAttempts}/${reconnectPolicy.maxAttempts} attempts. Relink with \`${formatCliCommand("openclaw channels login --channel whatsapp")}\` if the issue persists.`);
+						await controller.shutdown();
+						break;
+					}
+					reconnectLogger.info({
+						connectionId,
+						status: 428,
+						reconnectAttempts: retryDecision.reconnectAttempts,
+						delayMs: retryDecision.delayMs
+					}, "web reconnect: 428 during opening; retrying");
+					runtime.error(`WhatsApp Web connection closed during setup (status 428). Retry ${retryDecision.reconnectAttempts}/${reconnectPolicy.maxAttempts || "∞"} in ${formatDurationPrecise(retryDecision.delayMs ?? 0)}.`);
+					try {
+						await controller.waitBeforeRetry(retryDecision.delayMs ?? 0);
+					} catch {
+						break;
+					}
+					continue;
+				}
 				if (!isRetryableAuthUnstableError(error)) throw error;
 				const retryDecision = controller.consumeReconnectAttempt();
 				statusController.noteReconnectAttempts(retryDecision.reconnectAttempts);

package/dist/runtime-api.js

@@ -10,7 +10,7 @@ import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-DLGCIbfl.js";
 import { c as extractContactContext, d as extractMediaPlaceholder, p as extractText, u as extractLocationData } from "./send-api-DD93aPIQ.js";
 import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-CVCKPoQN.js";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-DTbKS-j-.js";
-import { a as loadWebMediaRaw, c as monitorWebInbox, i as loadWebMedia, l as resetWebInboundDedupe, n as LocalMediaAccessError, o as optimizeImageToJpeg, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel } from "./monitor-DcfFBU0V.js";
+import { a as loadWebMediaRaw, c as monitorWebInbox, i as loadWebMedia, l as resetWebInboundDedupe, n as LocalMediaAccessError, o as optimizeImageToJpeg, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel } from "./monitor-BUZiKfTw.js";
 import { t as loginWeb } from "./login-eiyCwLI5.js";
 import { HEARTBEAT_PROMPT, HEARTBEAT_TOKEN, SILENT_REPLY_TOKEN, stripHeartbeatToken } from "openclaw/plugin-sdk/reply-runtime";
 export { DEFAULT_WEB_MEDIA_BYTES, HEARTBEAT_PROMPT, HEARTBEAT_TOKEN, LocalMediaAccessError, SILENT_REPLY_TOKEN, WA_WEB_AUTH_DIR, WHATSAPP_AUTH_UNSTABLE_CODE, WhatsAppAuthUnstableError, createWaSocket, createWhatsAppLoginTool, extractContactContext, extractLocationData, extractMediaPlaceholder, extractText, formatError, formatWhatsAppWebAuthStatusState, getActiveWebListener, getDefaultLocalRoots, getStatusCode, getWebAuthAgeMs, handleWhatsAppAction, hasWebCredsSync, loadWebMedia, loadWebMediaRaw, logWebSelfId, loginWeb, logoutWeb, monitorWebChannel, monitorWebInbox, newConnectionId, optimizeImageToJpeg, optimizeImageToPng, pickWebChannel, readCredsJsonRaw, readWebAuthExistsBestEffort, readWebAuthExistsForDecision, readWebAuthSnapshot, readWebAuthSnapshotBestEffort, readWebAuthState, readWebSelfId, readWebSelfIdentity, readWebSelfIdentityForDecision, resetWebInboundDedupe, resolveDefaultWebAuthDir, resolveWebAccountId, resolveWebCredsBackupPath, resolveWebCredsPath, restoreCredsFromBackupIfNeeded, sendMessageWhatsApp, sendPollWhatsApp, sendReactionWhatsApp, sendTypingWhatsApp, setWhatsAppRuntime, startWebLoginWithQr, stripHeartbeatToken, waitForCredsSaveQueue, waitForCredsSaveQueueWithTimeout, waitForWaConnection, waitForWebLogin, webAuthExists, whatsAppActionRuntime, writeCredsJsonAtomically };

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappSetupPlugin } from "./channel.setup-k1Ro0czO.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-BuK8IaLl.js";
 export { whatsappSetupPlugin };

package/dist/{shared-CcuxfjaQ.js → shared-Ihk-Sj__.js}

@@ -124,7 +124,7 @@ function resolveWhatsAppConfigPath(params) {
 	return `${resolveWhatsAppGroupScopeBasePath(params)}.${params.field}`;
 }
 async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-U2LumvwN.js");
+	return await import("./channel.runtime-BHVFPFlu.js");
 }
 async function loadWhatsAppSetupSurface() {
 	return await import("./setup-surface-DJAu-uxi.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.5.10-beta.3",
+  "version": "2026.5.10-beta.5",
   "description": "OpenClaw WhatsApp channel plugin",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.10-beta.3"
+    "openclaw": ">=2026.5.10-beta.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -61,10 +61,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.10-beta.3"
+      "pluginApi": ">=2026.5.10-beta.5"
     },
     "build": {
-      "openclawVersion": "2026.5.10-beta.3"
+      "openclawVersion": "2026.5.10-beta.5"
     },
     "release": {
       "publishToClawHub": true,