What is the Kapso OpenClaw plugin?

The Kapso OpenClaw plugin adds WhatsApp as an OpenClaw channel through Kapso. The package is @kapso/openclaw-whatsapp.

What does the OpenClaw WhatsApp setup require?

It requires OpenClaw >= 2026.5.27, a Kapso API key, a Kapso-connected sender number, a public HTTPS gateway URL, and a webhook secret.

Does OpenClaw need a phone-number scoped webhook?

Yes. The OpenClaw integration should use a phone-number scoped Kapso WhatsApp webhook for whatsapp.message.received, not a project webhook.

Connect OpenClaw agents to WhatsApp

Use the Kapso OpenClaw plugin when an OpenClaw agent needs to send and receive WhatsApp messages through Kapso.

Start building Read OpenClaw docs

Add WhatsApp as an OpenClaw channel

The Kapso OpenClaw plugin installs the WhatsApp channel pieces and uses Kapso for sender numbers, messages, webhooks, and diagnostics.

Install from ClawHub

Install the Kapso OpenClaw plugin from ClawHub and enable the kapso-whatsapp channel in OpenClaw config.

Send and receive WhatsApp

Route OpenClaw messages through a Kapso-connected WhatsApp sender number.

Register the webhook

Create a phone-number scoped Kapso webhook that posts inbound WhatsApp messages to the OpenClaw gateway.

Control inbound access

Use allowlists and dmSecurity modes such as allowlist, open, or disabled.

Use the bundled CLI

Run openclaw kapso-whatsapp cli login and status without installing a separate Kapso CLI package.

Run diagnostics

Use setup output, doctor commands, channel status, and logs to verify the channel.

Install the OpenClaw plugin

OpenClaw resolves the plugin from ClawHub and installs runtime dependencies, including @kapso/whatsapp-cloud-api and @kapso/cli.

OpenClaw install

openclaw plugins install clawhub:@kapso/openclaw-whatsapp
openclaw config set 'plugins.allow' '["codex","kapso-whatsapp"]' --strict-json
openclaw config set 'channels["kapso-whatsapp"].enabled' true --strict-json

Requires OpenClaw >= 2026.5.27.

Requires a Kapso API key and a Kapso-connected WhatsApp sender number.

Requires a public HTTPS gateway URL that Kapso Cloud can reach.

Use a phone-number scoped Kapso webhook for whatsapp.message.received.

Keep the gateway explicit

OpenClaw needs a reachable gateway and a precise sender configuration before it can receive real WhatsApp traffic.

Public HTTPS

Kapso Cloud must reach the OpenClaw webhook over the public internet. Private local URLs are not enough.

Webhook secret

Use the same webhook secret in Kapso and OpenClaw so inbound deliveries can be verified.

Media caveats

Media reaches the model when Kapso includes a downloadable media URL; voice notes need a transcription provider.

Give OpenClaw an official WhatsApp channel

Connect a Kapso number, register the phone-number webhook, and let OpenClaw agents send and receive WhatsApp through official infrastructure.

Start free Read OpenClaw docs