Skip to content

Managing Channels

Last updated: March 2026

Once you connect your first channel, you can add more, disconnect old ones, and monitor their status from the Agent Control Panel. This article covers the day-to-day management of your messaging channels.

View connected channels

Open your agent's Channels section to see every channel that is currently connected. Each channel displays its platform name (Telegram, WhatsApp, or Discord), the account or bot username, and a color-coded status indicator.

Agent Panel — Channels

Telegram Channel

@AcmeSupportBot — Status: Connected (green dot)

WhatsApp Channel

+30 210 1234567 — Status: Connected (green dot)

Discord Channel

OneClickClaw Agent — Status: Reconnecting (yellow dot)

Disconnect a channel

To disconnect a channel, open the Channels section, find the channel you want to remove, and click the Remove button. OneClickClaw disconnects the bot from that channel and updates the configuration on your server.

  • Conversation history: Removing a channel does not delete conversation history stored in OpenClaw's memory. If you reconnect the same channel later, the agent may still recall previous interactions.
  • Bot stays in the group: Removing a channel in OneClickClaw only disconnects the integration. 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 indicator so you can see at a glance whether it is working:

  • Green (Connected): The channel is active and your bot is responding to messages normally.
  • Yellow (Reconnecting): The connection was temporarily lost and OpenClaw is attempting to reconnect. This usually resolves within a few seconds.
  • Red (Error): The channel is not connected. 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 settings and re-enter your credentials if needed.

Tip

If a channel shows a red status, try removing it and adding it again with fresh credentials. This resolves most connection issues.

No channels connected

If no channels are connected to your agent, you see a red warning card on the Channels page. This card includes a "Connect a chat channel" button that takes you directly to the onboarding wizard, where you can set up your first channel step by step.

Agent Panel — Channels — No Channels

Warning Card

No channels connected. Your agent cannot receive messages until you connect at least one channel. [Connect a chat channel] 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 number 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 uses the same system prompt and personality across all channels.

Tip

You can connect Telegram, WhatsApp, and Discord simultaneously. Your agent handles all of them with the same system prompt.

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