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

package/openclaw.plugin.json

@@ -39,9 +39,6 @@
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
         "properties": {
-          "enabled": {
-            "type": "boolean"
-          },
           "capabilities": {
             "type": "array",
             "items": {
@@ -66,15 +63,9 @@
           "configWrites": {
             "type": "boolean"
           },
-          "sendReadReceipts": {
+          "enabled": {
             "type": "boolean"
           },
-          "messagePrefix": {
-            "type": "string"
-          },
-          "responsePrefix": {
-            "type": "string"
-          },
           "dmPolicy": {
             "default": "pairing",
             "type": "string",
@@ -85,9 +76,6 @@
               "disabled"
             ]
           },
-          "selfChatMode": {
-            "type": "boolean"
-          },
           "allowFrom": {
             "type": "array",
             "items": {
@@ -225,6 +213,65 @@
             },
             "additionalProperties": false
           },
+          "heartbeatVisibility": {
+            "type": "object",
+            "properties": {
+              "showOk": {
+                "type": "boolean"
+              },
+              "showAlerts": {
+                "type": "boolean"
+              },
+              "useIndicator": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          },
+          "healthMonitor": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          },
+          "responsePrefix": {
+            "type": "string"
+          },
+          "mediaMaxMb": {
+            "default": 50,
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991
+          },
+          "replyToMode": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "off"
+              },
+              {
+                "type": "string",
+                "const": "first"
+              },
+              {
+                "type": "string",
+                "const": "all"
+              },
+              {
+                "type": "string",
+                "const": "batched"
+              }
+            ]
+          },
+          "sendReadReceipts": {
+            "type": "boolean"
+          },
+          "selfChatMode": {
+            "type": "boolean"
+          },
           "groups": {
             "type": "object",
             "propertyNames": {
@@ -312,32 +359,6 @@
               "additionalProperties": false
             }
           },
-          "ackReaction": {
-            "type": "object",
-            "properties": {
-              "emoji": {
-                "type": "string"
-              },
-              "direct": {
-                "default": true,
-                "type": "boolean"
-              },
-              "group": {
-                "default": "mentions",
-                "type": "string",
-                "enum": [
-                  "always",
-                  "mentions",
-                  "never"
-                ]
-              }
-            },
-            "required": [
-              "direct",
-              "group"
-            ],
-            "additionalProperties": false
-          },
           "reactionLevel": {
             "type": "string",
             "enum": [
@@ -347,56 +368,6 @@
               "extensive"
             ]
           },
-          "debounceMs": {
-            "default": 0,
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          },
-          "replyToMode": {
-            "anyOf": [
-              {
-                "type": "string",
-                "const": "off"
-              },
-              {
-                "type": "string",
-                "const": "first"
-              },
-              {
-                "type": "string",
-                "const": "all"
-              },
-              {
-                "type": "string",
-                "const": "batched"
-              }
-            ]
-          },
-          "heartbeat": {
-            "type": "object",
-            "properties": {
-              "showOk": {
-                "type": "boolean"
-              },
-              "showAlerts": {
-                "type": "boolean"
-              },
-              "useIndicator": {
-                "type": "boolean"
-              }
-            },
-            "additionalProperties": false
-          },
-          "healthMonitor": {
-            "type": "object",
-            "properties": {
-              "enabled": {
-                "type": "boolean"
-              }
-            },
-            "additionalProperties": false
-          },
           "pluginHooks": {
             "type": "object",
             "properties": {
@@ -414,9 +385,6 @@
             "additionalProperties": {
               "type": "object",
               "properties": {
-                "enabled": {
-                  "type": "boolean"
-                },
                 "capabilities": {
                   "type": "array",
                   "items": {
@@ -441,15 +409,9 @@
                 "configWrites": {
                   "type": "boolean"
                 },
-                "sendReadReceipts": {
+                "enabled": {
                   "type": "boolean"
                 },
-                "messagePrefix": {
-                  "type": "string"
-                },
-                "responsePrefix": {
-                  "type": "string"
-                },
                 "dmPolicy": {
                   "type": "string",
                   "enum": [
@@ -459,9 +421,6 @@
                     "disabled"
                   ]
                 },
-                "selfChatMode": {
-                  "type": "boolean"
-                },
                 "allowFrom": {
                   "type": "array",
                   "items": {
@@ -598,6 +557,64 @@
                   },
                   "additionalProperties": false
                 },
+                "heartbeatVisibility": {
+                  "type": "object",
+                  "properties": {
+                    "showOk": {
+                      "type": "boolean"
+                    },
+                    "showAlerts": {
+                      "type": "boolean"
+                    },
+                    "useIndicator": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "healthMonitor": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "responsePrefix": {
+                  "type": "string"
+                },
+                "mediaMaxMb": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "replyToMode": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "const": "off"
+                    },
+                    {
+                      "type": "string",
+                      "const": "first"
+                    },
+                    {
+                      "type": "string",
+                      "const": "all"
+                    },
+                    {
+                      "type": "string",
+                      "const": "batched"
+                    }
+                  ]
+                },
+                "sendReadReceipts": {
+                  "type": "boolean"
+                },
+                "selfChatMode": {
+                  "type": "boolean"
+                },
                 "groups": {
                   "type": "object",
                   "propertyNames": {
@@ -685,32 +702,6 @@
                     "additionalProperties": false
                   }
                 },
-                "ackReaction": {
-                  "type": "object",
-                  "properties": {
-                    "emoji": {
-                      "type": "string"
-                    },
-                    "direct": {
-                      "default": true,
-                      "type": "boolean"
-                    },
-                    "group": {
-                      "default": "mentions",
-                      "type": "string",
-                      "enum": [
-                        "always",
-                        "mentions",
-                        "never"
-                      ]
-                    }
-                  },
-                  "required": [
-                    "direct",
-                    "group"
-                  ],
-                  "additionalProperties": false
-                },
                 "reactionLevel": {
                   "type": "string",
                   "enum": [
@@ -720,55 +711,6 @@
                     "extensive"
                   ]
                 },
-                "debounceMs": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "maximum": 9007199254740991
-                },
-                "replyToMode": {
-                  "anyOf": [
-                    {
-                      "type": "string",
-                      "const": "off"
-                    },
-                    {
-                      "type": "string",
-                      "const": "first"
-                    },
-                    {
-                      "type": "string",
-                      "const": "all"
-                    },
-                    {
-                      "type": "string",
-                      "const": "batched"
-                    }
-                  ]
-                },
-                "heartbeat": {
-                  "type": "object",
-                  "properties": {
-                    "showOk": {
-                      "type": "boolean"
-                    },
-                    "showAlerts": {
-                      "type": "boolean"
-                    },
-                    "useIndicator": {
-                      "type": "boolean"
-                    }
-                  },
-                  "additionalProperties": false
-                },
-                "healthMonitor": {
-                  "type": "object",
-                  "properties": {
-                    "enabled": {
-                      "type": "boolean"
-                    }
-                  },
-                  "additionalProperties": false
-                },
                 "pluginHooks": {
                   "type": "object",
                   "properties": {
@@ -783,11 +725,6 @@
                 },
                 "authDir": {
                   "type": "string"
-                },
-                "mediaMaxMb": {
-                  "type": "integer",
-                  "exclusiveMinimum": 0,
-                  "maximum": 9007199254740991
                 }
               },
               "additionalProperties": false
@@ -796,12 +733,6 @@
           "defaultAccount": {
             "type": "string"
           },
-          "mediaMaxMb": {
-            "default": 50,
-            "type": "integer",
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991
-          },
           "actions": {
             "type": "object",
             "properties": {
@@ -824,7 +755,6 @@
         "required": [
           "dmPolicy",
           "groupPolicy",
-          "debounceMs",
           "mediaMaxMb"
         ],
         "additionalProperties": false
@@ -834,20 +764,34 @@
       "uiHints": {
         "": {
           "label": "WhatsApp",
-          "help": "WhatsApp channel provider configuration for access policy and message batching behavior. Use this section to tune responsiveness and direct-message routing safety for WhatsApp chats."
+          "help": "WhatsApp channel provider configuration for access policy and direct-message routing safety."
         },
         "dmPolicy": {
           "label": "WhatsApp DM Policy",
           "help": "Direct message access control (\"pairing\" recommended). \"open\" requires channels.whatsapp.allowFrom=[\"*\"]."
         },
+        "allowFrom": {
+          "presentation": "phone-number"
+        },
+        "defaultTo": {
+          "presentation": "phone-number"
+        },
+        "groupAllowFrom": {
+          "presentation": "phone-number"
+        },
+        "accounts.*.allowFrom.*": {
+          "presentation": "phone-number"
+        },
+        "accounts.*.defaultTo": {
+          "presentation": "phone-number"
+        },
+        "accounts.*.groupAllowFrom.*": {
+          "presentation": "phone-number"
+        },
         "selfChatMode": {
           "label": "WhatsApp Self-Phone Mode",
           "help": "Same-phone setup (bot uses your personal WhatsApp number)."
         },
-        "debounceMs": {
-          "label": "WhatsApp Message Debounce (ms)",
-          "help": "Debounce window (ms) for batching rapid consecutive messages from the same sender (0 to disable)."
-        },
         "configWrites": {
           "label": "WhatsApp Config Writes",
           "help": "Allow WhatsApp to write config in response to channel events/commands (default: true)."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.7.2-beta.3",
+  "version": "2026.7.2-beta.5",
   "description": "OpenClaw WhatsApp channel plugin for WhatsApp Web chats.",
   "repository": {
     "type": "git",
@@ -10,10 +10,10 @@
   "dependencies": {
     "audio-decode": "2.2.3",
     "baileys": "7.0.0-rc13",
-    "typebox": "1.3.3"
+    "typebox": "1.3.6"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.3"
+    "openclaw": ">=2026.7.2-beta.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -26,11 +26,15 @@
     ],
     "setupEntry": "./dist/setup-entry.js",
     "setupFeatures": {
+      "configPromotion": true,
       "legacyStateMigrations": true,
       "legacySessionSurfaces": true
     },
     "channel": {
       "id": "whatsapp",
+      "approvalFlags": [
+        "native"
+      ],
       "label": "WhatsApp",
       "selectionLabel": "WhatsApp (QR link)",
       "detailLabel": "WhatsApp Web",
@@ -42,12 +46,18 @@
         "specifier": "./auth-presence",
         "exportName": "hasAnyWhatsAppAuth"
       },
-      "cliAddOptions": [
-        {
-          "flags": "--auth-dir <path>",
-          "description": "WhatsApp auth directory override"
-        }
-      ]
+      "setup": {
+        "fields": [
+          {
+            "key": "authDir",
+            "kind": "string",
+            "cli": {
+              "flags": "--auth-dir <path>",
+              "description": "WhatsApp auth directory override"
+            }
+          }
+        ]
+      }
     },
     "install": {
       "clawhubSpec": "clawhub:@openclaw/whatsapp",
@@ -56,10 +66,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.3"
+      "pluginApi": ">=2026.7.2-beta.5"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.3"
+      "openclawVersion": "2026.7.2-beta.5"
     },
     "release": {
       "publishToClawHub": true,
@@ -73,7 +83,6 @@
   "files": [
     "dist/**",
     "openclaw.plugin.json",
-    "npm-shrinkwrap.json",
     "README.md",
     "skills/**"
   ],

package/dist/doctor-By3SB4lm.js

@@ -1,48 +0,0 @@
-//#region extensions/whatsapp/src/doctor.ts
-function normalizeCompatibilityConfig({ cfg }) {
-	const legacyAckReaction = cfg.messages?.ackReaction?.trim();
-	if (!legacyAckReaction || cfg.channels?.whatsapp === void 0) return {
-		config: cfg,
-		changes: []
-	};
-	if (cfg.channels.whatsapp?.ackReaction !== void 0) return {
-		config: cfg,
-		changes: []
-	};
-	const legacyScope = cfg.messages?.ackReactionScope ?? "group-mentions";
-	let direct = true;
-	let group = "mentions";
-	if (legacyScope === "all") {
-		direct = true;
-		group = "always";
-	} else if (legacyScope === "direct") {
-		direct = true;
-		group = "never";
-	} else if (legacyScope === "group-all") {
-		direct = false;
-		group = "always";
-	} else if (legacyScope === "group-mentions") {
-		direct = false;
-		group = "mentions";
-	}
-	return {
-		config: {
-			...cfg,
-			channels: {
-				...cfg.channels,
-				whatsapp: {
-					...cfg.channels?.whatsapp,
-					ackReaction: {
-						emoji: legacyAckReaction,
-						direct,
-						group
-					}
-				}
-			}
-		},
-		changes: [`Copied messages.ackReaction → channels.whatsapp.ackReaction (scope: ${legacyScope}).`]
-	};
-}
-const whatsappDoctor = { normalizeCompatibilityConfig };
-//#endregion
-export { whatsappDoctor as n, normalizeCompatibilityConfig as t };

package/dist/normalize-C-Z16y7Q.js

@@ -1,2 +0,0 @@
-import "./normalize-target-DSZnHkKF.js";
-export {};

package/dist/runtime-BfAdAEYT.js

@@ -1,8 +0,0 @@
-import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
-//#region extensions/whatsapp/src/runtime.ts
-const { setRuntime: setWhatsAppRuntime, getRuntime: getWhatsAppRuntime, tryGetRuntime: getOptionalWhatsAppRuntime } = createPluginRuntimeStore({
-	pluginId: "whatsapp",
-	errorMessage: "WhatsApp runtime not initialized"
-});
-//#endregion
-export { getWhatsAppRuntime as n, setWhatsAppRuntime as r, getOptionalWhatsAppRuntime as t };

package/dist/text-runtime-BTGkMN0o.js

@@ -1,4 +0,0 @@
-import "./targets-runtime-Bsh0HR9y.js";
-import { convertMarkdownTables, sanitizeAssistantVisibleText, sanitizeAssistantVisibleTextWithProfile, stripToolCallXmlTags } from "openclaw/plugin-sdk/text-chunking";
-import { normalizeE164, resolveUserPath as resolveUserPath$1 } from "openclaw/plugin-sdk/text-utility-runtime";
-export { sanitizeAssistantVisibleTextWithProfile as a, sanitizeAssistantVisibleText as i, normalizeE164 as n, stripToolCallXmlTags as o, resolveUserPath$1 as r, convertMarkdownTables as t };

package/node_modules/@protobufjs/inquire/CHANGELOG.md

@@ -1,8 +0,0 @@
-# Changelog
-
-## [1.1.2](https://github.com/protobufjs/protobuf.js/compare/inquire-v1.1.1...inquire-v1.1.2) (2026-05-17)
-
-
-### Bug Fixes
-
-* Backport bundler-safe optional module lookups ([#2254](https://github.com/protobufjs/protobuf.js/issues/2254)) ([0853a62](https://github.com/protobufjs/protobuf.js/commit/0853a625680f9247596b84ef48082b8f4e554797))

package/node_modules/@protobufjs/inquire/LICENSE

@@ -1,26 +0,0 @@
-Copyright (c) 2016, Daniel Wirtz  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-* Redistributions of source code must retain the above copyright
-  notice, this list of conditions and the following disclaimer.
-* Redistributions in binary form must reproduce the above copyright
-  notice, this list of conditions and the following disclaimer in the
-  documentation and/or other materials provided with the distribution.
-* Neither the name of its author, nor the names of its contributors
-  may be used to endorse or promote products derived from this software
-  without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/@protobufjs/inquire/README.md

@@ -1,13 +0,0 @@
-@protobufjs/inquire
-===================
-[![npm](https://img.shields.io/npm/v/@protobufjs/inquire.svg)](https://www.npmjs.com/package/@protobufjs/inquire)
-
-Requires a module only if available and hides the require call from bundlers.
-
-API
----
-
-* **inquire(moduleName: `string`): `?Object`**<br />
-  Requires a module only if available.
-
-**License:** [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)

package/node_modules/@protobufjs/inquire/index.d.ts

@@ -1,10 +0,0 @@
-export = inquire;
-
-/**
- * Requires a module only if available.
- * @memberof util
- * @param {string} moduleName Module to require
- * @returns {?Object} Required module if available and not empty, otherwise `null`
- * @deprecated Legacy optional require helper. Will be removed in a future release.
- */
-declare function inquire(moduleName: string): object;