Integrate with WhatsApp
Connect your OpenClaw agent to WhatsApp to interact with it remotely.
Choose one of the following account setups to get started:
- Use a standalone account (Recommended): Purchase a separate SIM card and register a dedicated WhatsApp account for your bot.
- Use your personal account: If you only need the bot for personal use, you can link your own WhatsApp account and chat with the bot by sending messages to yourself.
Learning objectives
In this guide, you will learn how to:
- Link OpenClaw to WhatsApp using a standalone or personal account.
- Pair your personal WhatsApp number with a standalone bot account.
- Disconnect and fully remove the WhatsApp integration.
Configure WhatsApp channel
Choose your preferred configuration method.
Manual restart
After completing the configuration, OpenClaw automatically restarts the gateway. WhatsApp integration requires this restart to fully come online.
If you wait longer than 10 minutes and the bot is still not responding to your messages, try manually restarting the container:
- Open Control Hub from the Launchpad.
- Locate the
clawdbotdeployment, and then click Restart in the upper-right corner.
Disconnect WhatsApp
To fully disconnect WhatsApp from OpenClaw, you must remove the configuration from both the Control UI and the local system files.
Open the Control UI, and then select Agents from the left sidebar.
On the Channels tab, locate the WhatsApp configuration card, and then click Logout.
Open the OpenClaw CLI, and then run the following command:
bashopenclaw config --section channelsSelect Remove channel config, select WhatsApp, and then select Yes to delete the configuration.
Select Done to exit the wizard.
Open the Olares Files, and then go to Data > clawdbot > config > credentials.
Delete the
whatsappfolder, and delete any isolated WhatsApp credential files such aswhatsapp-pairing.jsonandwhatsapp-default-allowFrom.json.Restart the OpenClaw container in Control Hub to apply the changes.