WhatsApp OpenAPI Skill for Openclaw

A specialized skill for operating the WhatsApp Business Platform Cloud API through a curated OpenAPI schema and bearer-token authentication.

jolestar
v1.0.0
Mar 17, 2026
0
790
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install whatsapp-openapi-skill

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-openapi-skill 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 OpenAPI Skill?

The WhatsApp OpenAPI Skill is a powerful integration designed to streamline interactions with the Meta WhatsApp Business Platform. By leveraging the uxc CLI and a curated OpenAPI schema, it provides a standardized way for AI agents and developers to manage business profiles, discover phone assets, and handle outbound messaging without manually constructing complex HTTP requests.

Built on the versioned Graph API v25.0, this Openclaw Skills contribution ensures stable, predictable performance for mission-critical communications. It acts as a lightweight wrapper that simplifies authentication and execution while maintaining strict guardrails for data integrity and user safety.

WhatsApp OpenAPI Skill Use Cases

  • Automated discovery of WhatsApp Business Account (WABA) phone numbers and metadata.
  • Programmatic updates to WhatsApp Business profiles, including description and contact details.
  • Scalable outbound messaging for alerts, notifications, and customer engagement.
  • Standardizing WhatsApp API interactions across different development environments using a shared OpenAPI schema.

How WhatsApp OpenAPI Skill Works

  1. The user installs the uxc tool and configures a Meta system-user or app access token as a bearer credential.
  2. A persistent CLI link is created using the curated WhatsApp OpenAPI schema URL.
  3. The skill performs asset discovery by querying WABA IDs to retrieve associated phone number metadata.
  4. Operation schemas are inspected to validate parameters for business profile updates or message payloads.
  5. Execution is handled via key/value pairs or positional JSON, routed through the versioned Facebook Graph API endpoint.

WhatsApp OpenAPI Skill Setup

# 1. Set your WhatsApp Cloud Access Token
uxc auth credential set whatsapp-cloud \
  --auth-type bearer \
  --secret-env WHATSAPP_CLOUD_ACCESS_TOKEN

# 2. Bind the credential to the versioned Graph API
uxc auth binding add \
  --id whatsapp-cloud \
  --host graph.facebook.com \
  --path-prefix /v25.0 \
  --scheme https \
  --credential whatsapp-cloud \
  --priority 100

# 3. Create the local CLI command using the Openclaw Skills schema
uxc link whatsapp-openapi-cli https://graph.facebook.com/v25.0 \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/whatsapp-openapi-skill/references/whatsapp-cloud.openapi.json

WhatsApp OpenAPI Skill Data Schema & Taxonomy

Field/Asset Description Data Type
waba_id WhatsApp Business Account Identifier String
phone_number_id Specific ID for the sender phone number String
messaging_product Platform identifier (default: "whatsapp") String
profile_data Business profile fields (about, address, etc.) JSON Object
message_envelope Standardized response containing ok, kind, and data JSON Object

WhatsApp OpenAPI Skill Advanced Features

  • Version-pinned execution against Graph API v25.0 to prevent breaking changes.
  • High-risk write protection requiring explicit confirmation for outbound message operations.
  • Partial update support for business profiles, allowing modification of specific fields without overwriting entire records.
  • Integration with existing uxc auth stacks for centralized credential management within Openclaw Skills environments.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*