whatsapp — piclaw-addons

Open Settings → Add-Ons and pick whatsapp

Source: addons/whatsapp

WhatsApp channel add-on for Piclaw. The package declares Baileys and qrcode-terminal as runtime dependencies and keeps its channel contracts, logging and storage-path handling inside the package.

Requires Piclaw >=2.0.0.

Configuration

Use Settings → WhatsApp to store the phone number and enable the channel through the direct add-on config API, then reload Piclaw. Environment overrides are also supported:

Env var	Description
`PICLAW_WHATSAPP_PHONE`	Phone number to connect (with country code)
`PICLAW_WHATSAPP_ENABLED`	Set to `1` to enable the channel

How it works

On session_start, lazy-loads the Baileys client and connects to WhatsApp Web
Registers a channel detector for WhatsApp JIDs (@s.whatsapp.net, @g.us) via registerChannelDetector
Inbound messages are posted to the agent via __piclawRuntimeInterop.postMessage
On session_shutdown, disconnects cleanly

Files

index.ts — Addon entry point: env gate, channel detector, lifecycle hooks
whatsapp.ts — Baileys WhatsApp client (connection, messaging, presence)
whatsapp-presence.ts — Typing indicator helpers
channel-types.ts — Package-local inbound message contracts
logger.ts — Package-local lifecycle logging