← All articles

How to Disable or Remove a Channel Like Telegram or WhatsApp in OpenClaw

List the channels first, then decide whether you want a reversible disable or a full removal with token cleanup.

Channel cleanup becomes messy when you do not decide whether you are disabling or deleting. OpenClaw supports both, and they solve different problems.

Quick answer

Disable a channel when you want a quick stop. Remove a channel when you want to delete the connection details and stop the runtime from trying to use it again.

Command line steps

1. List the current channel state

Start by seeing what is actually configured.

openclaw channels list
openclaw channels status --probe

2. Disable the channel when you want a reversible pause

This keeps the config around but stops the runtime from starting that channel.

openclaw config set channels.telegram.enabled false
# or, for WhatsApp:
openclaw config set channels.whatsapp.enabled false

3. Remove the channel when you want a clean delete

Use the dedicated remove command for full cleanup.

openclaw channels remove --channel telegram --delete
# or:
openclaw channels remove --channel whatsapp --delete
openclaw gateway restart

What to check if it still fails

  • If the channel still appears active after removal, restart the gateway and check the probe again.
  • If you only needed to stop traffic temporarily, prefer disable over delete so you can roll back quickly.
  • If group replies are the real problem, debug policy and allowlists before you remove the whole channel.
FAQ

Frequently asked questions

What will I learn from How to Disable or Remove a Channel Like Telegram or WhatsApp in OpenClaw?

List the channels first, then decide whether you want a reversible disable or a full removal with token cleanup. The guidance is written for practical self-hosted OpenClaw environments, but commands and configuration can change between releases.

Should I back up OpenClaw before changing the configuration?

Yes. Back up the active configuration, credentials references, channel settings, and service definitions before repairs, upgrades, or model changes, then validate the gateway and important workflows after the change.

Can Milan help with OpenClaw setup or troubleshooting?

Yes. Milan provides OpenClaw setup, model and channel configuration, secure remote access, workflow automation, troubleshooting, and deployment support.

Need help with OpenClaw setup?

Turn the idea into a working system.