写在前面
如果你只是想先把第一条消息链路跑通，Telegram 通常是最适合先做的平台。
这一步不要同时验证群组、复杂权限和多路由，先完成一个私聊入口的最小闭环：
- Bot 已创建；
- 凭据已填入 OpenClaw；
- 你能发出一条测试消息；
- OpenClaw 能正常回复。
第一步：先准备 Telegram 侧信息
开始配置前，先确认下面几项已经准备好：
- 你已经创建了 Telegram Bot；
- 你已经拿到 Bot Token；
- 你知道这个 Bot 会用哪个账号或用途来接入；
- 你能从自己的 Telegram 客户端直接给这个 Bot 发消息。
如果 Bot 还没创建，或者 Token 还没拿到，就先停在平台侧准备，不要急着改 OpenClaw 配置。
第二步：在 OpenClaw 里添加 Telegram 渠道
如果你走交互式配置，可以先运行：
openclaw configure如果你已经知道要接 Telegram，也可以直接添加渠道：
openclaw channels add \
--channel telegram \
--account alerts \
--name "Alerts Bot" \
--token $TELEGRAM_BOT_TOKEN命令执行后，不要立刻假设已经成功，先检查渠道状态。
第三步：先看渠道状态和探测结果
执行：
openclaw channels status
openclaw channels status --probe你现在要确认的是：
- Telegram 渠道已经出现在状态列表里；
--probe没有直接报认证失败、配置缺失或连接错误；- Gateway 日志中没有持续性的 Telegram 报错。
如果这里已经报错，就先修凭据或渠道配置，不要直接跳去测消息回复。
第四步：只用私聊做第一次验证
现在从 Telegram 里直接给 Bot 发一条最简单的消息，例如：
你好现在你能收到消息吗帮我复述这句话
第一次只测私聊，不要先测群组。
群组会额外引入：
- 提及规则；
- 群权限；
- 白名单或门控；
- 机器人在群里的可见性问题。
这些变量都应该后置。
第五步：同时看回复和日志
测试消息发出后，建议同时开一个日志窗口：
openclaw logs --follow判断标准很简单：
- Telegram 里收到了正常回复；
- 日志里能看到对应的消息进入和处理记录；
- 没有持续性的认证错误、配对错误或权限错误。
如果平台里有回复，但日志异常很多，先别继续扩展场景。
如果平台里没回复，但日志已经看到消息进入，问题多半在后续处理链路，而不是 Telegram 完全没接上。
怎么判断这次接入成功
满足下面几条，就可以认为 Telegram 首轮接入已经成立：
openclaw channels status --probe可以正常通过；- 你能从自己的 Telegram 给 Bot 发出私聊消息；
- OpenClaw 能返回一条正常回复；
- 日志没有持续性的阻塞错误。
只看到 connected 还不够。真正算接通，必须至少完成一次消息收发闭环。
常见错误或风险
- Bot 还没创建好，就先开始改 OpenClaw 配置；
- Token 填错或环境变量未生效；
- 还没跑通私聊，就先测群组；
- 看到渠道已连接，就误以为整条消息链路已经可用；
- 一边改 Telegram 设置，一边同时改 OpenClaw 配置，最后分不清是哪边导致异常。
下一步
如果 Telegram 已经能稳定收发消息，继续看 命令行与基础配置 或 配置改完如何验证。
如果渠道已连接但始终不回复，先去 接入失败时怎么分类。