add-whatsapp

Install WhatsApp channel code and authentication flows into NanoClaw.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill add-whatsapp-theowenyoung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-whatsapp
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/add-whatsapp
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill add-whatsapp-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill integrates WhatsApp as a messaging channel into NanoClaw, removing the manual setup burden of installing channel code, managing dependencies, and performing interactive authentication so agents can communicate via WhatsApp securely in isolated containers.

Core Features & Use Cases

  • Flexible Authentication Flows: Supports QR in browser, terminal QR, and numeric pairing-code flows to accommodate headless servers, WSL, and desktop environments.
  • End-to-end Channel Installation: Applies channel files, installs required npm packages, verifies builds, and syncs environment and container state for production use.
  • Robust Runtime Behavior: Handles credential storage, reconnection, outgoing message queuing, group metadata sync, chat registration, and diagnostics to keep WhatsApp-connected agents resilient.
  • Use Case: Add a WhatsApp bot for personal self-chat or group integration, authenticate it using your preferred method, and register chats so Claude agents respond to trigger words or direct messages.

Quick Start

Run the NanoClaw setup step whatsapp-auth via the claude CLI to authenticate WhatsApp, then register the desired chat to enable the assistant.

Frequently Asked Questions about add-whatsapp

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

FAQPage Schema
How do I integrate WhatsApp messaging into a containerized agent?

Integrate WhatsApp messaging by installing channel code, dependencies, and interactive authentication flows into your agent environment. This setup provides credential storage, group metadata sync, and message queuing for secure containerized agents.

Can I authenticate WhatsApp on a headless server without a browser?

Yes, WhatsApp authentication supports headless servers and WSL environments using terminal QR codes or numeric pairing-code flows. This allows you to securely link multi-device WhatsApp setups without needing a graphical browser interface.

What's the best way to handle WhatsApp reconnection and message queuing for bots?

Handle WhatsApp reconnection and message queuing by applying runtime behavior that manages credential storage and outgoing message queues. This keeps WhatsApp-connected agents resilient during connection drops and automatically syncs chat registration.

Does this WhatsApp channel integration support group metadata sync?

Yes, the WhatsApp channel integration supports group metadata sync alongside chat registration and diagnostics. It verifies builds and syncs environment state to ensure agents can respond to trigger words in both direct messages and groups.

How to register WhatsApp chats so Claude agents respond to trigger words?

Register WhatsApp chats by running the setup authentication step via the CLI, then registering the desired chat. This enables the assistant to monitor messages and respond to trigger words or direct messages automatically.