Home

Switch language

Start Install GuideQuick StartDocs Overview
Docs ChannelsModels & APIGateway OpsTools & Skills
More ArticlesResourcesHelp Center
Get Started
Documentation navigation Channels
Channels 2 sections

Channel Troubleshooting

Channel Troubleshooting

When the Gateway itself is up but messages are not flowing, the bot is silent or QR login succeeded but no send or receive works, the problem is usually in channel-specific config, permissions, intents or network details.

Run These First

Generic audit

openclaw doctor
openclaw channels status --probe
The second command adds lightweight live checks and warnings for known channel failures.

Frequent Channel Problems

Telegram sendMessage / setMyCommands fails

Check DNS, IPv6 and outbound HTTPS connectivity to api.telegram.org first. Many VPS failures are network problems, not bad tokens.

The Discord bot is online but does not reply in channels

Verify Message Content Intent first, then inspect guild or channel allowlists and whether requireMention is blocking the message.

WhatsApp scanned successfully but still does not work

Check whether the session is still online, whether credentials are updating and whether logs show loggedOut or status codes in the 409-515 range. Logout plus login is often the fastest fix.