A specialized utility to verify if phone numbers exist within a local WhatsApp session cache.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whatsapp-validate
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install whatsapp-validate using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WhatsApp Validate?
WhatsApp Validate is a technical tool designed to query local Baileys session data to determine if specific phone numbers have previously interacted with your connected WhatsApp account. As a core component of Openclaw Skills, it allows developers and automated agents to perform rapid, local-first lookups without triggering external API rate limits or network latency. This skill is essential for managing session-aware bots that need to distinguish between known contacts and new inquiries.
By leveraging the local data store, this skill ensures high-performance verification for contact management. It provides a bridge between raw session data and actionable logic, making it a vital asset for those building robust communication workflows with Openclaw Skills.
WhatsApp Validate Use Cases
- Verifying if a lead has previously messaged your WhatsApp bot.
- Performing batch checks of contact lists against existing session records.
- Auditing recently seen numbers to segment active users.
- Reducing API overhead by checking local cache before attempting external lookups using Openclaw Skills.
How WhatsApp Validate Works
- The user triggers the skill using the node-based CLI script.
- The skill accesses the local Baileys session cache files associated with the active WhatsApp connection.
- It maps the provided phone numbers to Jabber IDs (JIDs) and searches the internal database.
- The script returns a confirmation of whether the number exists in the session history or a list of known contacts up to a specified limit.
WhatsApp Validate Setup
To use this skill within your environment, follow these steps:
# Navigate to the skill directory
cd path/to/whatsapp-validate
# Ensure node dependencies are present
npm install
# Run a validation check
node scripts/validate.js check "5511999999999"
WhatsApp Validate Data Schema & Taxonomy
The skill interacts with the session cache to identify specific metadata. Below is the structure of how it interprets the local data:
| Attribute | Description |
|---|---|
| JID | The unique WhatsApp identifier (e.g., number@s.whatsapp.net). |
| Session Cache | Local database containing interaction history and contact lists. |
| Command Result | A boolean or list output indicating the presence of a number in the cache. |
WhatsApp Validate Advanced Features
- Batch verification support for processing comma-separated lists of phone numbers.
- Paginated listing of known contacts to audit large session caches.
- Seamless integration into larger Openclaw Skills automation pipelines for intelligent routing.
- Zero-latency local lookup logic that bypasses the need for active internet requests for cached data.
SKILL.md
Loading
Related Openclaw Skills
WhatsApp Utils
A comprehensive toolkit for phone number manipulation, contact management, and message tracking within WhatsApp automation workflows.
WhatsApp Profile Skill
A specialized tool for AI agents to retrieve bot metadata and perform contact profile lookups on WhatsApp.
WhatsApp Labels
A technical utility for listing and searching WhatsApp Business labels and tagged chats directly from a local session cache.
WhatsApp Groups Management
A specialized tool for discovering, searching, and syncing WhatsApp group data directly from Baileys session cache.
Context Management
A technical skill designed to monitor, optimize, and preserve AI agent context windows to prevent performance degradation during complex tasks.
Workspace Standard
A structured, portable workspace framework for AI agents featuring project boundaries, role-based taxonomy, and automated memory management.
Featured*
