OpenClaw WhatsApp Bot: The Complete Business Setup Guide

Why WhatsApp Is the #1 Channel for Business AI

WhatsApp has over 2 billion active users worldwide and is the primary messaging platform in most countries outside the US. For businesses, a WhatsApp AI bot means:

• Meet customers where they already are — no app downloads, no account creation
• 98% message open rate — compared to 20% for email
• Instant responses 24/7 — critical for time-sensitive inquiries
• Rich media support — images, documents, voice notes, locations

Two Ways to Connect: Baileys vs Business API

OpenClaw supports two methods for WhatsApp integration, each with different trade-offs:

Baileys (Recommended for Most Businesses)

Baileys is an open-source library that connects directly to WhatsApp Web, using your personal or business WhatsApp number without needing Meta's official Business API approval.

• Pros: Free (no per-message fees), fast setup (minutes), works with any WhatsApp number, supports all message types
• Cons: Unofficial API (theoretical ban risk, though rare with normal usage), requires QR code scan to authenticate, session needs occasional re-authentication
• Best for: Small-to-medium businesses, quick deployments, cost-conscious setups

Official WhatsApp Business API

The official Meta-approved API for business messaging.

• Pros: Official and supported, green checkmark verification available, higher message limits, no ban risk
• Cons: Per-message fees ($0.005-$0.08 per conversation), requires Meta Business verification (can take weeks), message template approval required for proactive messages
• Best for: Large businesses, high message volume, regulated industries needing official compliance

Setting Up WhatsApp with OpenClaw (Baileys)

Step 1: Configure OpenClaw

Add WhatsApp configuration to your OpenClaw environment:

WHATSAPP_ENABLED=true
WHATSAPP_AUTH_METHOD=baileys
WHATSAPP_SESSION_NAME=your-business-name

Step 2: Authenticate via QR Code

When OpenClaw starts with WhatsApp enabled, it generates a QR code in the terminal. Scan this with WhatsApp on your phone (Settings → Linked Devices → Link a Device). This creates a persistent session.

Step 3: Configure Message Handling

Key settings to configure:

• DM pairing: Only respond to users who send a pairing code first (prevents random messages from triggering AI)
• Group behavior: Respond to mentions only, all messages, or disabled in groups
• Media handling: Configure how the AI processes incoming images, voice notes, and documents
• Response formatting: WhatsApp supports basic formatting (*bold*, _italic_, ~strikethrough~, code)

Step 4: Set Up Security

• User allowlist: Only allow specific phone numbers or area codes
• Rate limiting: Prevent individual users from flooding the bot (10-20 messages/minute is reasonable)
• Content filtering: Block inappropriate content from triggering AI responses

Handling Different Message Types

WhatsApp supports rich media, and your AI should handle each type appropriately:

• Text messages: Standard AI response — this is the primary interaction mode
• Images: AI can describe images (with vision-capable models) or acknowledge receipt ("Thanks for the photo. Let me help you with...")
• Voice notes: Transcribed to text and processed as a text message (requires speech-to-text configuration)
• Documents: PDF and document processing via skills (extract text, answer questions about content)
• Location: Used for location-based queries ("Find the nearest store to this location")
• Contacts: Can be processed for CRM integration or forwarding

WhatsApp Bot Best Practices

1. Identify as AI upfront: "Hi! I'm the AI assistant for [Business]. How can I help?" — transparency builds trust
2. Keep responses short: WhatsApp is a chat app, not email. Aim for 50-150 words per response
3. Use formatting: Bold for key information, bullet points for lists — makes messages scannable
4. Offer clear escalation: "Would you like me to connect you with our team? Just say 'human' anytime."
5. Handle "out of scope" gracefully: "I'm not sure about that, but our team can help. Want me to connect you?"
6. Respect quiet hours: Don't send proactive messages during late hours in the customer's timezone
7. Test with real scenarios: Have your team send the exact questions customers actually ask before going live

Common WhatsApp Bot Pitfalls

• Too-long responses: WhatsApp truncates messages over 4,096 characters. Keep it concise.
• No escalation path: The #1 frustration with chatbots. Always provide a way to reach a human.
• Ignoring media messages: If a customer sends a photo, don't just ignore it. Acknowledge it.
• Generic personality: "I am an AI assistant" is boring. Give your bot a name and personality that matches your brand.
• No session re-auth plan: Baileys sessions expire periodically. Set up alerts and a re-authentication procedure.