DocsWhatsApp & Telegram Config

WhatsApp & Telegram Config

Configuring Chat Channels

By default, you interact with your agents via the web dashboard. However, you can deploy agents directly to external channels by navigating to Dashboard > Settings > Channels.

Telegram and Slack

For token-based bots (Telegram, Discord, Slack), simply paste your Bot API Token into the configuration panel. The dashboard sends a POST /api/openclaw/channels payload to the Gateway, which instantly binds the WebSocket connection to the provider's streaming API.

WhatsApp Linked Device

The WhatsApp integration uses a native linked-device approach (via Baileys) rather than the restrictive official Business API. When you select WhatsApp in the Channels dashboard:

  • The Gateway triggers the web.login.start RPC method.
  • A QR code is generated and displayed on your dashboard.
  • Open WhatsApp on your phone, go to 'Linked Devices', and scan the QR code.
  • The dashboard polls the web.login.wait endpoint until the pairing is confirmed.

Once linked, your agent will appear as your personal account (or a secondary dedicated number) and can autonomously respond to incoming messages based on your specific allowlist rules.