Add WhatsApp Cloud Channel
Wires the official Meta WhatsApp Business Cloud API into NanoClaw — adapter copy, registration, pinned dependency, credentials and webhook setup.
Web & APIIntermediate★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026
What it does
- Pulls the WhatsApp Cloud adapter from the
channelsbranch intosrc/channels/. - Appends the self-registration import to
src/channels/index.tsand installs@chat-adapter/whatsappat an exact pinned version. - Runs
pnpm run buildplus a vitest registration test that fails if the barrel import or dependency drifts. - Prompts for the four Meta values (access token, Phone Number ID, app secret, verify token) and writes them to
.envwithout overwriting existing values. - Explains the shared webhook server (
/webhook/whatsapp-cloud, port 3000), tunnel options, and an upgrade path for olderwhatsapp-keyed installs.
Who it's for
- NanoClaw operators who want 1:1 WhatsApp conversations with their agent.
- Teams that need Meta's official Cloud API rather than an unofficial bridge.
- Anyone who keeps getting stuck on webhook verification or expiring tokens.
Examples
- "Add the WhatsApp Cloud channel" → copy, register, install, build and test in order.
- Migrating an older install → move the callback URL to
/webhook/whatsapp-cloudand re-engage subscribed threads. - Calls start returning 401 after a day → swap the temporary token for a permanent System User token in
WHATSAPP_ACCESS_TOKEN.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-whatsapp-cloud/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/add-whatsapp-cloud folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-whatsapp-cloud/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal in your working directory.
- Clone the repo:
git clone https://github.com/nanocoai/nanoclaw.git - Copy the skill:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-whatsapp-cloud ~/.claude/skills/ - Start Claude Code from the root of your NanoClaw project (the skill assumes that repo layout and pnpm).
- Ask: "Add the WhatsApp Cloud channel" so the Apply steps run.
- In Meta for Developers create a Business app, add the WhatsApp product, and collect the Phone Number ID, a permanent System User token with
whatsapp_business_messaging, the App Secret and your Verify Token. - Expose port 3000 publicly (e.g.
ngrok http 3000), set the webhook tohttps://your-domain/webhook/whatsapp-cloudin the Meta dashboard, then restart the service and click Verify and save.
View source on GitHub ↗License: MIT