Add WhatsApp Channel (NanoClaw)

Installs NanoClaw's native Baileys WhatsApp channel with a mandatory number-safety gate, QR/pairing-code linking, and explicit .env configuration.

AutomationAdvanced★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026

What it does

Copies the native WhatsApp (Baileys) adapter, its registration test, and the whatsapp-formatting container skill from the channels branch, then registers it in the channel barrel.
Installs pinned dependencies (Baileys, qrcode, pino), builds, and runs the registration test to prove the wiring.
Forces a "dedicated vs shared number" safety check first, with an explicit ban-risk warning and acknowledgement before any shared/personal-number install proceeds.
Links the device via in-terminal QR or an 8-character pairing code, with a browser-QR helper fallback and headless detection.
Writes ASSISTANT_HAS_OWN_NUMBER and ASSISTANT_NAME to .env in both modes, restarts the service, and resolves your DM JID / owner handle.
Includes a migration audit for legacy respond-to-everything group wirings plus troubleshooting for expired codes, corrupted sessions, and "conflict" disconnects.

Who it's for

Self-hosters running NanoClaw who want to talk to their agent on WhatsApp.
Operators with a spare SIM/eSIM who want a dedicated bot number.
Users who only want the agent in their personal "You" self-chat inbox.

Examples

Pick dedicated, scan the terminal QR, supply your own personal number → a normal two-way chat with the agent's contact.
On a headless VPS with no display: use pairing-code; if WhatsApp rejects it twice, fall back to wa-qr-browser.ts --clean.
An older install missing ASSISTANT_HAS_OWN_NUMBER where the bot replies to every message in a family group → run the migration audit to flip wirings to name-based engagement or delete them.

· · · 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/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.

↓ Download 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 folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-whatsapp/.
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 && cd nanoclaw && ls .claude/skills/add-whatsapp

⚠ This is a third-party skill. Check the source repository before installing.

Clone the project: git clone https://github.com/nanocoai/nanoclaw.git then cd nanoclaw.
Run pnpm install and complete NanoClaw's base /setup first — this skill assumes a working install.
The skill already lives at .claude/skills/add-whatsapp/. To keep it globally available run cp -r .claude/skills/add-whatsapp ~/.claude/skills/, but note it only works from a NanoClaw project root.
Open Claude Code in the project root.
Type /add-whatsapp.
Answer the number-type question — choose dedicated (spare SIM/eSIM) when possible. Choosing shared (your personal number) requires acknowledging the account-ban risk.
Choose qr (scan with your phone camera) or pairing-code (digits only, country code first), then link via WhatsApp → Settings → Linked Devices → Link a Device.
Provide the assistant name and, for a dedicated number, your own personal number; the skill writes .env, restarts the service, and a welcome message arrives in WhatsApp.

View source on GitHub ↗License: MIT