openclaw/docs/zh-CN/channels/troubleshooting.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
渠道已连接但消息无法流通 排查渠道配置错误（意图、权限、隐私模式）	渠道专属故障排除快捷指南（Discord/Telegram/WhatsApp）	渠道故障排除	generated_at model provider source_hash source_path workflow 2026-02-01T19:58:09Z claude-opus-4-5 pi 6542ee86b3e50929caeaab127642d135dfbc0d8a44876ec2df0fff15bf57cd63 channels/troubleshooting.md 14

渠道故障排除

首先运行：

openclaw doctor
openclaw channels status --probe

channels status --probe 会在检测到常见渠道配置错误时输出警告，并包含小型实时检查（凭据、部分权限/成员资格）。

渠道

• Discord：/channels/discord#troubleshooting
• Telegram：/channels/telegram#troubleshooting
• WhatsApp：/channels/whatsapp#troubleshooting-quick

Telegram 快速修复

• 日志显示 HttpError: Network request for 'sendMessage' failed 或 sendChatAction → 检查 IPv6 DNS。如果 api.telegram.org 优先解析为 IPv6 而主机缺少 IPv6 出站连接，请强制使用 IPv4 或启用 IPv6。参见 /channels/telegram#troubleshooting。
• 日志显示 setMyCommands failed → 检查到 api.telegram.org 的出站 HTTPS 和 DNS 可达性（常见于限制严格的 VPS 或代理环境）。