add-whatsapp-cloud

Installs and configures a WhatsApp Business Cloud API channel adapter for NanoClaw.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-whatsapp-cloud-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-whatsapp-cloud
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-whatsapp-cloud
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-whatsapp-cloud-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @chat-adapter/whatsapp.

What problem does it solve? NanoClaw does not ship messaging channels in its trunk, so connecting WhatsApp requires manually copying the adapter, registering it, installing the package, and wiring Meta credentials. This Skill walks through that entire setup with idempotent, re-runnable steps. ## Core Features & Use Cases - Adapter Installation: Copies the WhatsApp Cloud adapter and its registration test from the channels branch, appends the self-registration import, and installs the pinned @chat-adapter/whatsapp package. - Build Validation: Runs the build and a registration integration test to confirm the channel is registered and the dependency resolves. - Credential Setup: Guides creation of a Meta Business app, system user access token, webhook configuration, and environment variable sync to the container. - Use Case: A NanoClaw operator wants the bot to answer direct WhatsApp messages; this Skill installs the channel, configures Meta credentials, and hands off to /manage-channels to bind it to an agent group. ## Quick Start Ask the assistant to add the WhatsApp Cloud API channel to NanoClaw and configure it with your Meta Business credentials.

Frequently Asked Questions about add-whatsapp-cloud

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a WhatsApp channel to NanoClaw?

Run this Skill to copy the whatsapp-cloud adapter from the channels branch, append the self-registration import to src/channels/index.ts, install @chat-adapter/whatsapp, then build and run the registration test. Finally configure Meta credentials in .env and sync them to the container.

What credentials does WhatsApp Business Cloud API require?

You need a system user access token with whatsapp_business_messaging permission, the Phone Number ID from WhatsApp API Setup, the App Secret from Settings, and a verify token you choose. These go into WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_APP_SECRET, and WHATSAPP_VERIFY_TOKEN in .env.

Does WhatsApp Cloud API support group chats?

No, the WhatsApp Cloud API supports 1:1 conversations only, with each conversation tied to a phone number. It does not support threads or group chats, so each contact messages the bot in a separate direct conversation.

How do I verify the WhatsApp channel registration worked?

Run pnpm run build and pnpm exec vitest run src/channels/whatsapp-cloud-registration.test.ts. The test imports the channel barrel and asserts the registry contains whatsapp-cloud, failing if the import line is missing or the package is not installed.

How do I remove the WhatsApp Cloud channel from NanoClaw?

Follow REMOVE.md: delete the self-registration import from src/channels/index.ts, remove the adapter and test files, delete the four WHATSAPP_* variables from .env, uninstall @chat-adapter/whatsapp, then rebuild and restart the service.