A technical utility for listing and searching WhatsApp Business labels and tagged chats directly from a local session cache.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whatsapp-labels
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-labels 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 Labels?
The WhatsApp Labels skill is a specialized tool designed to help developers and businesses interact with WhatsApp Business organization features. By leveraging the local session cache, it provides an efficient way to programmatically retrieve label metadata and filter chat threads based on assigned tags. This skill is an essential part of the Openclaw Skills library for those building automated messaging workflows that require high levels of organization.
WhatsApp Labels Use Cases
- Listing all active labels in a WhatsApp Business account to audit organization structures.
- Filtering and finding specific chat threads assigned to categories like VIP Client or Lead.
- Automating the retrieval of tagged conversations for CRM synchronization.
- Enhancing AI agent context by identifying the priority or status of a chat through its label.
How WhatsApp Labels Works
- The skill connects to the local WhatsApp session cache where business metadata is stored.
- A Node.js script is executed with specific commands to either list all labels or search for chats.
- The script parses the cache data to find matches for the requested label names.
- The resulting labels or chat IDs are returned to the console or calling agent for further action.
WhatsApp Labels Setup
Before using this skill, ensure you have an active WhatsApp Business account and a local session established. Use the following commands to configure and test the skill:
# Install the necessary dependencies within the skill directory
npm install
# List all available labels to confirm connectivity
node scripts/labels.js list
# Search for chats associated with a specific label
node scripts/labels.js chats "VIP Client"
WhatsApp Labels Data Schema & Taxonomy
The skill manages label metadata and chat associations. The following table describes the data structure utilized by this component of the Openclaw Skills ecosystem:
| Data Point | Type | Description |
|---|---|---|
| Label Name | String | The display name of the WhatsApp Business tag (e.g., New Customer). |
| Chat ID | String | The unique identifier for a WhatsApp chat session. |
| Session Cache | File | The local storage containing the serialized business label mappings. |
WhatsApp Labels Advanced Features
- Direct local cache access for ultra-fast label retrieval without external API calls.
- Support for complex label names including spaces and special characters using string arguments.
- Modular script design allowing for easy integration into larger Openclaw Skills automation pipelines.
- Low-overhead execution optimized for local development environments and AI coding agents.
SKILL.md
Loading
Related Openclaw Skills
WhatsApp Groups Management
A specialized tool for discovering, searching, and syncing WhatsApp group data directly from Baileys session cache.
WhatsApp Group Admin
Streamline WhatsApp group management through command-line utilities for info, stats, and templates.
WhatsApp Forward
A utility-driven skill for programmatically generating contact VCards, parsing group invite links, and managing forwarding templates.
WhatsApp Contacts
A specialized skill to list, search, and lookup WhatsApp contacts directly from the local Baileys session cache.
WhatsApp Profile Skill
A specialized tool for AI agents to retrieve bot metadata and perform contact profile lookups on WhatsApp.
WhatsApp Utils
A comprehensive toolkit for phone number manipulation, contact management, and message tracking within WhatsApp automation workflows.
Featured*
