# Add Whatsapp

Add WhatsApp channel via native Baileys adapter.

- Repository: https://github.com/nanocoai/nanoclaw (31069 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add nanocoai/nanoclaw --skill add-whatsapp -g -a claude-code -y`
Codex: `npx skills add nanocoai/nanoclaw --skill add-whatsapp -g -a codex -y`
Cursor: `npx skills add nanocoai/nanoclaw --skill add-whatsapp -g -a cursor -y`
Gemini CLI: `npx skills add nanocoai/nanoclaw --skill add-whatsapp -g -a gemini-cli -y`

## Description

Add WhatsApp channel via native Baileys adapter. Direct connection, no Chat SDK bridge. Uses QR code or pairing code for authentication.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Add WhatsApp Channel

Adds WhatsApp support via the native Baileys adapter, a direct WhatsApp Web
connection, no Chat SDK bridge. NanoClaw doesn't ship channels in trunk, this
skill copies the WhatsApp adapter in from the `channels` branch.

The mechanical steps under **Apply** carry `nc:` directive fences: an agent
reads the prose and applies them, and a parser can apply them deterministically
from the same document. Every directive is idempotent, so the whole skill is
safe to re-run; anything a parser can't apply falls back to the prose beside it.

## Number safety check (required)

Complete this check before running any install or authentication command. If
the user already said they want to use their **shared**, **personal**,
**main**, **existing**, or **everyday** WhatsApp number, treat it as a shared
number and show the warning immediately. Do not ask the number-type question
again.

Otherwise, ask which WhatsApp number NanoClaw will use:

```nc:prompt number_mode validate:^(dedicated|shared)$
Which WhatsApp number will NanoClaw use? `dedicated` (recommended), a separate number used only for NanoClaw (spare SIM, eSIM, or old phone). `shared`, your existing everyday / personal WhatsApp number.
```

If the answer is `shared`, show this warning, tell the user:

```nc:operator when:number_mode=shared
⚠️ Risk to your WhatsApp account

Connecting your shared or personal number could cause WhatsApp to temporarily suspend or permanently ban that number. You could lose access to the WhatsApp account, chats, and groups you rely on.

We strongly recommend using a separate, dedicated number for NanoClaw.

On your personal number, the agent lives only in your "You" / self-chat. Messages other people send you are ignored entirely, never read, never answered, never flagged for approval. Nobody else can talk to the agent.

The rest: https://github.com/nanocoai/nanoclaw/blob/HEAD/.claude/skills/add-whatsapp/SKILL.md