How to Run an AI Agent on WhatsApp

Quick Answer

You can run an AI agent on WhatsApp by setting up OpenClaw (or a similar open agent) and connecting it to WhatsApp via the built-in channel integration. Once connected, your agent appears as a regular WhatsApp contact that you can message from anywhere — ask it to research things, summarise links, manage files, send you briefings, and handle automations, all from your phone.

Why WhatsApp?

The appeal of running an AI agent on WhatsApp is simple: it's where you already are. Instead of opening a separate app or browser tab, you message your agent the same way you'd message a friend. This makes it dramatically more likely you'll actually use it. An agent buried in a dashboard gets forgotten. An agent in your WhatsApp gets used every day.

WhatsApp also gives you access from anywhere — your phone, your desktop, your tablet. Your agent is always one message away, whether you're at your desk or on a train. And because WhatsApp supports voice notes, images, and file sharing, you can send your agent content to work with in whatever format is easiest for you.

What You'll Need

To run an AI agent on WhatsApp, you need an AI agent framework installed and running (OpenClaw is the most common choice), a dedicated phone number or WhatsApp account for your agent to use, and a model API key for the LLM your agent will use (Claude, OpenAI, etc.).

One important note: your agent needs its own WhatsApp identity. You can't run it on your personal number simultaneously. Most people either use a cheap SIM card or a virtual number service. This is the one part of the setup that requires a small bit of planning.

Setting It Up With OpenClaw

Step 1: Get OpenClaw Running

If you haven't already, install OpenClaw and complete the onboarding wizard. Our setup guide covers this in detail. You should have your agent running and accessible via the Control UI before proceeding.

Step 2: Open Channel Settings

In the OpenClaw Control UI, navigate to Settings → Channels. You'll see a list of available integrations. Select WhatsApp.

Step 3: Scan the QR Code

OpenClaw uses the WhatsApp Web protocol to connect. You'll be shown a QR code in the Control UI. Open WhatsApp on the phone with your agent's number, go to Linked Devices, and scan the code. This links your agent to WhatsApp the same way you'd link WhatsApp Web on a computer.

Step 4: Send a Test Message

From your personal WhatsApp account, send a message to your agent's number. Ask it something simple — "What's the weather in London?" or "Summarise this article" followed by a link. If you get a response, you're live.

Step 5: Configure Behaviour

By default, your agent will respond to any message sent to its number. You can configure who it responds to (whitelist specific contacts), how it handles group chats, and what skills are available through WhatsApp specifically. This is all managed through the OpenClaw Control UI or the agent's SOUL.md configuration file.

What Works Well on WhatsApp

Some tasks are particularly well-suited to the WhatsApp interface because of how naturally they fit into a messaging workflow.

Quick research. Message your agent "what's the latest on [topic]?" and get a summary back in seconds. No need to open a browser, formulate a search, and read through results.

Content summarisation. Forward a link, a PDF, or a voice note from a colleague and ask your agent to summarise it. Particularly useful when you're on the move and don't have time to read something in full.

Daily briefings. Schedule your agent to send you a morning summary at a set time. It arrives in WhatsApp like any other message — calendar events, weather, news digest, tasks for the day.

Quick drafts. Ask your agent to draft a message or email reply while you're between meetings. Review it in WhatsApp, tweak it, and send it from your email when you're ready.

Voice notes. Send your agent a voice note describing something you need done, and it will transcribe and act on it. This is one of the most underappreciated features — dictating tasks is faster than typing them.

What Doesn't Work as Well

Long-form content creation is better handled through the Control UI or a desktop channel. WhatsApp has message length limits and the mobile interface isn't ideal for reviewing long documents. Similarly, anything involving complex file management is easier in a desktop context where you can see folder structures and open files directly.

The rule of thumb: if the task fits in a quick back-and-forth exchange, WhatsApp is perfect. If it requires extended context or reviewing large outputs, use a desktop channel.

WhatsApp vs Telegram for Your Agent

Both work well, but there are differences. Telegram is more bot-friendly by design — the Bot API is well-documented, there are no approval processes, and the developer community is large. WhatsApp requires a separate phone number and uses the Web protocol, which can occasionally need re-linking.

On the other hand, WhatsApp is where most people already spend their time. If the goal is to make your agent as easy to reach as possible, WhatsApp's ubiquity is hard to beat. Many people run both — WhatsApp for quick personal use and Telegram for more experimental or development-oriented work.

Keeping It Running 24/7

If you're running OpenClaw on your laptop, your WhatsApp agent goes offline when the laptop sleeps. For a messaging-based agent, this matters — you want it available whenever you think to message it, not just during working hours.

The solution is to run your agent on a server that stays on permanently. You can set this up on a cheap VPS, or use Tulip, which provides always-on infrastructure specifically designed for running open agents. Tulip handles the compute, model inference, and uptime so your WhatsApp agent is always ready to respond.

Frequently Asked Questions

Can I use my personal WhatsApp number?

Not simultaneously. Your agent needs its own WhatsApp identity. Most people get a cheap prepaid SIM or a virtual number. This also keeps your personal messages separate from agent interactions, which is a good idea in general.

Is this against WhatsApp's terms of service?

WhatsApp's terms prohibit automated bulk messaging and commercial bots on personal accounts. Running a personal agent for your own use on a dedicated number is a grey area. For business or team use at scale, the official WhatsApp Business API is the compliant route. OpenClaw's WhatsApp integration is best suited for personal experimentation and individual productivity.

Will it work in WhatsApp groups?

Yes, with configuration. You can set your agent to respond when mentioned by name or when a message starts with a trigger word. Most people keep group responses off by default and enable them selectively for specific groups where they want the agent active.

What happens if the connection drops?

The WhatsApp Web link can occasionally expire, requiring you to re-scan the QR code. This is a known limitation of the Web protocol. Running on a stable server reduces the frequency of disconnections. If it does drop, messages sent while the agent was offline will be processed when it reconnects.

Can my agent send me images and files via WhatsApp?

Yes. OpenClaw can send images, documents, and other file types through WhatsApp. This is useful for things like receiving generated reports, charts, or screenshots from your agent directly in the chat.