37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
---
|
||
read_when:
|
||
- 渠道已连接但消息无法流通
|
||
- 排查渠道配置错误（意图、权限、隐私模式）
|
||
summary: 渠道专属故障排除快捷指南（Discord/Telegram/WhatsApp）
|
||
title: 渠道故障排除
|
||
x-i18n:
|
||
generated_at: "2026-02-01T19:58:09Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 6542ee86b3e50929caeaab127642d135dfbc0d8a44876ec2df0fff15bf57cd63
|
||
source_path: channels/troubleshooting.md
|
||
workflow: 14
|
||
---
|
||
|
||
# 渠道故障排除
|
||
|
||
首先运行：
|
||
|
||
```bash
|
||
openclaw doctor
|
||
openclaw channels status --probe
|
||
```
|
||
|
||
`channels status --probe` 会在检测到常见渠道配置错误时输出警告，并包含小型实时检查（凭据、部分权限/成员资格）。
|
||
|
||
## 渠道
|
||
|
||
- Discord：[/channels/discord#troubleshooting](/channels/discord#troubleshooting)
|
||
- Telegram：[/channels/telegram#troubleshooting](/channels/telegram#troubleshooting)
|
||
- WhatsApp：[/channels/whatsapp#troubleshooting-quick](/channels/whatsapp#troubleshooting-quick)
|
||
|
||
## Telegram 快速修复
|
||
|
||
- 日志显示 `HttpError: Network request for 'sendMessage' failed` 或 `sendChatAction` → 检查 IPv6 DNS。如果 `api.telegram.org` 优先解析为 IPv6 而主机缺少 IPv6 出站连接，请强制使用 IPv4 或启用 IPv6。参见 [/channels/telegram#troubleshooting](/channels/telegram#troubleshooting)。
|
||
- 日志显示 `setMyCommands failed` → 检查到 `api.telegram.org` 的出站 HTTPS 和 DNS 可达性（常见于限制严格的 VPS 或代理环境）。
|