> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 渠道故障排除

# 渠道故障排除

首先运行：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi doctor
agdi channels status --probe
```

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

## 渠道

* Discord：[/channels/discord#troubleshooting](https://agdiai-597e782f.mintlify.site/channels/discord.md#troubleshooting)
* Telegram：[/channels/telegram#troubleshooting](https://agdiai-597e782f.mintlify.site/channels/telegram.md#troubleshooting)
* WhatsApp：[/channels/whatsapp#troubleshooting-quick](https://agdiai-597e782f.mintlify.site/channels/whatsapp.md#troubleshooting-quick)

## Telegram 快速修复

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.