Channel troubleshooting

Scope

Use this page when a channel “looks connected” but messages don’t flow (permissions, pairing, privacy modes, networking).

Start with two checks

moltbot doctor
moltbot channels status --probe

channels status --probe surfaces common misconfigurations when it can (credentials, some permissions/membership, and small live checks).

Jump to channel-specific troubleshooting

• Discord: /en/docs/channels/discord/ (Troubleshooting section)
• Telegram: /en/docs/channels/telegram/ (Troubleshooting section)
• WhatsApp: /en/docs/channels/whatsapp/ (Troubleshooting section)

Telegram quick fixes

• If you see HttpError: Network request for 'sendMessage' failed / sendChatAction, check IPv6 DNS ordering: some hosts resolve api.telegram.org to IPv6 first but don’t have IPv6 egress. Force IPv4 or enable IPv6.
• If setMyCommands failed, validate outbound HTTPS and DNS reachability to api.telegram.org (common on locked-down VPS or misconfigured proxies).

Further reading

• Source path: channels/troubleshooting.md