渠道排障

适用范围

当你遇到“能启动网关但渠道不工作”的情况，从这里开始排查。

先做两步快速确认

moltbot status
moltbot health

如果网关本身不可用，先把网关状态修好再看渠道。

常见问题

1) 没有收到回复

• 先确认 DM 是否需要配对批准：/docs/start/pairing/
• 群聊场景下，确认是否需要提及触发（requireMention）或被白名单拦住

2) 登录/扫码失败

• WhatsApp：重新关联设备后再执行 moltbot channels login
• 其他渠道：检查 token 是否写对、是否已更新/失效

3) 没有权限/无法发消息

• Discord/Slack/Telegram：确认 bot 已被邀请到目标频道/群组，并授予读写权限
• 共享频道建议开启提及触发并配置白名单，避免“静默被拒绝”

4) 网关能跑，但控制台/回调连不上

• 确认端口与绑定地址（loopback/LAN）
• 如果启用了 token，确认客户端/控制台使用了同一个 token

相关页面

• WhatsApp：/docs/channels/whatsapp/
• Telegram：/docs/channels/telegram/
• Discord：/docs/channels/discord/
• Slack：/docs/channels/slack/