WhatsApp | SuprClaw

Two modes are supported: Native (recommended) and Bridge.

Native Mode (Recommended)

Native mode connects directly to WhatsApp using the WhatsApp Web protocol. No third-party bridge needed.

1. Build with native WhatsApp support

make build-whatsapp-native

Or download a *-whatsapp binary from the releases page.

2. Configure

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "use_native": true,
      "allow_from": []
    }
  }
}

3. Scan the QR code

On first run, a QR code will be displayed in the terminal. Scan it with WhatsApp:

WhatsApp → Settings → Linked Devices → Link a Device

The session is stored in <workspace>/whatsapp/ and persists across restarts.

Connect to an external WebSocket bridge:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "bridge_url": "ws://localhost:3001"
    }
  }
}

Field	Type	Description
`enabled`	bool	Enable/disable WhatsApp
`use_native`	bool	Use native WhatsApp Web protocol
`bridge_url`	string	WebSocket bridge URL (bridge mode)
`allow_from`	[]string	Whitelist of phone numbers (empty = all)