@openclaw/whatsapp 2026.5.3 → 2026.5.4-beta.1

package/dist/api.js

@@ -5,12 +5,12 @@ import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-CN
 import "./reaction-level-CRVEVAfi.js";
 import { a as markdownToWhatsApp, i as jidToE164, n as assertWebChannel, o as resolveJidToE164, r as isSelfChatMode, s as toWhatsappJid, t as text_runtime_exports } from "./text-runtime-C1zNiZeO.js";
 import "./send-CIyLFxdZ.js";
-import { t as whatsappPlugin } from "./channel-DQ-5Xoj9.js";
+import { t as whatsappPlugin } from "./channel-hbY6bgVQ.js";
 import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-Bq1UYEK5.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.js";
-import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint } from "./shared-D_wzSVar.js";
+import { a as resolveWhatsAppGroupToolPolicy, i as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupIntroHint } from "./shared-Cmuil8Ri.js";
 import "./config-schema-Dmo66Ubb.js";
-import { t as whatsappSetupPlugin } from "./channel.setup-DOHR2BGp.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-Dd-A2LLn.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-DLGCIbfl.js";
 import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-DVs4ffXu.js";
 import { t as __testing } from "./access-control-BQ3tCkH8.js";

package/dist/{channel-DQ-5Xoj9.js → channel-hbY6bgVQ.js}

@@ -10,7 +10,7 @@ import { t as createWhatsAppLoginTool } from "./agent-tools-login-DpRxLNRB.js";
 import { t as createWhatsAppOutboundBase } from "./outbound-base-Bq1UYEK5.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-D_wzSVar.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-Cmuil8Ri.js";
 import { d as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BjCb50Ry.js";
 import { t as whatsappSetupAdapter } from "./setup-core-DZKvpzbH.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-DnCdvoYD.js";

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappPlugin } from "./channel-DQ-5Xoj9.js";
+import { t as whatsappPlugin } from "./channel-hbY6bgVQ.js";
 export { whatsappPlugin };

package/dist/{channel.runtime-DKXRnA8x.js → channel.runtime-CzJk8F1Z.js}

@@ -1,9 +1,9 @@
 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-BjCb50Ry.js";
 import { t as getActiveWebListener$1 } from "./active-listener-N7GFKsuN.js";
-import { t as monitorWebChannel$1 } from "./monitor-C4Fhg_lD.js";
-import { t as loginWeb$1 } from "./login-DymdrKca.js";
-import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-ieFnIW4g.js";
+import { t as monitorWebChannel$1 } from "./monitor-CiG3ddjv.js";
+import { t as loginWeb$1 } from "./login-Cb_Wvr8L.js";
+import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-DQbN6Iu0.js";
 //#region extensions/whatsapp/src/channel.runtime.ts
 function getActiveWebListener(...args) {
 	return getActiveWebListener$1(...args);

package/dist/{channel.setup-DOHR2BGp.js → channel.setup-Dd-A2LLn.js}

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

package/dist/{connection-controller-BiHAsTM8.js → connection-controller-Bzopd9NT.js}

@@ -593,4 +593,4 @@ var WhatsAppConnectionController = class {
 	}
 };
 //#endregion
-export { waitForWhatsAppLoginResult as a, waitForWaConnection as c, computeBackoff as d, newConnectionId$1 as f, sleepWithAbort as h, closeWaSocketSoon as i, resolveWhatsAppSocketTiming as l, resolveReconnectPolicy as m, WhatsAppConnectionController as n, createWaSocket as o, resolveHeartbeatSeconds as p, closeWaSocket as r, newConnectionId as s, WHATSAPP_LOGGED_OUT_QR_MESSAGE as t, DEFAULT_RECONNECT_POLICY as u };
+export { waitForWhatsAppLoginResult as a, waitForWaConnection as c, DEFAULT_RECONNECT_POLICY as d, computeBackoff as f, sleepWithAbort as g, resolveReconnectPolicy as h, closeWaSocketSoon as i, resolveWhatsAppSocketTiming as l, resolveHeartbeatSeconds as m, WhatsAppConnectionController as n, createWaSocket as o, newConnectionId$1 as p, closeWaSocket as r, newConnectionId as s, WHATSAPP_LOGGED_OUT_QR_MESSAGE as t, renderQrTerminal as u };

package/dist/{login-DymdrKca.js → login-Cb_Wvr8L.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-RkAeH_Qm.js";
 import { a as resolveWhatsAppAccount } from "./accounts-BDqgpFEB.js";
 import { y as restoreCredsFromBackupIfNeeded } from "./auth-store-BjCb50Ry.js";
-import { a as waitForWhatsAppLoginResult, i as closeWaSocketSoon, l as resolveWhatsAppSocketTiming, o as createWaSocket } from "./connection-controller-BiHAsTM8.js";
+import { a as waitForWhatsAppLoginResult, i as closeWaSocketSoon, l as resolveWhatsAppSocketTiming, o as createWaSocket, u as renderQrTerminal } from "./connection-controller-Bzopd9NT.js";
 import { logInfo } from "openclaw/plugin-sdk/text-runtime";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { danger, defaultRuntime, success } from "openclaw/plugin-sdk/runtime-env";
@@ -16,9 +16,18 @@ async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, ac
 	});
 	const socketTiming = resolveWhatsAppSocketTiming(cfg);
 	const restoredFromBackup = await restoreCredsFromBackupIfNeeded(account.authDir);
-	let sock = await createWaSocket(true, verbose, {
+	const onQr = (qr) => {
+		runtime.log("Scan this QR in WhatsApp (Linked Devices):");
+		renderQrTerminal(qr, { small: true }).then((output) => {
+			runtime.log(output.endsWith("\n") ? output.slice(0, -1) : output);
+		}).catch((err) => {
+			runtime.error(`failed rendering WhatsApp QR: ${String(err)}`);
+		});
+	};
+	let sock = await createWaSocket(false, verbose, {
 		authDir: account.authDir,
-		...socketTiming
+		...socketTiming,
+		onQr
 	});
 	logInfo("Waiting for WhatsApp connection...", runtime);
 	try {
@@ -30,19 +39,20 @@ async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, ac
 			runtime,
 			waitForConnection,
 			socketTiming,
+			onQr,
 			onSocketReplaced: (replacementSock) => {
 				sock = replacementSock;
 			}
 		});
 		if (result.outcome === "connected") {
-			console.log(success(result.restarted ? "✅ Linked after restart; web session ready." : restoredFromBackup ? "✅ Recovered from creds.json.bak; web session ready." : "✅ Linked! Credentials saved for future sends."));
+			runtime.log(success(result.restarted ? "✅ Linked after restart; web session ready." : restoredFromBackup ? "✅ Recovered from creds.json.bak; web session ready." : "✅ Linked! Credentials saved for future sends."));
 			return;
 		}
 		if (result.outcome === "logged-out") {
-			console.error(danger(`WhatsApp reported the session is logged out. Cleared cached web session; please rerun ${formatCliCommand("openclaw channels login")} and scan the QR again.`));
+			runtime.error(danger(`WhatsApp reported the session is logged out. Cleared cached web session; please rerun ${formatCliCommand("openclaw channels login")} and scan the QR again.`));
 			throw new Error("Session logged out; cache cleared. Re-run login.", { cause: result.error });
 		}
-		console.error(danger(`WhatsApp Web connection ended before fully opening. ${result.message}`));
+		runtime.error(danger(`WhatsApp Web connection ended before fully opening. ${result.message}`));
 		throw new Error(result.message, { cause: result.error });
 	} finally {
 		closeWaSocketSoon(sock);

package/dist/{login-qr-DIS0Iv-7.js → login-qr-BmIHgjH2.js}

@@ -1,6 +1,6 @@
 import { a as resolveWhatsAppAccount } from "./accounts-BDqgpFEB.js";
 import { d as readWebAuthExistsForDecision, h as readWebSelfId, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BjCb50Ry.js";
-import { a as waitForWhatsAppLoginResult, l as resolveWhatsAppSocketTiming, o as createWaSocket, r as closeWaSocket, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-BiHAsTM8.js";
+import { a as waitForWhatsAppLoginResult, l as resolveWhatsAppSocketTiming, o as createWaSocket, r as closeWaSocket, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-Bzopd9NT.js";
 import { logInfo } from "openclaw/plugin-sdk/text-runtime";
 import { danger, defaultRuntime, info, success } from "openclaw/plugin-sdk/runtime-env";
 import { renderQrPngDataUrl } from "openclaw/plugin-sdk/media-runtime";

package/dist/login-qr-runtime.js

@@ -1,7 +1,7 @@
 //#region extensions/whatsapp/login-qr-runtime.ts
 let loginQrModulePromise = null;
 function loadLoginQrModule() {
-	loginQrModulePromise ??= import("./login-qr-DIS0Iv-7.js");
+	loginQrModulePromise ??= import("./login-qr-BmIHgjH2.js");
 	return loginQrModulePromise;
 }
 async function startWebLoginWithQr(...args) {

package/dist/{monitor-C4Fhg_lD.js → monitor-CiG3ddjv.js}

@@ -10,7 +10,7 @@ import { n as cacheInboundMessageMeta, r as lookupInboundMessageMeta, t as build
 import { _ as readWebSelfIdentityForDecision, a as getWebAuthAgeMs, h as readWebSelfId, r as WhatsAppAuthUnstableError, s as logoutWeb } from "./auth-store-BjCb50Ry.js";
 import { a as getSelfIdentity, c as resolveComparableIdentity, i as getReplyContext, n as getMentionIdentities, o as getSenderIdentity, r as getPrimaryIdentityId, s as identitiesOverlap, t as getComparableIdentityValues } from "./identity-QHAlV7Fu.js";
 import { i as resolveWhatsAppInboundPolicy, n as checkInboundAccessControl, r as resolveWhatsAppCommandAuthorized } from "./access-control-BQ3tCkH8.js";
-import { c as waitForWaConnection, d as computeBackoff, f as newConnectionId, h as sleepWithAbort, l as resolveWhatsAppSocketTiming, m as resolveReconnectPolicy, n as WhatsAppConnectionController, o as createWaSocket, p as resolveHeartbeatSeconds, u as DEFAULT_RECONNECT_POLICY } from "./connection-controller-BiHAsTM8.js";
+import { c as waitForWaConnection, d as DEFAULT_RECONNECT_POLICY, f as computeBackoff, g as sleepWithAbort, h as resolveReconnectPolicy, l as resolveWhatsAppSocketTiming, m as resolveHeartbeatSeconds, n as WhatsAppConnectionController, o as createWaSocket, p as newConnectionId } from "./connection-controller-Bzopd9NT.js";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";
 import { getChildLogger, normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/text-runtime";
 import { createAckReactionHandle, logAckFailure, removeAckReactionHandleAfterReply, shouldAckReactionForWhatsApp } from "openclaw/plugin-sdk/channel-feedback";
@@ -48,7 +48,7 @@ import { resolveBatchedReplyThreadingPolicy } from "openclaw/plugin-sdk/reply-re
 import { resolveIdentityNamePrefix as resolveIdentityNamePrefix$1 } from "openclaw/plugin-sdk/agent-runtime";
 import { formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1 } from "openclaw/plugin-sdk/channel-envelope";
 import { toLocationContext } from "openclaw/plugin-sdk/channel-location";
-import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
+import { createChannelReplyPipeline, resolveChannelSourceReplyDeliveryMode } from "openclaw/plugin-sdk/channel-reply-pipeline";
 //#region extensions/whatsapp/src/inbound/dedupe.ts
 const RECENT_WEB_MESSAGE_TTL_MS = 20 * 6e4;
 const RECENT_WEB_MESSAGE_MAX = 5e3;
@@ -2317,7 +2317,15 @@ async function dispatchWhatsAppBufferedReply(params) {
 		accountId: params.route.accountId
 	});
 	const mediaLocalRoots = getAgentScopedMediaLocalRoots(params.cfg, params.route.agentId);
-	const disableBlockStreaming = resolveWhatsAppDisableBlockStreaming(params.cfg);
+	const sourceReplyChatType = typeof params.context.ChatType === "string" ? params.context.ChatType : params.msg.chatType;
+	const sourceReplyDeliveryMode = sourceReplyChatType === "group" || sourceReplyChatType === "channel" ? resolveChannelSourceReplyDeliveryMode({
+		cfg: params.cfg,
+		ctx: {
+			ChatType: sourceReplyChatType,
+			CommandSource: params.context.CommandSource === "native" ? "native" : void 0
+		}
+	}) : void 0;
+	const disableBlockStreaming = sourceReplyDeliveryMode === "message_tool_only" ? true : resolveWhatsAppDisableBlockStreaming(params.cfg);
 	let didSendReply = false;
 	let didLogHeartbeatStrip = false;
 	const { queuedFinal, counts } = await dispatchReplyWithBufferedBlockDispatcher({
@@ -2390,6 +2398,7 @@ async function dispatchWhatsAppBufferedReply(params) {
 		},
 		replyOptions: {
 			disableBlockStreaming,
+			...sourceReplyDeliveryMode ? { sourceReplyDeliveryMode } : {},
 			onModelSelected: params.onModelSelected
 		}
 	});

package/dist/runtime-api.js

@@ -8,8 +8,8 @@ import { n as setWhatsAppRuntime } from "./runtime-6fZ67abR.js";
 import { C as waitForCredsSaveQueueWithTimeout, S as waitForCredsSaveQueue, _ as readWebSelfIdentityForDecision, a as getWebAuthAgeMs, b as webAuthExists, c as pickWebChannel, d as readWebAuthExistsForDecision, f as readWebAuthSnapshot, g as readWebSelfIdentity, h as readWebSelfId, i as formatWhatsAppWebAuthStatusState, l as readCredsJsonRaw, m as readWebAuthState, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as logWebSelfId, p as readWebAuthSnapshotBestEffort, r as WhatsAppAuthUnstableError, s as logoutWeb, t as WA_WEB_AUTH_DIR, u as readWebAuthExistsBestEffort, v as resolveDefaultWebAuthDir, w as writeCredsJsonAtomically, y as restoreCredsFromBackupIfNeeded } from "./auth-store-BjCb50Ry.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-DLGCIbfl.js";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-N7GFKsuN.js";
-import { c as waitForWaConnection, o as createWaSocket, s as newConnectionId } from "./connection-controller-BiHAsTM8.js";
-import { a as loadWebMediaRaw, c as monitorWebInbox, d as extractMediaPlaceholder, f as extractText, i as loadWebMedia, l as extractContactContext, n as LocalMediaAccessError, o as optimizeImageToJpeg, p as resetWebInboundDedupe, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel, u as extractLocationData } from "./monitor-C4Fhg_lD.js";
-import { t as loginWeb } from "./login-DymdrKca.js";
+import { c as waitForWaConnection, o as createWaSocket, s as newConnectionId } from "./connection-controller-Bzopd9NT.js";
+import { a as loadWebMediaRaw, c as monitorWebInbox, d as extractMediaPlaceholder, f as extractText, i as loadWebMedia, l as extractContactContext, n as LocalMediaAccessError, o as optimizeImageToJpeg, p as resetWebInboundDedupe, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel, u as extractLocationData } from "./monitor-CiG3ddjv.js";
+import { t as loginWeb } from "./login-Cb_Wvr8L.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-DOHR2BGp.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-Dd-A2LLn.js";
 export { whatsappSetupPlugin };

package/dist/{setup-surface-ieFnIW4g.js → setup-surface-DQbN6Iu0.js}

@@ -279,7 +279,7 @@ async function finalizeWhatsAppSetup(params) {
 		message: linked ? "WhatsApp already linked. Re-link now?" : "Link WhatsApp now (QR)?",
 		initialValue: !linked
 	})) try {
-		const { loginWeb } = await import("./login-DymdrKca.js").then((n) => n.n);
+		const { loginWeb } = await import("./login-Cb_Wvr8L.js").then((n) => n.n);
 		await loginWeb(false, void 0, params.runtime, accountId);
 	} catch (error) {
 		params.runtime.error(`WhatsApp login failed: ${String(error)}`);

package/dist/{shared-D_wzSVar.js → shared-Cmuil8Ri.js}

@@ -124,10 +124,10 @@ function resolveWhatsAppConfigPath(params) {
 	return `${resolveWhatsAppGroupScopeBasePath(params)}.${params.field}`;
 }
 async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-DKXRnA8x.js");
+	return await import("./channel.runtime-CzJk8F1Z.js");
 }
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-ieFnIW4g.js");
+	return await import("./setup-surface-DQbN6Iu0.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({

package/package.json

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