首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
返回文章列表
Editorial Note OpenClaw 中文站 站内专题

接入 Telegram 或 WhatsApp 前,先核对这张清单

聊天渠道看起来像“最后一步”,实际上它很容易把前面 Gateway、provider、认证、会话策略里的问题全部暴露出来。先核对基础条件,渠道接入会顺很多。

OpenClaw 小龙虾图标

Checklist

先拆开 Gateway、provider 和渠道三层问题

只要把这三层边界看清楚,渠道接入就不再是“贴配置碰运气”,而是可控地逐步放大整条链路。

接入前提

  1. 01

    Gateway 基础状态稳定,health 和 logs 都能看懂。

  2. 02

    至少一种 provider 认证已经在实际运行环境中可用。

  3. 03

    你知道 pairing、allowlist、会话持久化和二维码登录分别属于哪一层问题。

别拿渠道掩盖底层问题 四件事先成立 三层问题要拆开看 建议的接入顺序 结论

先确认你不是在拿渠道掩盖底层问题

很多人会在本地最小链路还没跑通时,就直接去配 Telegram 或 WhatsApp。这样一旦失败,你几乎无法判断问题到底在 Gateway、provider 认证,还是渠道自身的 pairing / allowlist。

这四件事要先成立

  1. Gateway 基础状态稳定,最少能看懂 openclaw gateway status 和日志输出。
  2. Provider 认证已经在真实运行环境生效,而不是只在另一台机器上可用。
  3. 你知道会话存在哪里,重启后是否会丢失,以及需要什么持久化策略。
  4. 你知道当前渠道是否需要二维码登录、配对确认或 allowlist。

接渠道时最容易混淆的三层问题

  • Gateway 层:服务没起、端口不对、token 错误、远程访问策略不对。
  • Provider 层:模型认证无效、默认模型没配好、请求链路没有真正通。
  • 渠道层:pairing、二维码、mention 规则、allowlist、群聊行为差异。

只要你能把这三层拆开看,排障范围就会立刻缩小。

建议的接入顺序

更稳的做法是:先把 Gateway 和 provider 单独验证,再按单个渠道逐步接入;每接一个渠道,就记录一次最小成功路径和最关键的日志位置。

openclaw gateway status
openclaw channels status --probe
openclaw logs --follow

结论

渠道接入不是“最后贴一个配置就结束”的动作,它是对整条运行链路的压力测试。先把基础状态收敛,再开始接真实聊天入口,效率会高很多。

Next Routes

继续阅读

如果你已经准备进入下一步,可以直接从这些站内页面继续,不必再回首页重新找。