How it works
EasyClaw connects to WhatsApp using the same protocol as WhatsApp Web. You scan a QR code from EasyClaw, and your AI assistant becomes accessible through WhatsApp — to you or anyone you allow. The WhatsApp bridge runs inside your private container, maintaining a persistent connection. Messages are processed locally in your container and never stored on EasyClaw’s servers.Setup
Scan from your phone
Open WhatsApp on your phone → Settings → Linked Devices → Link a Device → Scan the QR code.
Contact filtering
You can control who can talk to your AI assistant on WhatsApp:| Mode | Description |
|---|---|
| Everyone | Any WhatsApp contact who messages you gets a response from your AI |
| Allowlist | Only specific phone numbers can interact with your AI |
| Only me | Only your own phone number gets AI responses |
How the bridge works
Under the hood, EasyClaw implements the WhatsApp Web protocol inside your container. The bridge:- Maintains a persistent connection to WhatsApp’s servers
- Receives incoming messages and forwards them to ZeroClaw
- Sends ZeroClaw’s responses back through WhatsApp
- Handles media (images, documents, voice messages)
WhatsApp links expire after about 14 days of inactivity. If your container has been frozen for a long time, you may need to re-scan the QR code.
Limitations
- One phone number per connection — each session connects to one WhatsApp account
- Personal protocol — EasyClaw uses the personal WhatsApp protocol, not the Business API
- Media support — text and images are fully supported, voice messages are transcribed, video support is limited