8.17 渠道故障排除

如果某个渠道不可用,优先跑诊断命令定位问题。

从这里开始

openclaw doctor
openclaw channels status --probe

--probe 会做小范围实测(凭证、部分权限/成员资格)并输出常见配置错误的提示。

按渠道排查

Telegram 快速修复

Network request failed

若遇到错误:

HttpError: Network request for 'sendMessage' failed
HttpError: Network request for 'sendChatAction' failed

通常是 IPv6 DNS 解析导致:api.telegram.org 解析到 IPv6,但宿主缺少 IPv6 出网。

临时修复:将 IPv4 地址写入 /etc/hosts

149.154.167.220 api.telegram.org
149.154.167.221 api.telegram.org
149.154.167.222 api.telegram.org
149.154.167.223 api.telegram.org

或在宿主机上启用 IPv6 出网。

setMyCommands 失败

多见于网络受限环境,确认能访问 api.telegram.org(DNS/防火墙/代理)。