Files

gavrielc 57a6491c7e v2: channel isolation model, manage-channels skill, refactored channel skills

- Add three-level isolation model (shared session, same agent, separate agent)
  with agent-shared session mode for cross-channel shared sessions
- Create /manage-channels skill for wiring channels to agent groups
- Refactor all 12 v2 channel skills: lean SKILL.md + VERIFY.md + REMOVE.md
  with structured Channel Info section for platform-specific metadata
- Create /add-discord-v2 skill (was missing)
- Add step 5a to setup SKILL.md invoking /manage-channels after channel install
- Update setup/verify.ts to check all 12 channel token types
- Add docs/v2-isolation-model.md explaining the isolation model
- Update v2-checklist.md and v2-setup-wiring.md to reflect completed work

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

2026-04-09 13:19:19 +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.

Add WhatsApp Cloud API Channel

Connect NanoClaw to WhatsApp via the official Meta WhatsApp Business Cloud API.

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 Credentials.

Install

npm install @chat-adapter/whatsapp

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

import './whatsapp-cloud.js';

Build:

npm run build

Credentials

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

Next Steps

If you're in the middle of /setup, return to the setup flow now.

Otherwise, run /manage-channels to wire this channel to an agent group.

Channel Info

type: whatsapp-cloud
terminology: WhatsApp Cloud API supports 1:1 conversations only (no group chats). Each conversation is with a phone number.
how-to-find-id: The platform ID is the Phone Number ID from the Meta Business dashboard (not the phone number itself). Find it under WhatsApp > API Setup.
supports-threads: no
typical-use: Interactive 1:1 chat -- direct messages only
default-isolation: Same agent group if you're the only person messaging the bot. Each additional person who messages gets their own conversation automatically, but they share the agent's workspace and memory -- use a separate agent group if you need information isolation between different contacts.

2.4 KiB Raw Blame History