openclaw/docs/channels/troubleshooting.md

summary, read_when, title

summary	read_when	title
Channel-specific troubleshooting shortcuts (Discord/Telegram/WhatsApp/iMessage)	A channel connects but messages don’t flow Investigating channel misconfiguration (intents, permissions, privacy mode)	Channel Troubleshooting

Channel troubleshooting

Start with:

openclaw doctor
openclaw channels status --probe

channels status --probe prints warnings when it can detect common channel misconfigurations, and includes small live checks (credentials, some permissions/membership).

Channels

• Discord: /channels/discord#troubleshooting
• Telegram: /channels/telegram#troubleshooting
• WhatsApp: /channels/whatsapp#troubleshooting-quick
• iMessage (legacy): /channels/imessage#troubleshooting-macos-privacy-and-security-tcc

Telegram quick fixes

• Logs show HttpError: Network request for 'sendMessage' failed or sendChatAction → check IPv6 DNS. If api.telegram.org resolves to IPv6 first and the host lacks IPv6 egress, force IPv4 or enable IPv6. See /channels/telegram#troubleshooting.
• Logs show setMyCommands failed → check outbound HTTPS and DNS reachability to api.telegram.org (common on locked-down VPS or proxies).