@openclaw/whatsapp 2026.7.2-beta.5 → 2026.7.33

package/openclaw.plugin.json

@@ -11,7 +11,8 @@
   },
   "contracts": {
     "tools": [
-      "whatsapp_call"
+      "whatsapp_call",
+      "whatsapp_login"
     ]
   },
   "channels": [
@@ -39,6 +40,9 @@
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
         "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
           "capabilities": {
             "type": "array",
             "items": {
@@ -63,9 +67,15 @@
           "configWrites": {
             "type": "boolean"
           },
-          "enabled": {
+          "sendReadReceipts": {
             "type": "boolean"
           },
+          "messagePrefix": {
+            "type": "string"
+          },
+          "responsePrefix": {
+            "type": "string"
+          },
           "dmPolicy": {
             "default": "pairing",
             "type": "string",
@@ -76,6 +86,9 @@
               "disabled"
             ]
           },
+          "selfChatMode": {
+            "type": "boolean"
+          },
           "allowFrom": {
             "type": "array",
             "items": {
@@ -170,108 +183,37 @@
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991
           },
-          "streaming": {
-            "type": "object",
-            "properties": {
-              "chunkMode": {
-                "type": "string",
-                "enum": [
-                  "length",
-                  "newline"
-                ]
-              },
-              "block": {
-                "type": "object",
-                "properties": {
-                  "enabled": {
-                    "type": "boolean"
-                  },
-                  "coalesce": {
-                    "type": "object",
-                    "properties": {
-                      "minChars": {
-                        "type": "integer",
-                        "exclusiveMinimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "maxChars": {
-                        "type": "integer",
-                        "exclusiveMinimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "idleMs": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 9007199254740991
-                      }
-                    },
-                    "additionalProperties": false
-                  }
-                },
-                "additionalProperties": false
-              }
-            },
-            "additionalProperties": false
+          "chunkMode": {
+            "type": "string",
+            "enum": [
+              "length",
+              "newline"
+            ]
           },
-          "heartbeatVisibility": {
+          "blockStreaming": {
+            "type": "boolean"
+          },
+          "blockStreamingCoalesce": {
             "type": "object",
             "properties": {
-              "showOk": {
-                "type": "boolean"
+              "minChars": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
               },
-              "showAlerts": {
-                "type": "boolean"
+              "maxChars": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
               },
-              "useIndicator": {
-                "type": "boolean"
+              "idleMs": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
               }
             },
             "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": {
@@ -359,6 +301,32 @@
               "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": [
@@ -368,6 +336,56 @@
               "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": {
@@ -385,6 +403,9 @@
             "additionalProperties": {
               "type": "object",
               "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
                 "capabilities": {
                   "type": "array",
                   "items": {
@@ -409,9 +430,15 @@
                 "configWrites": {
                   "type": "boolean"
                 },
-                "enabled": {
+                "sendReadReceipts": {
                   "type": "boolean"
                 },
+                "messagePrefix": {
+                  "type": "string"
+                },
+                "responsePrefix": {
+                  "type": "string"
+                },
                 "dmPolicy": {
                   "type": "string",
                   "enum": [
@@ -421,6 +448,9 @@
                     "disabled"
                   ]
                 },
+                "selfChatMode": {
+                  "type": "boolean"
+                },
                 "allowFrom": {
                   "type": "array",
                   "items": {
@@ -514,107 +544,37 @@
                   "exclusiveMinimum": 0,
                   "maximum": 9007199254740991
                 },
-                "streaming": {
-                  "type": "object",
-                  "properties": {
-                    "chunkMode": {
-                      "type": "string",
-                      "enum": [
-                        "length",
-                        "newline"
-                      ]
-                    },
-                    "block": {
-                      "type": "object",
-                      "properties": {
-                        "enabled": {
-                          "type": "boolean"
-                        },
-                        "coalesce": {
-                          "type": "object",
-                          "properties": {
-                            "minChars": {
-                              "type": "integer",
-                              "exclusiveMinimum": 0,
-                              "maximum": 9007199254740991
-                            },
-                            "maxChars": {
-                              "type": "integer",
-                              "exclusiveMinimum": 0,
-                              "maximum": 9007199254740991
-                            },
-                            "idleMs": {
-                              "type": "integer",
-                              "minimum": 0,
-                              "maximum": 9007199254740991
-                            }
-                          },
-                          "additionalProperties": false
-                        }
-                      },
-                      "additionalProperties": false
-                    }
-                  },
-                  "additionalProperties": false
+                "chunkMode": {
+                  "type": "string",
+                  "enum": [
+                    "length",
+                    "newline"
+                  ]
                 },
-                "heartbeatVisibility": {
+                "blockStreaming": {
+                  "type": "boolean"
+                },
+                "blockStreamingCoalesce": {
                   "type": "object",
                   "properties": {
-                    "showOk": {
-                      "type": "boolean"
+                    "minChars": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     },
-                    "showAlerts": {
-                      "type": "boolean"
+                    "maxChars": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
                     },
-                    "useIndicator": {
-                      "type": "boolean"
+                    "idleMs": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
                     }
                   },
                   "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": {
@@ -702,6 +662,32 @@
                     "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": [
@@ -711,6 +697,55 @@
                     "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": {
@@ -725,6 +760,11 @@
                 },
                 "authDir": {
                   "type": "string"
+                },
+                "mediaMaxMb": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
                 }
               },
               "additionalProperties": false
@@ -733,6 +773,12 @@
           "defaultAccount": {
             "type": "string"
           },
+          "mediaMaxMb": {
+            "default": 50,
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991
+          },
           "actions": {
             "type": "object",
             "properties": {
@@ -755,6 +801,7 @@
         "required": [
           "dmPolicy",
           "groupPolicy",
+          "debounceMs",
           "mediaMaxMb"
         ],
         "additionalProperties": false
@@ -764,34 +811,20 @@
       "uiHints": {
         "": {
           "label": "WhatsApp",
-          "help": "WhatsApp channel provider configuration for access policy and direct-message routing safety."
+          "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."
         },
         "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.5",
+  "version": "2026.7.33",
   "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.6"
+    "typebox": "1.3.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.5"
+    "openclaw": ">=2026.7.33"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -26,15 +26,11 @@
     ],
     "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",
@@ -43,21 +39,15 @@
       "blurb": "works with your own number; recommend a separate phone + eSIM.",
       "systemImage": "message",
       "persistedAuthState": {
-        "specifier": "./auth-presence",
+        "specifier": "./dist/auth-presence.js",
         "exportName": "hasAnyWhatsAppAuth"
       },
-      "setup": {
-        "fields": [
-          {
-            "key": "authDir",
-            "kind": "string",
-            "cli": {
-              "flags": "--auth-dir <path>",
-              "description": "WhatsApp auth directory override"
-            }
-          }
-        ]
-      }
+      "cliAddOptions": [
+        {
+          "flags": "--auth-dir <path>",
+          "description": "WhatsApp auth directory override"
+        }
+      ]
     },
     "install": {
       "clawhubSpec": "clawhub:@openclaw/whatsapp",
@@ -66,10 +56,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.5"
+      "pluginApi": ">=2026.7.33"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.5"
+      "openclawVersion": "2026.7.33"
     },
     "release": {
       "publishToClawHub": true,