接入第一个聊天平台

写在前面

安装完成并不等于真正能用。对大多数人来说,OpenClaw 真正开始产生价值,是在它接入第一个聊天平台之后。

这一步只做一件事:先接通一个平台,并完成一次最小消息验证。

第一步:只选一个你自己高频使用的平台

第一次接入口,不要同时铺 Telegram、Discord、Slack 等多个平台。

更稳妥的选择标准是:

  • 你本来就每天会打开;
  • 该平台创建机器人或应用的流程比较清楚;
  • 接通后你能立刻发一条消息验证。

如果只是为了先跑通链路,优先选你最熟的平台,而不是“以后可能要用的平台”。

第二步:先在平台侧把信息准备完整

不管你选哪个平台,先把下面几类信息准备好,再进入 OpenClaw 配置:

  • 机器人或应用身份;
  • Token、密钥或平台授权信息;
  • webhook、回调地址或消息入口;
  • 平台要求的基础权限。

如果这些信息还没拿全,后面即使填了配置,也很难判断问题到底出在 OpenClaw 还是平台侧。

第三步:用向导或命令添加渠道

如果你想重新走一遍交互式配置,可以运行:

openclaw configure

如果你已经知道自己要接哪个平台,也可以直接用渠道命令添加。

Telegram

openclaw channels add \
  --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

Discord

openclaw channels add \
  --channel discord \
  --account work \
  --name "Work Bot" \
  --token $DISCORD_BOT_TOKEN

添加完成后,先不要急着做复杂任务,先检查渠道状态:

openclaw channels status
openclaw channels status --probe

判断标准:

  • 渠道已经出现在状态列表中;
  • --probe 没有直接给出认证失败、配置缺失或连接错误;
  • Gateway 日志中没有持续性的渠道报错。

第四步:发一条最小测试消息

渠道加好后,立刻从对应平台发一条最简单的测试消息,例如:

  • 你好
  • 帮我复述这句话
  • 现在你能正常收到消息吗

这一步不是为了测试模型聪不聪明,而是为了确认链路已经跑通。

你要同时看两边:

  • 平台侧是否真的收到了回复;
  • OpenClaw 侧日志是否正确记录了这次消息处理。

建议同时开一个日志窗口:

openclaw logs --follow

第五步:如果收不到回复,按这个顺序排查

1. 先看渠道状态

openclaw channels status --probe

如果这里已经报认证或连接问题,就先修平台配置,不要继续猜模型或技能问题。

2. 再看渠道日志

openclaw channels logs --channel telegram --limit 200

如果你接的是 Discord,就把 telegram 换成 discord

3. 再看 Gateway 总日志

openclaw logs --limit 100

重点排查:

  • Token 是否填错;
  • webhook 或回调设置是否缺失;
  • 权限是否不足;
  • Gateway 是否根本没收到平台事件。

常见错误或风险

  • 不要一开始就接多个平台,否则很难定位问题;
  • 不要只看平台侧成功提示,要同时看 OpenClaw 的渠道状态和日志;
  • 不要把“平台连上了”误判成“整条消息处理链路已经没问题”;
  • 如果平台消息都还没跑通,就不要继续测试复杂任务。

下一步

平台接通后,继续看 命令行与基础配置