Skip to main content
Use a Channel to talk to a Cloud Agent from Telegram, Discord, or WhatsApp. First link a bot to the Agent, then pair the chat you want to use. Choose a Cloud Agent with Channels in its sidebar. For the shortest walkthrough, follow Connect a messaging Channel.

​
Current provider availability

The released dashboard supports Telegram and Discord bots and custom WhatsApp accounts. Use Library > Channels to see the providers and status currently shown for your account. Channels catalog with Clawdi Telegram, Telegram Topics, Discord, and WhatsApp Link Agent actions. Open Channels to discover Clawdi bots or manage custom connections. Choose Link Agent for the bot you want to use. View full-size image

​
Choose a Clawdi bot

Open Library > Channels and review Clawdi bots. Choose Link Agent on the bot you want, select your Cloud Agent, then continue to pairing. A Clawdi bot lets you start without creating your own bot.

​
Connect a bot

Open Library > Channels in the Clawdi dashboard, choose Add channel, and select a provider:
  • For Telegram, enter a name and the bot token obtained from BotFather.
  • For Discord, enter a name, bot token, application ID, and interactions public key from the Discord Developer Portal.
  • For WhatsApp, choose Connect your account and follow the linked-device setup. The dashboard adds the account under custom bots after the device connection completes.
Submit once and wait for the Channel to appear under Custom bots.
Bot tokens are secrets. Use the dashboard’s credential field. For CLI automation, pass the name of an environment variable with --provider-token-env; do not place the token itself in shell history.
Discord credentials are stored during setup but are not verified with Discord at creation time. Send a test message and check Channel activity and health before relying on it.
Use a dedicated WhatsApp number, not your primary personal number. Replies from an Agent linked to the account are sent from that WhatsApp account.
Open the Agent’s Channels, choose an available bot, and select Link. Check that the row now offers Pair and Unlink. A linked bot with zero paired chats is ready for the next step: authorizing your chosen chat.

​
Pair WhatsApp

Connecting a WhatsApp linked device does not link it to an Agent or pair a chat. Complete those separately:
  1. Open the custom WhatsApp Channel and use Link Agent for the intended Cloud Agent.
  2. From the linked Channel, choose Pair chat and follow the current QR, link, or pairing instructions.
  3. Send a harmless test message and confirm the paired chat and Channel health.
If the linked-device connection needs attention, open the WhatsApp Channel and use Repair. Finish the repair flow before changing Agent links or pairing another chat.

​
Pair Telegram

On the Agent’s connected Channel row, choose Pair. Use one of the paths shown:
  • Scan the QR code or open the generated Telegram link for a direct chat.
  • For a group, add the bot and send the exact pairing command displayed by the dashboard.
The pairing link and code expire. Generate a new one if the countdown ends before pairing completes. Sample Pair Telegram dialog with a nonfunctional demonstration QR code. Sample pairing screen. This QR code cannot pair a chat. Generate a fresh link in Clawdi. View full-size image

​
Pair Discord

On the Discord connection, choose Pair, then select Server or Direct message:
  • For a server, add the bot with the generated install link. You need the provider permission stated by the dashboard.
  • In the target server or direct message, run /clawdi_pair and provide the generated code in its required code option.
After pairing, the chat appears beneath the connected Channel on the Agent page. Check Activity and Health on the Channel page after a test message.

​
Unpair one chat

Use this when the bot and Agent should stay linked but one external chat should stop reaching it:
  • For Telegram, choose the unpair action beside the paired chat and confirm.
  • For Discord, run /clawdi_unpair inside the paired server or direct message.
Other paired chats and the Channel link remain active. On the Agent’s Channels section, choose the unlink action beside the bot and confirm. The Agent stops answering through that bot. The Channel remains available and can still be linked to other Agents.

​
Remove the Channel

Open the Channel detail page and choose Remove only when the bot connection itself should be retired.
Removing a Channel stops linked Agents from sending and receiving through it and cannot be undone. Unpair a chat or unlink one Agent when that narrower action is sufficient.
For CLI inspection and automation, start with:
Avoid copying a full option table into scripts; provider fields and pairing outputs can vary by CLI version and account availability.
Last modified on September 10, 2026