add-whatsapp

Installs and authenticates a native Baileys WhatsApp channel adapter for NanoClaw agents.

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-whatsapp-rosedwayane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-whatsapp
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-whatsapp
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-whatsapp-rosedwayane

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 its trunk, so connecting an agent to WhatsApp requires manually copying adapter code, registering setup steps, installing pinned dependencies, and completing linked-device authentication. This Skill automates that entire installation and pairing workflow. ## Core Features & Use Cases - Adapter Installation: Copies the native Baileys-based WhatsApp adapter, registration tests, and setup steps from the channels branch, then wires self-registration into the channel barrel. - Flexible Authentication: Supports QR code in browser (via a local HTTP server rendering rotating QR PNGs), QR code in terminal, or phone-number pairing codes, with headless-environment detection. - Validation & Troubleshooting: Runs build and registration tests to verify installation, and provides recovery steps for expired QRs, failed pairing codes, session corruption, and conflict disconnections. - Use Case: You want your NanoClaw agent to send and receive WhatsApp messages. Run this Skill to install the adapter, scan a QR code from your phone's Linked Devices screen, and wire the channel to an agent group. ## Quick Start Ask the assistant to add the WhatsApp channel to NanoClaw and authenticate it with a QR code in the browser.

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 the channel barrel and STEPS map, installs pinned dependencies, and validates with a build plus registration test.

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

WhatsApp uses linked-device authentication with no API key. Scan a rotating QR code shown in a browser page or terminal, or enter a numeric pairing code on your phone under Settings > Linked Devices > Link a Device.

Does WhatsApp authentication work on a headless server?

Yes. On headless Linux without a display server, the skill offers pairing-code authentication or terminal-rendered QR codes instead of the browser-based QR flow, which requires macOS or desktop Linux.

Why is my WhatsApp pairing code not working?

Pairing codes expire in about 60 seconds and must use digits only with no plus prefix. WhatsApp occasionally rejects valid codes server-side; if it fails repeatedly, delete store/auth and switch to QR-browser authentication, which has a higher success rate.

What are the limitations of the WhatsApp Baileys adapter?

The adapter cannot edit or delete messages due to WhatsApp linked-device limitations. It supports markdown formatting, file attachments, reactions, typing indicators, and approval questions, but has no thread support.