whatsapp-contacts

What This Skill Does

The whatsapp-contacts skill provides a structured interface for OpenClaw agents to interact with the Baileys WhatsApp session cache. By utilizing this skill, an agent can programmatically retrieve, filter, and inspect contact information directly from the local environment where the WhatsApp session is active. This removes the need for manual contact lookup, allowing for seamless integration of WhatsApp contacts into automated workflows or intelligent agent responses. The skill supports three primary functions: listing contacts with pagination, performing fuzzy searches by name or phone number, and retrieving full details for specific contact identifiers.

Installation

You can integrate this skill into your environment using the ClawHub CLI. Run the following command in your terminal: clawhub install openclaw/skills/skills/marcosrippel/whatsapp-contacts

Use Cases

This skill is highly valuable for personal productivity and business automation tasks. Common use cases include:

• Rapidly identifying a contact's JID or phone number during a conversation for quick reference.
• Maintaining a dynamic contact list for customer support or client outreach workflows.
• Automating CRM-like data retrieval where the agent needs to verify contact details before sending messages or triggering external API calls.
• Contextualizing user queries by pulling up profile information from previous interactions.

Example Prompts

1. "Check my WhatsApp contacts and find the phone number for 'John Doe'."
2. "List the last 20 WhatsApp contacts I have interacted with."
3. "Can you retrieve the full profile information for the number 5511999999999?"

Tips & Limitations

It is important to note that this skill relies entirely on the local Baileys session cache. This means that if you have not interacted with a specific user or group recently, or if the session cache has been cleared, the contact will not appear in the results. This is not a global contact database, but rather a reflection of the current session's history. Ensure your Baileys session is active and authenticated before running these commands, as the script requires access to the underlying JSON session data files. For developers, this provides a lightweight way to build local WhatsApp automation tools without requiring complex database setups.