Channel Troubleshooting
Troubleshooting notes by channel (Discord/Telegram/WhatsApp)
Start here:
openclaw doctor openclaw channels status --probe
channels status --probe prints warnings when it can detect common configuration issues, and includes lightweight online checks (credentials, some permissions/membership).
Channel troubleshooting entry points
- Discord:/channels/discord#troubleshooting
- Telegram:/channels/telegram#troubleshooting
- WhatsApp:/channels/whatsapp#troubleshooting-quick
Telegram quick fixes
- If logs show HttpError: Network request for 'sendMessage' failed or sendChatAction: check IPv6 and DNS first. If api.telegram.org resolves to IPv6 but the host has no IPv6 egress, requests will fail. Force IPv4 or enable IPv6. See /channels/telegram#troubleshooting.
- If logs show setMyCommands failed: verify HTTPS and DNS egress to api.telegram.org (common on restricted VPS/proxy networks).