Kapso WhatsApp for OpenClaw

Official OpenClaw channel plugin for sending and receiving WhatsApp messages through Kapso.

Install

npm install @kapso/openclaw-whatsapp
openclaw plugins add @kapso/openclaw-whatsapp

Configuration

Set the Kapso-first environment variables used by the plugin:

export KAPSO_API_KEY="kapso_..."
export KAPSO_PHONE_NUMBER_ID="1234567890"
export KAPSO_WEBHOOK_SECRET="shared webhook secret"

Optional:

export KAPSO_BASE_URL="https://api.kapso.ai/meta/whatsapp"
export KAPSO_WEBHOOK_PATH="/kapso/webhook"
export KAPSO_BOT_USERNAME="support"

Configure the Kapso webhook endpoint to the OpenClaw gateway route:

POST https://your-openclaw-host.example.com/kapso/webhook

Enable the whatsapp.message.received event and use the same secret as KAPSO_WEBHOOK_SECRET.

Channel Targets

The plugin accepts WhatsApp phone-number targets with these prefixes:

kapso:+15551234567
kapso-whatsapp:+15551234567
whatsapp:+15551234567
wa:+15551234567

Plain E.164 or digits-only numbers are also accepted.

Publishing

Before publishing to npm or ClawHub:

npm run build
npm test
npm run plugin:validate
clawhub package publish . --dry-run

ClawHub requires the package scope to match the selected owner.