A specialized tool for discovering, searching, and syncing WhatsApp group data directly from Baileys session cache.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whatsapp-groups
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-groups 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 Groups Management?
The WhatsApp Groups skill provides a robust interface for AI agents to interact with WhatsApp group metadata. By parsing local Baileys session files, it enables agents to identify group memberships without requiring complex API calls or manual lookup. This tool is a critical component for developers building automated workflows within Openclaw Skills that require group-specific interactions, such as broadcasting updates or monitoring specific community chats.
Whether you are managing a single bot or a fleet of automated accounts, this skill streamlines the process of fetching unique group identifiers (JIDs) and keeping your local configuration in sync with the live state of your WhatsApp account. It ensures that your automation logic remains accurate and responsive to group changes.
WhatsApp Groups Management Use Cases
- Automatically identifying the correct group JID for automated message broadcasting.
- Searching through extensive group lists to find specific community chats by name.
- Keeping local bot configuration files synchronized with active group memberships.
- Auditing bot participation across multiple WhatsApp groups for session management.
How WhatsApp Groups Management Works
- The skill accesses the existing Baileys session directory where chat and group metadata are stored.
- When a command is triggered, the Node.js script reads the session cache to extract group names and identifiers.
- The script filters or processes the data based on the provided command (list, search, get-id, or sync).
- A structured JSON response is returned, allowing the AI agent to use the data for subsequent automation steps.
WhatsApp Groups Management Setup
To use this skill, ensure your Baileys session is active and point the script to your session data.
# List all groups the bot is part of
node scripts/groups.js list
# Search for a specific group by its name
node scripts/groups.js search "Marketing Team"
# Retrieve a specific Group ID for messaging scripts
node scripts/groups.js get-id "Support Group"
WhatsApp Groups Management Data Schema & Taxonomy
The skill returns a JSON object containing the summary and a detailed list of group objects. This structure is designed for easy consumption by other Openclaw Skills.
| Property | Type | Description |
|---|---|---|
| total | Integer | The total number of groups discovered in the session. |
| groups | Array | A collection of group objects. |
| groups[].id | String | The unique WhatsApp Group JID (e.g., 12345@g.us). |
| groups[].name | String | The display name of the group. |
| groups[].isActive | Boolean | Indicates if the group is currently active in the session. |
WhatsApp Groups Management Advanced Features
- Direct session parsing for high-speed metadata retrieval without active network requests.
- Fuzzy search capabilities to find groups even with partial name matches.
- Automated configuration synchronization to bridge session data with local application state.
- Seamless integration with messaging skills for targeted group automation.
SKILL.md
Loading
Related Openclaw Skills
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 Common Groups
A specialized tool for identifying shared WhatsApp groups between contacts and verifying membership across multiple chat environments.
WhatsApp Labels
A technical utility for listing and searching WhatsApp Business labels and tagged chats directly from a local session cache.
WhatsApp Profile Skill
A specialized tool for AI agents to retrieve bot metadata and perform contact profile lookups on WhatsApp.
Featured*
