Skip to content

Managing Channels

You add, change and remove channels inside your agent. Your OneClickClaw dashboard shows their status and lets you mute disconnect alerts. This article covers the day-to-day management of your messaging channels.

Note

Channels are connected inside your agent. On OpenClaw, open your agent and go to Settings > Channels, where each channel has a guided setup. On Hermes Agent, press Open my Hermes dashboard on your server page and connect your channels there. On OpenClaw servers, your OneClickClaw dashboard shows each channel's status.

View connected channels

On an OpenClaw server, your server page lists every channel your agent has, with its name and a status. Press Refresh channels to read the latest status. OpenClaw offers guided setups for WhatsApp, Telegram, Discord, Slack, Signal, iMessage and Google Chat. Hermes Agent lists its channels in your Hermes dashboard.

Server page - Channels

Telegram

Status: Connected

Discord

Status: Connected

WhatsApp

Status: Pairing Required

Disconnect a channel

To remove a channel, open your agent (on OpenClaw, Manage channels in OpenClaw on your server page, then Settings > Channels; on Hermes Agent, your Hermes dashboard) and remove or turn off the channel there. The OneClickClaw dashboard has no Remove button. Next to each channel it offers Mute disconnect alerts, which stops the emails we send when that channel drops, for example while you change it.

  • Conversation history: Removing a channel does not delete conversation history stored in your agent's memory. If you reconnect the same channel later, the agent may still recall previous interactions.
  • Bot stays in the group: Removing a channel only disconnects your agent. The bot user remains in the Telegram group or Discord server. To fully remove it, kick the bot from the group or server manually.

Note

Disconnecting a channel does not affect your other connected channels. Your agent continues responding on all remaining channels without interruption.

Channel status indicators

Each channel displays a status so you can see at a glance whether it is working:

  • Connected: The channel is active and your bot is responding to messages normally.
  • Degraded: The channel works with problems. Watch it, and check it inside your agent if it stays this way.
  • Pairing Required: WhatsApp shows this until you scan its QR code. Open your agent and finish the pairing step.
  • Disconnected: The channel lost its connection. If your notification settings allow it, we email you when a channel stops working.
  • Error: The channel is not working. This can happen if the bot token was revoked, the bot was removed from the group, or there is a configuration error. Check the channel inside your agent and enter fresh credentials if needed.
  • Not Configured: The channel has not been set up yet.

Tip

If a channel shows an error, open it inside your agent and enter fresh credentials (a new token, or a new QR scan for WhatsApp). This resolves most connection issues. See Channel Connection Issues.

No channels connected

If no channels are connected to your agent, you see a red warning card on the server page. Its "Add a channel in OpenClaw" button opens your agent, where Settings, then Channels, walks you through your first channel step by step.

Server page - No Channels

Warning Card

No channels connected. Connect WhatsApp, Telegram, Discord, Slack and more from Settings, then Channels, inside your agent. [Add a channel in OpenClaw] button

Multiple channels on one agent

Your agent can serve multiple channels at the same time. For example, you might connect a Telegram bot for your community, a WhatsApp account for customer support, and a Discord bot for your team. Each channel operates independently, so conversations in one channel do not affect the others. Your agent keeps the same personality across all channels.

Tip

You can connect Telegram, WhatsApp, Discord and the other channels your agent offers at the same time.

To add a new channel, see the setup guides for each platform: Telegram, WhatsApp, or Discord.