Files

gavrielc 9486d56b01 v2: make v2 the main entry point, move v1 to src/v1/

- Move all v1 files (index, router, container-runner, db, ipc, types,
  logger, channels/registry, and all utilities) to src/v1/ as a
  fully self-contained archive with no shared dependencies
- Rename v2 files to remove -v2 suffix (index-v2.ts → index.ts, etc.)
- Update all imports across v2 source, tests, and setup files
- Migrate shared utilities (config, env, container-runtime, mount-security,
  timezone, group-folder) from pino logger to v2 log module
- Migrate setup/ files from logger to log with argument order swap
- Container agent-runner: move v1 entry to v1/, rename v2 to index.ts
- Update setup skill to offer all 13 v2 channels
- Install all Chat SDK adapter packages
- dist/index.js now runs v2; dist/v1/index.js runs v1

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-09 11:40:36 +03:00

2.4 KiB

Raw Blame History

name, description

name	description
add-whatsapp-cloud-v2	Add WhatsApp Business Cloud API channel to NanoClaw v2 via Chat SDK. Official Meta API (not Baileys).

Add WhatsApp Cloud API Channel (v2)

This skill adds WhatsApp support via the official Meta WhatsApp Business Cloud API. This is different from the Baileys-based WhatsApp adapter (which uses WhatsApp Web protocol).

Phase 1: Pre-flight

Check if src/channels/whatsapp-cloud.ts exists and the import is uncommented in src/channels/index.ts. If both are in place, skip to Phase 3.

Phase 2: Apply Code Changes

Install the adapter package

npm install @chat-adapter/whatsapp

Enable the channel

Uncomment the WhatsApp Cloud API import in src/channels/index.ts:

import './whatsapp-cloud.js';

Build

npm run build

Phase 3: Setup

Create WhatsApp Business App

Go to Meta for Developers and create an app (type: Business)

Add the WhatsApp product

Go to WhatsApp > API Setup:

Note the Phone Number ID (not the phone number itself)

Generate a permanent System User access token with whatsapp_business_messaging permission

Go to WhatsApp > Configuration:

Set webhook URL: https://your-domain/webhook/whatsapp

Set a Verify Token (any random string you choose)

Subscribe to webhook fields: messages

Copy the App Secret from Settings > Basic

Configure environment

Add to .env:

WHATSAPP_ACCESS_TOKEN=your-system-user-access-token
WHATSAPP_PHONE_NUMBER_ID=your-phone-number-id
WHATSAPP_APP_SECRET=your-app-secret
WHATSAPP_VERIFY_TOKEN=your-verify-token

Sync to container: mkdir -p data/env && cp .env data/env/env

Build and restart

npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw  # macOS
# systemctl --user restart nanoclaw  # Linux

Phase 4: Verify

Send a message to your WhatsApp Business number. The bot should respond within a few seconds. Note: WhatsApp Cloud API only supports 1:1 DMs, not group chats.

Removal

Comment out import './whatsapp-cloud.js' in src/channels/index.ts
Remove WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_APP_SECRET, WHATSAPP_VERIFY_TOKEN from .env
npm uninstall @chat-adapter/whatsapp
Rebuild and restart

2.4 KiB Raw Blame History