493 字
1 分钟
OpenClaw 对接 Telegram 机器人：从 BotFather 到可用会话
Telegram 通常是 OpenClaw 最容易跑通的渠道之一。 这篇文章专注于“可用链路”，从 token 到会话验证一步一步来。
图：OpenClaw 官方 Telegram 渠道文档页面头图。
1. 先准备 Telegram Bot
- 在 Telegram 中找到
@BotFather - 创建 bot 并拿到 Bot Token
- 把 bot 拉进目标群（如果你要测试群消息）
2. 在 OpenClaw 中完成配置
最省心的方式是走官方 onboarding：
openclaw onboard在向导里选择 Telegram，并填入 token/渠道配置。
如果你已经有现成环境，也可以通过 openclaw configure 调整渠道配置后重启网关。
3. 验证是否接入成功
openclaw channels status --probeopenclaw logs --follow再用 CLI 发一条测试消息（官方示例）：
openclaw message send --channel telegram --target 123456789 --message "hi"也支持用户名目标：
openclaw message send --channel telegram --target @name --message "hi"4. 群消息不触发的典型原因
官方文档给出的高频问题是：
- 配置期望 bot 读取非 @mention 群消息
- 但 BotFather 隐私模式未关闭
处理方法：
- 在 BotFather 执行
/setprivacy，关闭隐私 - 把 bot 移出群再重新拉入
- 再跑一次
openclaw channels status --probe
5. 安全建议
- token 不要写进公开仓库。
- 默认启用配对/白名单策略，避免陌生人直接驱动你的助手。
- 先在私聊跑通，再扩到群。
6. 配对与审批（强烈建议开启）
如果你开启了配对（pairing），新用户首次发起会话需要审批。 常用命令：
openclaw pairings list --status pendingopenclaw pairings approve <pairing-id>这样可以显著降低陌生人触发高权限动作的风险。
总结
Telegram 渠道的核心是： 配置正确 + 群权限正确 + 状态探测通过。
只要这三步到位，后续做命令、投票、自动化动作会顺很多。
参考链接
- Telegram 渠道文档：https://docs.openclaw.ai/channels/telegram
- Channels 总览：https://docs.openclaw.ai/channels/index
- Pairing 机制：https://docs.openclaw.ai/channels/pairing
延伸阅读
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
OpenClaw 对接 Telegram 机器人：从 BotFather 到可用会话
https://levifree.dpdns.org/posts/openclaw-telegram-bot-integration/ 部分信息可能已经过时
相关文章 智能推荐
1
OpenClaw 对接 Discord 机器人：Developer Portal 配置全流程
AI 从应用创建、权限和 intents 到 OpenClaw 接入与排错
2
OpenClaw 对接飞书机器人：配置与上线注意事项（含插件模式说明）
AI 新版通常可直接接入；若你的环境是旧版本或精简构建，再按插件模式安装
3
OpenClaw 部署平台选择指南：Railway / Render / Fly.io / VPS 怎么选
AI 结合官方部署文档给出场景化建议：快速上线、长期稳定、私有化安全各怎么配
4
OpenClaw 跨平台安装实战：Windows / Linux / macOS 一次讲清
AI 按官方推荐路径完成安装、网关启动与基础健康检查，避免第一步就卡住
5
OpenClaw 入门与安全实战：为什么它火，以及个人用户该怎么用
AI 从 0 到 1 跑通 OpenClaw，并用最小风险方式接入真实消息渠道