先确认你不是在拿渠道掩盖底层问题
很多人会在本地最小链路还没跑通时,就直接去配 Telegram 或 WhatsApp。这样一旦失败,你几乎无法判断问题到底在 Gateway、provider 认证,还是渠道自身的 pairing / allowlist。
这四件事要先成立
- Gateway 基础状态稳定,最少能看懂
openclaw gateway status和日志输出。 - Provider 认证已经在真实运行环境生效,而不是只在另一台机器上可用。
- 你知道会话存在哪里,重启后是否会丢失,以及需要什么持久化策略。
- 你知道当前渠道是否需要二维码登录、配对确认或 allowlist。
接渠道时最容易混淆的三层问题
- Gateway 层:服务没起、端口不对、token 错误、远程访问策略不对。
- Provider 层:模型认证无效、默认模型没配好、请求链路没有真正通。
- 渠道层:pairing、二维码、mention 规则、allowlist、群聊行为差异。
只要你能把这三层拆开看,排障范围就会立刻缩小。
建议的接入顺序
更稳的做法是:先把 Gateway 和 provider 单独验证,再按单个渠道逐步接入;每接一个渠道,就记录一次最小成功路径和最关键的日志位置。
openclaw gateway status
openclaw channels status --probe
openclaw logs --follow 结论
渠道接入不是“最后贴一个配置就结束”的动作,它是对整条运行链路的压力测试。先把基础状态收敛,再开始接真实聊天入口,效率会高很多。