add-whatsapp

The add-whatsapp skill enables seamless WhatsApp integration for NanoClaw agents by deploying the official Baileys adapter directly into your workspace. Unlike solutions that rely on third-party Chat SDK bridges, this implementation connects directly to WhatsApp Web services. This approach ensures greater control over your messaging stack and reduces dependency bloat. The skill is designed for users who require a private, isolated AI assistant reachable via their preferred messaging app. It is ideal for personal automation, task management, and assistant interaction where you want to keep your communication logic within your own agent infrastructure. By copying the adapter from the project's channels branch into your local repository, you maintain full visibility and editability of the underlying messaging code.

• Native Baileys adapter implementation for direct API connectivity.

• Secure authentication via QR code or numeric pairing code for linked-device setups.

• Support for both shared personal accounts and dedicated assistant phone numbers.

• Headless-friendly setup with options for browser-based, terminal-based, or pairing-code authentication.

• Idempotent installation steps that safely integrate with existing NanoClaw file structures.

• The skill requires pnpm to manage pinned dependencies like @whiskeysockets/baileys, qrcode, and pino.

• You must have access to your primary device to link the assistant account via WhatsApp's 'Linked Devices' feature.

• The setup process includes a built-in poll mechanism to capture pairing codes in terminal environments.

• Authentication state is persisted in your local store/auth directory, allowing for reconnection without re-pairing unless credentials expire.

• Use the dedicated flag in your .env file (ASSISTANT_HAS_OWN_NUMBER) to distinguish between personal and assistant identities.

• Recommended for users who prioritize privacy and self-hosting their agent integrations.