Docs/Connect WhatsApp
📱

Connect WhatsApp

Let your AI Agent reply to WhatsApp messages

How It Works

📱
Your Phone
WhatsApp
←→
🖥️
Your Computer
Bridge (Docker)
←→
🤖
ClawCreek
Your AI Agent

A small program on your computer bridges WhatsApp to your Agent. Your messages stay private.

Setup Steps

1

Install Docker

Docker is a free app that runs the WhatsApp bridge. Think of it as an app installer.

🍎 Download for Mac🪟 Download for Windows

Install it like any normal app. After installing, open Docker Desktop and wait until the icon turns green (means it's running).

Note: Windows users: Docker may ask you to enable WSL 2. Follow the prompts — it's a one-time setup.
2

Get Your Docker Command

Go to your Agent's Brain panel on ClawCreek:

  1. Find the Channels section
  2. Click the Connect button next to WhatsApp
  3. A command appears — it's automatically copied to your clipboard
Tip: If you already connected before, click the ? button on the WhatsApp row to see the command again.
3

Open Terminal / PowerShell

🍎 Mac

Press Cmd + Space, type Terminal, press Enter

🪟 Windows

Press Win key, type PowerShell, press Enter

4

Paste and Run the Command

In the terminal window, paste the command:

  • Mac: Cmd + V then Enter
  • Windows: Ctrl + V then Enter

Wait about 30 seconds. You'll see a QR code appear in the terminal:

▄▄▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄▄▄▄
█ ▄▄▄ █ █▀█▀█ █ ▄▄▄ █
█ █ █ █ ▄▀▄▀ █ █ █ █
█▄▄▄▄▄█ ▄▀▄▀▄ █▄▄▄▄▄█
← QR code appears here
5

Scan the QR Code

On your phone:

  1. Open WhatsApp
  2. Go to Settings → Linked Devices
  3. Tap Link a Device
  4. Point your camera at the QR code in the terminal

After scanning, you should see:

✅ WhatsApp connected: YourName
6

Done!

Press Ctrl + C to stop watching logs. The bridge keeps running in the background.

Test it: Send yourself a WhatsApp message. Your Agent should reply!

By default, only you (the owner) can chat with your Agent via WhatsApp. To allow others, use the whitelist in Brain panel (👥 button).

👥 Managing Who Can Chat

By default, only you can chat with your Agent via WhatsApp.

To allow other people:

  1. Go to Brain panel → Channels → WhatsApp
  2. Click the 👥 button
  3. Enter their phone number and name, click + Add
Tip: When your Agent sends a message to someone via WhatsApp, their number is automatically added to the whitelist.

Common Questions

🔌 Docker command not found?

Docker Desktop is not installed or not running. Download from docker.com and make sure to open Docker Desktop before running commands.

📷 QR code doesn't appear?

Wait 30 seconds. If nothing shows, run docker logs clawcreek-whatsapp to see what happened.

🤖 Agent doesn't reply?

Make sure "✅ WhatsApp connected" appeared in terminal. If you're not the owner, your number must be in the whitelist (Brain panel → 👥).

😴 WhatsApp disconnects when computer sleeps?

The bridge needs your computer running. After waking up:

docker start clawcreek-whatsapp
🔄 Need to scan QR again?

Run these commands, then run your original Docker command again:

docker stop clawcreek-whatsapp docker rm clawcreek-whatsapp docker volume rm whatsapp-auth
🗑️ How to completely uninstall?
docker stop clawcreek-whatsapp docker rm clawcreek-whatsapp docker volume rm whatsapp-auth

Then uninstall Docker Desktop if you don't need it anymore.

💡 Why can't WhatsApp work like Telegram?

Telegram has an open bot API — anyone can create a bot for free. WhatsApp doesn't offer this. The bridge approach lets you use your own personal WhatsApp number, with your messages staying on your device.

📋 Daily commands cheat sheet

Start: docker start clawcreek-whatsapp

Stop: docker stop clawcreek-whatsapp

Check status: docker logs clawcreek-whatsapp --tail 5

Restart: docker restart clawcreek-whatsapp

← Back to Docs