先跑通私聊，再碰群组
最稳的路径永远是先让私聊回复正常，再处理群组 @、隐私模式和管理员权限，不要反过来。
OpenClaw 教程Telegram 接入Bot API
OpenClaw Telegram 接入教程：BotFather 创建机器人到首条消息跑通
这页面向搜索“OpenClaw Telegram 接入”“OpenClaw Telegram 机器人教程”“OpenClaw BotFather 配置”的用户，重点解决两件事：先把 Telegram bot 建出来，再把 OpenClaw 这边的 token、pairing 和群组行为配置清楚。
OpenClaw 官方 Telegram 文档已经很完整：它目前用 grammY 走 Bot API，私聊和群组都支持，默认模式是长轮询；你只要按官方顺序从 BotFather 创建 token、填入配置、启动 gateway、完成首轮 pairing，就能先跑通一条链路。
Telegram Bot API默认 DM policy 为 pairing群组默认 requireMention
pairing 不是报错，是默认安全策略
如果第一次发消息后机器人回了 pairing code，这说明链路已经通了，只是还没完成授权，不是接入失败。
群组里最容易漏的是 privacy mode
Telegram 机器人默认开启 Privacy Mode，这会限制它看到的群消息；很多“机器人没响应”的问题最后都出在这里。
接入前需要准备什么
OpenClaw Telegram 文档对前提条件写得很直接：你需要一个 Telegram bot token，以及一个已经安装好的 OpenClaw 环境。
- 先在 Telegram 里找到 @BotFather，执行
/newbot创建机器人，并保存生成的 token。 - 确认 OpenClaw CLI 和网关已经能正常运行，避免 Telegram 接入和基础安装问题混在一起。
- 如果你准备做群组使用，提前想清楚是否要求 @ 提及、是否允许开放访问，以及群组里是否要关闭 Privacy Mode。
Telegram 接入的最短路径
这一组步骤直接对应官方文档的 quick setup。
- 通过 BotFather 创建 bot token，保存好凭据。
- 在 OpenClaw 配置里启用 Telegram，并填入
botToken；官方示例里默认dmPolicy是 pairing，群组默认要求 mention。 - 启动 gateway：
openclaw gateway。 - 私聊你的 bot，让它返回 pairing code，然后执行
openclaw pairing list telegram和openclaw pairing approve telegram <CODE>。 - 如果要进群，先把机器人拉入群组，再按你的访问模型配置
channels.telegram.groups和groupPolicy。
群组设置最容易踩的坑
Telegram 官方机制本身会影响 OpenClaw 能看到什么消息，所以这块要单独处理。
- Telegram bot 默认开启 Privacy Mode。如果你希望机器人看到群里的更多消息，需要在 BotFather 里处理
/setprivacy，或者把机器人提升为群管理员。 - 修改 Privacy Mode 后，官方文档建议把机器人从群里移除再重新拉入，让 Telegram 重新应用设置。
- 如果群组只想在被 @ 时触发，保留默认 requireMention 即可；如果想做更强的常驻群助手，再继续调 group policy。
先把私聊跑通，再回头测群组，会比一开始直接在群里排错轻松很多。
怎么确认 Telegram 这条链路真的通了
官方文档给了几个很实用的诊断点，足够覆盖大多数排查场景。
- 通过
openclaw logs --follow看最新入站消息，顺手也能找到 Telegram 用户 ID。 - 如果你要手动验证 Bot API 更新，也可以按官方文档调用
https://api.telegram.org/bot<token>/getUpdates。 - 如果要继续做发图、发语音、轮询投票或审批流，Telegram 文档里已经有对应的 action 和 config 参考，建议在基础对话跑通后再逐项启用。