A comprehensive tool enabling AI agents to interact with WhatsApp through the Evolution API v2 for automated messaging and management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install evolution-whatsapp
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 evolution-whatsapp 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 Evolution WhatsApp Skill?
The Evolution WhatsApp Skill provides a bridge between your AI agents and the WhatsApp messaging platform using the robust Evolution API v2. It allows for seamless programmatic control over WhatsApp accounts, enabling developers to build sophisticated communication workflows within the Openclaw Skills framework.
By utilizing this skill, agents can perform a wide range of actions from simple text replies to complex group administration tasks and interactive polling. It is designed for developers who need reliable, API-driven access to WhatsApp for customer support, automated notifications, or internal team coordination.
Evolution WhatsApp Skill Use Cases
- Automating customer notifications and alerts directly through WhatsApp.
- Generating and sending AI-driven summaries of active group chat conversations.
- Facilitating user interaction through buttons, lists, and polls for structured data collection.
- Managing media distribution including images, videos, and voice notes at scale.
How Evolution WhatsApp Skill Works
- The AI agent identifies a communication task that requires WhatsApp interaction.
- The skill connects to a self-hosted or managed Evolution API instance using the configured base URL and tokens.
- The agent sends the payload (text, media, or management command) to the Evolution API endpoint.
- The Evolution API instance transmits the request to the WhatsApp network via the connected instance.
- Results, such as delivery status or fetched chat history, are returned to the agent within the Openclaw Skills environment.
Evolution WhatsApp Skill Setup
To use this skill, you must have an active Evolution API instance. Configure the following environment variables in your shell or configuration file:
export EVO_BASE_URL="https://your-evo-instance.com"
export EVO_INSTANCE_TOKEN="your-instance-token"
export EVO_INSTANCE_NAME="YourInstanceName"
Ensure your instance is paired with a WhatsApp account via QR code before attempting to send messages.
Evolution WhatsApp Skill Data Schema & Taxonomy
The skill manages data through the Evolution API v2 specification. The primary data structures involved include:
| Attribute | Description |
|---|---|
| EVO_BASE_URL | The API endpoint for your Evolution instance. |
| EVO_INSTANCE_TOKEN | The security bearer token for authentication. |
| EVO_INSTANCE_NAME | The specific WhatsApp instance identifier. |
| Payload Types | Supports JSON payloads for text, mediaUrl, location coordinates, and poll arrays. |
Evolution WhatsApp Skill Advanced Features
- Support for diverse media formats including stickers, audio voice notes, and document attachments.
- Advanced group management tools for creating and auditing chat groups.
- Interactive messaging capabilities using native WhatsApp buttons and list menus.
- Context-aware conversation fetching to allow AI agents to maintain history through Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Opencode Controller
A professional-grade command interface for orchestrating Opencode sessions, agent modes, and model provider configurations.
Beszel Monitoring
A specialized monitoring skill for tracking home lab server health and container resource usage via the Beszel platform.
OpenClaw Operations
A comprehensive administrative toolkit for managing OpenClaw installations, configuration, security auditing, and gateway services via the command line.
Memory Architect
A sophisticated memory management skill that restructures monolithic markdown files into a high-performance tiered storage system and relationship graph.
MarkItDown Document Converter
A versatile document conversion engine for transforming various file formats into clean, structured Markdown.
OpenClaw Documentation Search & Config Patterns
A specialized documentation search and configuration guardrail system designed to prevent errors when modifying OpenClaw agent settings.
Featured*
