WhatsApp AI Bot: Complete Setup Guide 2026

Want to add AI capabilities to your WhatsApp? In this comprehensive guide, you’ll learn how to create a powerful WhatsApp AI bot using Clawdbot — a free, open-source solution that runs entirely on your own computer.

What You’ll Build

By the end of this guide, you’ll have:

• A WhatsApp bot that responds intelligently to messages
• Support for voice messages (automatic transcription)
• Image understanding capabilities
• Complete privacy — everything runs locally

Why Clawdbot for WhatsApp AI?

Feature	Clawdbot	Cloud Services
Cost	Free (pay only for AI API)	$20-100+/month
Privacy	100% local	Data on their servers
Customization	Full control	Limited
AI Models	Any (Claude, GPT-4, local)	Usually locked to one

Prerequisites

Before we start, you’ll need:

1. A computer running macOS, Windows, or Linux
2. Node.js 18+ installed
3. WhatsApp on your phone
4. An AI API key (Claude, OpenAI, or others)

Step 1: Install Clawdbot

Open your terminal and run:

npm install -g clawdbot

Verify the installation:

clawdbot --version

Step 2: Run Initial Setup

Launch the setup wizard:

clawdbot onboard

The wizard will guide you through:

• Choosing your AI provider (Claude recommended)
• Entering your API key
• Basic configuration

Step 3: Connect WhatsApp

Add WhatsApp as a messaging channel:

clawdbot channels add whatsapp

A QR code will appear in your terminal. Scan it with WhatsApp:

1. Open WhatsApp on your phone
2. Go to Settings → Linked Devices
3. Tap Link a Device
4. Scan the QR code

Step 4: Configure Your Bot

Set Allowed Contacts

For safety, restrict who can use your bot:

clawdbot config set whatsapp.allowList "+1234567890,+0987654321"

Choose Response Mode

# Respond to all messages from allowed contacts
clawdbot config set whatsapp.autoReply true

# Or use a trigger word
clawdbot config set whatsapp.trigger "@ai"

Step 5: Start Your Bot

clawdbot gateway

Your WhatsApp AI bot is now live! Send it a message to test.

Advanced Features

Voice Message Support

Enable automatic transcription of voice messages:

clawdbot config set whatsapp.transcribeVoice true

Image Understanding

Let your bot analyze images:

clawdbot config set whatsapp.processImages true

Custom Personality

Give your bot a unique personality:

clawdbot config set ai.systemPrompt "You are a helpful assistant named Aria. You're friendly, concise, and always try to be helpful."

Use Cases

Personal Assistant

• Set reminders
• Answer questions
• Translate messages
• Summarize long texts

Customer Support

• Handle common inquiries
• Provide product information
• Route complex issues to humans

Study Buddy

• Explain concepts
• Quiz you on topics
• Help with homework (ethically!)

Troubleshooting

QR Code Not Scanning

• Make sure your terminal window is large enough
• Try: clawdbot channels add whatsapp --qr-size small

Bot Not Responding

• Check if gateway is running: clawdbot status
• Verify the sender is in your allow list
• Check AI provider status

Connection Drops

• Keep your phone connected to internet
• Disable battery optimization for WhatsApp
• Run clawdbot gateway in a terminal multiplexer like tmux

Cost Estimation

Clawdbot itself is free. You only pay for AI API usage:

Usage Level	Estimated Monthly Cost
Light (100 msgs/day)	$2-5
Moderate (500 msgs/day)	$10-20
Heavy (2000+ msgs/day)	$30-50+

Costs vary by AI provider and response length

Privacy & Security

Your WhatsApp messages never touch Clawdbot’s servers:

1. Messages go directly from WhatsApp to your computer
2. Your computer sends the text to your chosen AI provider
3. The response comes back through your computer
4. Everything stays encrypted end-to-end

Conclusion

You now have a fully functional WhatsApp AI bot running on your own machine. Unlike cloud services, you have complete control over your data and can customize everything to your needs.

Related Guides

• Connect Telegram — Add another platform
• Install on Windows — Windows-specific setup
• Voice Assistant — Add voice features

---

Have questions? Join our Discord community or check the documentation.