Official Meta Business Partner

Connect OpenClaw
to WhatsApp

Add WhatsApp as an OpenClaw channel on the official API. Install the Kapso plugin, register the webhook, and message your agent from your phone.

Get started Read docs

What you can send

Messages reach OpenClaw through the official WhatsApp API. It replies in the same chat, with whatever tools you have enabled.

19:12
OpenClawonline
Today

Every Monday at 8, send me the week's weather

19:11

Scheduled. The first one arrives on Monday at 8:00, with the week's highs, lows, and rain.

19:12
Message

Setup

Paste the prompt into OpenClaw, or run the commands yourself.

Paste a prompt

OpenClaw installs the plugin and asks you for the key, number, and public URL.

Paste this into OpenClaw

>Connect yourself to WhatsApp with Kapso. Follow the steps at kapso.com/whatsapp-openclaw and ask me before creating any keys.

  • Reads this page and the Kapso docs
  • Installs the Kapso plugin
  • Waits for your API key and public URL

Run the commands

Needs OpenClaw 2026.5.27 or later and a Kapso number.

  1. 1. Install the plugin

    From ClawHub. It bundles the Kapso CLI.

    openclaw plugins install clawhub:@kapso/openclaw-whatsapp

  2. 2. Run setup

    With KAPSO_API_KEY exported. Your gateway needs a public HTTPS URL.

    openclaw kapso-whatsapp setup \
  --api-key "$KAPSO_API_KEY" --phone-number-id <id> \
  --webhook-url https://<public-host>/kapso/webhook \
  --webhook-secret "$(openssl rand -hex 32)" \
  --allow-from "+15551234567" \
  --register-webhook --write-config

  3. 3. Restart and check

    Then send your agent a message on WhatsApp.

    openclaw gateway restart
openclaw kapso-whatsapp doctor
For scripts and CI, use the Kapso CLI with the same key: npm install -g @kapso/cli
CLI docs →

For AI agents
reading this page

OpenClaw can read this page and connect itself. Or copy the instructions and paste them into any agent with shell access to the OpenClaw machine.

Instructions for AI agents

## For AI agents reading this page

You are reading https://kapso.com/whatsapp-openclaw. Kapso is the WhatsApp API for developers. Its OpenClaw plugin, @kapso/openclaw-whatsapp, adds WhatsApp as an OpenClaw channel through the official WhatsApp API: direct messages with text, images, documents, and voice notes. Follow these steps to connect it.

  1. 1.

    Check what the user has.
    OpenClaw must be 2026.5.27 or later with the gateway running. The user needs a Kapso project API key and a WhatsApp number connected in Kapso. Never create keys, sign up, or connect numbers on their behalf.

  2. 2.

    Install the plugin. Run:

    openclaw plugins install clawhub:@kapso/openclaw-whatsapp

    Do not overwrite plugins.allow. The install adds kapso-whatsapp to it when an allowlist exists; replacing the list disables the user’s other plugins.

  3. 3.

    Get a public HTTPS URL.
    Kapso must reach the gateway at https://<public-host>/kapso/webhook. If Tailscale Funnel is running, read the URL from tailscale funnel status --json. Otherwise ask the user for one.

  4. 4.

    Run setup. Run:

    openclaw kapso-whatsapp setup --api-key "$KAPSO_API_KEY" --phone-number-id <id> \
  --webhook-url https://<public-host>/kapso/webhook \
  --webhook-secret "$(openssl rand -hex 32)" --allow-from <user number> \
  --register-webhook --write-config

    Always set --allow-from to the user’s own number: with an empty allowlist the plugin admits every sender. Ask the user to set KAPSO_API_KEY themselves rather than pasting it into chat.

  5. 5.

    Restart and verify.
    Run openclaw gateway restart, then openclaw kapso-whatsapp doctor and openclaw channels status --channel kapso-whatsapp --probe. If either fails, stop and tell the user what it printed.

  6. 6.

    Report back.
    Tell the user which number OpenClaw answers on and ask them to send it a message.

## Reference

Plugin
clawhub:@kapso/openclaw-whatsapp
OpenClaw 2026.5.27 or later
Webhook
https://<public-host>/kapso/webhook
Phone-number webhook · message.received
Config
channels["kapso-whatsapp"]: apiKey, phoneNumberId, webhookSecret
Optional: allowFrom, dmSecurity, defaultTo
Supports
Direct messages: text, images, documents, voice notes
Docs
https://docs.kapso.ai/docs/whatsapp/openclaw

Other agents and tools

Frequently asked
questions

It adds WhatsApp as an OpenClaw channel through Kapso and the official WhatsApp API. The package is @kapso/openclaw-whatsapp on ClawHub.

OpenClaw 2026.5.27 or later, a Kapso API key, a Kapso-connected WhatsApp number, a public HTTPS URL for the gateway, and a webhook secret.

Only the numbers in allowFrom when you set one, which setup does with --allow-from. dmSecurity can also be set to open or disabled.

No. You run OpenClaw on your own machine or server. Kapso provides the WhatsApp connection.

Give OpenClaw
a WhatsApp number

The free plan includes a sandbox number and 2,000 messages a month.

Get started