add-whatsapp

Installs and authenticates a native Baileys WhatsApp channel adapter with QR or pairing-code login.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @whiskeysockets/baileys, qrcode, @types/qrcode, pino, and includes scripts (resource) components.

What problem does it solve? NanoClaw does not ship messaging channels in trunk, so connecting WhatsApp requires manually copying the adapter, registering setup steps, installing pinned packages, and completing linked-device authentication. This Skill automates that entire installation and credential workflow, including safety checks for shared personal numbers. ## Core Features & Use Cases - Adapter installation: Copies the native Baileys adapter, registration tests, and setup steps from the channels branch, registers them in the STEPS map, and installs pinned dependencies (@whiskeysockets/baileys, qrcode, pino). - Flexible authentication: Supports QR code in browser (via a local HTTP server rendering rotating QR PNGs), QR in terminal, or phone-number pairing codes, with headless-environment detection. - Number safety and mode configuration: Enforces a dedicated-vs-shared number check with explicit risk warnings, writes ASSISTANT_HAS_OWN_NUMBER to .env, and audits legacy spam-era group wirings. - Use Case: An operator wants NanoClaw to answer WhatsApp messages on a dedicated number; the Skill installs the adapter, opens a browser QR for linking, sets the environment flag, and verifies registration with an integration test. ## Quick Start Ask the assistant to add the WhatsApp channel to NanoClaw and follow the prompts to choose your number type and authentication method.

Frequently Asked Questions about add-whatsapp

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

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

Run the add-whatsapp skill, which copies the Baileys adapter and setup steps from the channels branch, registers them in setup/index.ts, installs pinned packages, and builds the project. Authentication then completes via QR code or pairing code from your phone.

How do I authenticate WhatsApp with a QR code or pairing code?

For QR, run the wa-qr-browser.ts script to serve a rotating QR as a PNG in your browser, or run the whatsapp-auth setup step directly for terminal QR. For pairing codes, provide your phone number in digits-only format and enter the displayed code in WhatsApp's Linked Devices screen within about 60 seconds.

Can I use my personal WhatsApp number with a bot?

Yes, but the skill warns that linking a shared or personal number risks temporary suspension or permanent ban by WhatsApp. It requires explicit acknowledgement and sets ASSISTANT_HAS_OWN_NUMBER=false so the bot never claims messages addressed to you.

Does the WhatsApp adapter work in headless environments?

Yes. On headless Linux without a display server, the skill recommends pairing-code authentication or terminal QR instead of the browser method. The browser QR wrapper is intended for macOS and desktop Linux only.

Why is my WhatsApp bot not responding to messages?

Check that store/auth/creds.json exists, the log shows Connected to WhatsApp, the channel is wired to an agent group in the database, and the service is running. A conflict disconnection means two instances share the same credentials.

What are the limitations of the WhatsApp linked-device adapter?

The adapter cannot edit or delete messages, and WhatsApp has no modal support so credential requests fall back to text. It supports markdown formatting, attachments, reactions, typing indicators, and approval slash commands.