Skip to content

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:

  1. Open Control Hub from the Launchpad.
  2. Locate the clawdbot deployment, 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.

  1. Open the Control UI, and then select Agents from the left sidebar.

  2. On the Channels tab, locate the WhatsApp configuration card, and then click Logout.

  3. Open the OpenClaw CLI, and then run the following command:

    bash
    openclaw config --section channels
  4. Select Remove channel config, select WhatsApp, and then select Yes to delete the configuration.

  5. Select Done to exit the wizard.

  6. Open the Olares Files, and then go to Data > clawdbot > config > credentials.

  7. Delete the whatsapp folder, and delete any isolated WhatsApp credential files such as whatsapp-pairing.json and whatsapp-default-allowFrom.json.

  8. Restart the OpenClaw container in Control Hub to apply the changes.

Next steps