OpenClaw WhatsApp Relay

Open-source component (message channel integration) O OpenClaw Core

Basic Information

  • Company/Brand: OpenClaw / OpenClaw Foundation
  • Country/Region: Global
  • Official Website: https://docs.openclaw.ai/channels/whatsapp
  • Type: Open-source component (message channel integration)
  • Founded: November 2025 (The original prototype of OpenClaw was WhatsApp Relay)

Product Description

The OpenClaw WhatsApp Relay is one of the core message channel integrations of OpenClaw and the origin of the entire project. OpenClaw initially emerged as a "WhatsApp Relay" prototype—connecting AI agents running on users' desktops to the WhatsApp messaging app. The WhatsApp integration is the earliest and most mature channel implemented by OpenClaw.

Technically, the WhatsApp channel is based on the Baileys protocol, an open-source implementation of the WhatsApp Web protocol. Users do not need the WhatsApp Business API; they can simply connect by scanning a QR code with their phone. The setup process is extremely simple: run the openclaw channels login command, scan the QR code using WhatsApp's "Linked Devices" feature, enable the WhatsApp channel configuration, and start the gateway. The entire process typically takes less than a minute.

In terms of security, users can control who can interact with the AI assistant through the dmPolicy configuration, which supports three modes: allowlist, pairing, and open. OpenClaw recommends running the WhatsApp channel with a separate number whenever possible, but it also supports personal number configurations. Multiple platforms (DataCamp, MarkTechPost, LumaDock, Hostinger, etc.) provide detailed tutorials on WhatsApp integration.

Core Features/Characteristics

  • Based on the Baileys protocol (open-source implementation of WhatsApp Web)
  • Connect by scanning a QR code, no Business API required
  • Setup completed in less than a minute
  • Three access control modes (allowlist/pairing/open)
  • Supports personal and separate numbers
  • Supports messaging, images, files, and other multimedia
  • Full integration with OpenClaw agents
  • Automatic reconnection and message queuing

Business Model

Completely open-source and free. No WhatsApp Business API fees required.

Target Users

  • WhatsApp users (over 2 billion users globally)
  • Users who want to interact with AI assistants via their phones anytime
  • Ordinary users who do not want to install additional apps
  • Mobile-first user base

Competitive Advantages

  • Zero cost (no Business API required)
  • Minimal setup (just scan a QR code)
  • Leverages the world's largest messaging platform
  • End-to-end encrypted communication
  • Users do not need to change their existing habits

Market Performance

The WhatsApp integration is OpenClaw's most popular and widely recognized feature, serving as a core selling point that attracts a large number of non-technical users. Platforms like DataCamp, MarkTechPost, Hostinger, and LumaDock have published dedicated tutorials on WhatsApp integration.

Relationship with the OpenClaw Ecosystem

The WhatsApp Relay is the "origin feature" of the OpenClaw project, as the entire project was initially built around WhatsApp integration. It is the most mature and widely used integration within OpenClaw's channel architecture and serves as the core entry point for OpenClaw's consumer-facing offerings.

Sources

External References

Learn more from these authoritative sources: