gowa

What This Skill Does

The GOWA skill enables your OpenClaw agent to interact directly with WhatsApp via the GOWA (Go WhatsApp Web Multi-Device) REST API. This integration transforms your WhatsApp account into an automated hub, allowing your agent to send text, images, documents, and even trigger ghost mentions (@everyone) in groups. By leveraging the local REST server provided by GOWA, your agent can perform real-time messaging, manage group interactions, and handle multimedia files without needing to touch the WhatsApp interface manually. It is an essential tool for users who want to bridge their AI agent's logic with their personal or professional communication channels.

Installation

1. Download the appropriate GOWA binary for your OS from the official GitHub releases.
2. Execute the binary using the command ./gowa rest to start the local server on http://localhost:3000.
3. Open your browser to http://localhost:3000, scan the generated QR code with your WhatsApp app, and link the device.
4. Install the skill within OpenClaw using the command: clawhub install openclaw/skills/skills/aldinokemal/gowa.
5. Ensure your agent is configured to communicate with the local REST endpoint at http://localhost:3000.

Use Cases

• Automated Notifications: Send alerts or summary reports from your agent directly to a specific WhatsApp group or contact.
• Group Management: Facilitate announcements by utilizing the ghost mention feature to ping every member in a project group.
• File Delivery: Automate the distribution of documents, photos, or audio reports to team members or clients.
• Workflow Integration: Trigger WhatsApp messages based on events detected by other OpenClaw skills (e.g., notifying a user when a file download is complete).

Example Prompts

• "Send a message to my project group 'Alpha' saying 'The morning report is ready' and tag @everyone."
• "Forward the latest invoice image to my accountant via WhatsApp."
• "Send a disappearing message to the team group that says 'Meeting starts in 5 minutes' with a duration of 300 seconds."

Tips & Limitations

• Production Mode: Always ensure GOWA is running in REST mode on port 3000. The agent currently does not support MCP mode for this skill.
• Connectivity: Since this relies on a local WhatsApp session, ensure the computer hosting GOWA remains powered on and connected to the internet.
• Rate Limiting: Do not spam messages; WhatsApp has strict anti-spam policies that may lead to account suspension if the API is used for automated bulk messaging.
• Formatting: When sending files, ensure file paths are absolute and accessible by the agent process to avoid errors.