add-whatsapp
This skill integrates WhatsApp as a messaging channel into ClaudeClaw, enabling you to route messages through WhatsApp alongside or instead of other channels. It handles authentication via QR code (browser or terminal) or pairing code, then guides you through registration, trigger configuration, and chat setup.
Add WhatsApp installs WhatsApp messaging support for ClaudeClaw with QR code or pairing code authentication.
AI-generated summary based on this skill's SKILL.md
Install
sbusso/claudeclaw/add-whatsapp · repository language: TypeScript
git clone https://github.com/sbusso/claudeclaw
cp -r claudeclaw/skills/add-whatsapp ~/.claude/skills/add-whatsappFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I add WhatsApp to ClaudeClaw?
add-whatsapp integrates WhatsApp as a messaging channel into ClaudeClaw. Start by installing the WhatsApp channel dependencies, then authenticate using either a QR code (displayed in your browser or terminal) or a pairing code for headless setups. Once authenticated, register your chats and groups, configure trigger words, and set your bot's name. WhatsApp will then route messages through ClaudeClaw alongside or instead of other communication channels.
What authentication methods does add-whatsapp support?
add-whatsapp supports two authentication approaches: QR code pairing (viewable in a browser or terminal) and pairing code method for headless environments. Both link your WhatsApp account as a connected device. Choose QR code for interactive setups or pairing code when you cannot display a visual QR code. Either method establishes the secure connection needed before you can register chats and configure triggers.
How do I set up WhatsApp linked device setup with add-whatsapp?
add-whatsapp configures WhatsApp as a linked device within ClaudeClaw. After installing dependencies and choosing your authentication method (QR or pairing code), the skill guides you through registering specific chats and groups. You'll set trigger words that activate your bot and assign a display name. This setup allows WhatsApp to function as a dedicated communication channel for your ClaudeClaw instance.
How do I troubleshoot WhatsApp connection issues in add-whatsapp?
add-whatsapp addresses common authentication and connection failures. If your QR code expires, regenerate it immediately. Verify that your WhatsApp account is active and not already linked elsewhere. Check that all dependencies installed correctly and your network connection is stable. If pairing code setup fails, ensure you're entering the code before it expires. Review ClaudeClaw logs for specific error messages that indicate whether the issue is authentication, registration, or trigger configuration.
Can I run add-whatsapp alongside other communication channels?
Yes, add-whatsapp supports running WhatsApp alongside other ClaudeClaw channels. You can configure multiple messaging channels simultaneously, allowing messages to route through WhatsApp, email, SMS, or other integrated services. Alternatively, you can replace existing channels entirely by disabling them and using only the WhatsApp channel. This flexibility lets you choose whether WhatsApp is your primary or supplementary communication method.
What do I configure after WhatsApp authentication in add-whatsapp?
After add-whatsapp authenticates your WhatsApp account, register the specific chats and groups where your bot will operate. Set trigger words that activate bot responses—for example, a keyword that prompts the bot to engage. Assign your bot a display name so users recognize it in conversations. These settings determine which messages ClaudeClaw processes and how your bot appears in WhatsApp, completing the channel setup.
SKILL.md
rendered from the published skill — quoted content, verbatim
Add WhatsApp Channel
This skill adds WhatsApp support to ClaudeClaw. It installs the WhatsApp channel code, dependencies, and guides through authentication, registration, and configuration.
Phase 1: Pre-flight
Check current state
Check if WhatsApp is already configured. If store/auth/ exists with credential files, skip to Phase 4 (Registration) or Phase 5 (Verify).
ls store/auth/creds.json 2>/dev/null && echo "WhatsApp auth exists" || echo "No WhatsApp auth"
Detect environment
Check whether the environment is headless (no display server):
[[ -z "$DISPLAY" && -z "$WAYLAND_DISPLAY" && "$OSTYPE" != darwin* ]] && echo "IS_HEADLESS=true" || echo "IS_HEADLESS=false"
Ask the user
Use AskUserQuestion to collect configuration. Adapt auth options based on environment:
If IS_HEADLESS=true AND not WSL → AskUserQuestion: How do you want to authenticate WhatsApp? - Pairing code (Recommended) - Enter a numeric code on your phone (no camera needed, requires
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/add-whatsapp/SKILL.md