OpenClaw WhatsApp Integration Guide (Wacli): Setup, Messaging & Privacy

WhatsApp has over two billion active users worldwide, making it the single largest messaging platform on the planet. The OpenClaw WhatsApp Integration, powered by the Wacli CLI tool, lets your AI agent tap into this massive user base --- sending messages, searching conversation history, and automating communication workflows directly through WhatsApp.

Unlike the Telegram integration which uses an official bot API, WhatsApp integration works through Wacli, a third-party CLI tool that bridges WhatsApp Web with your agent. This approach has important implications for setup, reliability, and privacy that we will cover in detail.

OpenClaw WhatsApp integration powered by Wacli showing connected status

What the WhatsApp Skill Does

The Wacli-based WhatsApp skill provides your OpenClaw agent with these capabilities:

Send messages --- Text messages to individual contacts or groups
Search conversations --- Query message history across all chats
Read messages --- Access recent messages in specific conversations
List contacts --- View available contacts and groups
Send media --- Share images and documents via WhatsApp
Monitor incoming --- React to new messages in real-time

The skill bridges the gap between WhatsApp's consumer-focused platform and the automation capabilities of OpenClaw, enabling workflows that would otherwise require manual phone interaction.

How to Install

Step 1: Install Wacli

Wacli is the underlying CLI tool that provides WhatsApp connectivity. Install it first:

# macOS
brew install wacli

# Linux
curl -sSL https://get.wacli.dev | sh

# Or via npm
npm install -g wacli

Step 2: Install the OpenClaw Skill

openclaw skill install whatsapp

Step 3: Authenticate with WhatsApp

wacli auth

This displays a QR code in your terminal. Scan it with WhatsApp on your phone (Settings > Linked Devices > Link a Device). Once scanned, Wacli maintains a persistent session.

Setup and Configuration

Basic Configuration

{
  "whatsapp": {
    "wacli_path": "/usr/local/bin/wacli",
    "session_persistence": true,
    "message_handling": {
      "auto_read": false,
      "typing_indicator": true,
      "max_message_length": 4096
    },
    "privacy": {
      "log_messages": false,
      "allowed_contacts": [],
      "blocked_contacts": []
    }
  }
}

Session Management

Wacli sessions persist across restarts, but WhatsApp occasionally requires re-authentication (typically every 14 days or after a phone restart). When the session expires, the skill will notify your agent, and you will need to re-scan the QR code.

To check session status:

wacli status

Contact Allowlisting

For production use, always restrict which contacts your agent can message:

{
  "privacy": {
    "allowed_contacts": ["+1234567890", "+0987654321"],
    "allowed_groups": ["Group Name 1", "Group Name 2"]
  }
}

When allowed_contacts is empty, the agent can message anyone in your contact list --- which is rarely what you want.

Key Features Walkthrough

1. Sending Messages

The most straightforward feature. Your agent can compose and send messages to any contact or group:

Agent: I'll send that update to the client now.
[Tool call: whatsapp_send_message]
  to: "+1234567890"
  message: "Hi Sarah, the project report is ready. I've attached it to the email I just sent."

Messages support standard WhatsApp formatting: bold, italic, ~~strikethrough~~, and monospace.

2. Conversation Search

This is where Wacli really differentiates itself. Your agent can search through your entire WhatsApp history:

Agent: Let me find what they said about the deadline.
[Tool call: whatsapp_search]
  query: "deadline extension"
  contact: "+1234567890"
  limit: 10

The search returns timestamped messages with sender information, allowing your agent to reference previous conversations and maintain context.

3. Reading Recent Messages

Pull the latest messages from a specific conversation:

Agent: Let me check the latest messages in the team group.
[Tool call: whatsapp_read_messages]
  chat: "Engineering Team"
  count: 20

This is useful for catching up on conversations, summarizing group discussions, or checking if someone has responded to a previous message.

4. Media Sharing

Send images and documents alongside text messages. This pairs well with other skills --- for example, generating a chart with a data visualization tool and sending it via WhatsApp.

5. Typing Indicators

When typing_indicator is enabled, the skill simulates the "typing..." status before sending a message. This makes automated responses feel more natural to recipients who do not know they are chatting with an AI agent.

Features overview showing messaging, search, and media capabilities

Privacy Considerations

WhatsApp integration carries significant privacy implications that you should carefully consider.

Data Access

When you authenticate Wacli, it gains access to your entire WhatsApp account --- all conversations, contacts, and media. This is fundamentally different from Telegram bots, which only see messages explicitly sent to them.

Recommendations

Use a dedicated phone number --- Do not connect your personal WhatsApp account. Get a separate number for your agent.
Disable message logging --- Set log_messages: false unless you specifically need conversation records.
Restrict contacts --- Always use allowed_contacts to limit who the agent can message.
Review WhatsApp ToS --- Automated messaging may violate WhatsApp's Terms of Service. Business API is the officially supported path for automation.
Inform recipients --- Let people know they may be interacting with an AI agent.

WhatsApp Business API Alternative

For legitimate business use, consider the official WhatsApp Business API instead of Wacli. It is more reliable, officially supported, and designed for automated messaging. However, it requires business verification and has per-message costs.

For email-based communication that avoids these privacy concerns entirely, Inbounter provides a clean API for sending transactional and marketing emails without the complexities of consumer messaging platforms.

Real-World Use Cases

Appointment Reminders

A small clinic uses the WhatsApp skill to send appointment reminders to patients. The agent checks the next day's schedule, composes personalized messages, and sends them at an appropriate time. For patients who prefer email, the same agent uses Inbounter to send email reminders.

Order Notifications

An e-commerce seller sends order confirmations and shipping updates via WhatsApp. When an order status changes, the agent composes a message with tracking details and sends it to the customer's WhatsApp number.

Team Coordination

A project manager uses the skill to send daily standup summaries to a WhatsApp group. The agent compiles status updates from various tools and posts a formatted summary each morning.

Customer Follow-ups

A sales professional uses the skill to search past WhatsApp conversations with prospects, identify follow-up opportunities, and send personalized messages referencing previous discussions.

Use case diagram showing appointment reminders and order notifications

Pros and Cons

Pros

Massive reach --- Access to WhatsApp's 2B+ user base
Conversation search --- Powerful history search across all chats
Natural interaction --- Messages appear as normal WhatsApp messages
Media support --- Send images, documents, and formatted text
No recipient setup required --- Unlike Telegram bots, recipients do not need to start a conversation first

Cons

Privacy risks --- Full access to your WhatsApp account
Session fragility --- Sessions can expire, requiring QR re-scan
ToS concerns --- Automated messaging may violate WhatsApp's Terms of Service
No official API --- Wacli is a third-party tool, not officially supported by Meta
Single account --- Tied to one phone number at a time
Rate limits --- WhatsApp aggressively limits automated-seeming messages and can ban numbers

Verdict and Rating

Rating: 3.5 / 5

The OpenClaw WhatsApp Integration via Wacli is a capable but risky tool. The ability to send messages through WhatsApp and search conversation history is genuinely useful, and the installation process is straightforward. However, the privacy implications, Terms of Service concerns, and session fragility make it less reliable than the Telegram integration for production use.

For personal automation or small-scale use with a dedicated phone number, it works well. For business communications at scale, you are better served by the official WhatsApp Business API or by alternative channels like Inbounter's email and SMS API, which offers reliable, officially supported communication without the risks associated with consumer messaging platform workarounds.

Alternatives

WhatsApp Business API --- Official, supported, but requires business verification and has per-message costs
Inbounter Email & SMS API --- For professional communication via email or SMS without WhatsApp's restrictions
OpenClaw Telegram Integration --- More reliable bot infrastructure with official API support
Twilio WhatsApp --- Officially partnered WhatsApp Business API provider

Rating summary with score and category breakdown

FAQ

Q: Will using Wacli get my WhatsApp number banned? A: There is a risk. WhatsApp actively detects and bans numbers that send automated messages at scale. Using a dedicated number, limiting message volume, and adding delays between messages reduces but does not eliminate this risk.

Q: Can I use this with WhatsApp Business? A: Wacli works with both regular WhatsApp and WhatsApp Business apps. However, for true business automation, the official WhatsApp Business API is the recommended path.

Q: How reliable is the Wacli session? A: Sessions typically last 7-14 days before requiring re-authentication. Phone restarts, WhatsApp updates, or connecting from a new device can also invalidate the session.

Q: Can the agent receive and respond to messages automatically? A: Yes, when configured for monitoring mode. The agent can watch for incoming messages and respond based on your configured rules. However, be cautious with auto-responses to avoid appearing as spam.

Q: Is there a better option for transactional messaging? A: For transactional messages like order confirmations, password resets, or appointment reminders, Inbounter provides a more reliable and officially supported solution via email and SMS, without the risks of consumer messaging platform automation.

Read more OpenClaw skill reviews: Telegram Integration, Google Workspace (gogcli), and Discord Bot.