WhatsApp Business API for Openclaw

A comprehensive toolset for integrating Meta's WhatsApp Business Cloud API into AI workflows.

ivangdavila
v1.0.0
Feb 25, 2026
1
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install whatsapp-business-api

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install whatsapp-business-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is WhatsApp Business API?

The WhatsApp Business API skill is a specialized integration designed to bridge the gap between AI agents and Meta's communication infrastructure. By utilizing Openclaw Skills, developers gain a structured way to handle text messages, media uploads, and interactive elements. The skill manages the technical nuances of the Meta Cloud API, such as the 24-hour reply window and template approval processes, while keeping sensitive authentication tokens secure in your local environment.

WhatsApp Business API Use Cases

  • Sending automated order updates and notifications using approved templates.
  • Creating interactive customer support experiences with WhatsApp Flows.
  • Managing high-volume messaging campaigns with built-in rate limit awareness.
  • Implementing secure webhook listeners to process incoming customer inquiries in real-time.

How WhatsApp Business API Works

  1. Validates required environment variables including the Access Token and Phone Number ID.
  2. References local documentation in ~/whatsapp-business-api/ to determine message constraints and template availability.
  3. Prepares the API payload, ensuring international phone formats and correct messaging product headers.
  4. Communicates with the Meta Graph API v21.0 endpoints to execute messaging or profile operations.
  5. Logs session context to memory.md to maintain conversation continuity within the Openclaw Skills ecosystem.

WhatsApp Business API Setup

Define the required environment variables in your shell profile or .env file:

export WHATSAPP_ACCESS_TOKEN="your_permanent_token"
export WHATSAPP_PHONE_NUMBER_ID="your_phone_id"
export WHATSAPP_BUSINESS_ACCOUNT_ID="your_waba_id"
export WHATSAPP_APP_SECRET="your_app_secret"

Ensure the local directory structure exists for persistent storage:

mkdir -p ~/whatsapp-business-api/

WhatsApp Business API Data Schema & Taxonomy

The skill maintains a local directory at ~/whatsapp-business-api/ to store metadata and configuration:

File Purpose
memory.md Tracks phone numbers and account-specific context.
templates.md Maintains a list of Meta-approved templates for outgoing messages.
webhooks.md Stores webhook configurations and verification settings.
flows.md Defines interactive forms and logical user paths within WhatsApp.

WhatsApp Business API Advanced Features

  • Intelligent 24-hour window tracking to switch between free-form replies and template-based initiation.
  • Support for interactive components like buttons, list messages, and WhatsApp Flows.
  • Secure webhook signature verification using the app secret to protect against unauthorized events.
  • Built-in handling for media limits, automatically checking file sizes for images and documents before transmission.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*