OpenClaw Telegram 接入教程：botToken、pairing、DM policy 与群聊开关

生态 生态 预计 22 分钟 发布于 2026/2/15

为什么这篇值得先看

Telegram 接入和 WhatsApp 最大的区别，不在“是不是聊天工具”，而在 token 模式、pairing 审批和群聊可见性策略。

先抓住这 3 个关键点

• Telegram 依赖 botToken，而不是单独的登录流程，这决定了你的配置入口和排错方式。
• pairing 不是装饰步骤，它和 dmPolicy / allowlist 一起定义了谁能先触达你的助手。
• 群聊里最容易出错的是 Privacy Mode、管理员权限和 requireMention 三件事。

实操步骤

1. 先在 BotFather 准备好 bot token，并把 token 放进 config 或环境变量，不要再去找不存在的 telegram login 命令。
2. 运行 gateway 后查看 pairing 列表，用 openclaw pairing approve telegram <CODE> 完成首轮审批。
3. 先把 dmPolicy 定到 pairing 或 allowlist，再决定是否开放群聊和怎样处理 mention。
4. 如果进群，优先确认 Privacy Mode、管理员权限和 requireMention 是否一致。

配置或命令示例

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } }
    }
  }
}

常见坑

• 还在找 openclaw channels login telegram，结果白白浪费时间。
• dmPolicy 设成 allowlist，但 allowFrom 为空，直接把所有私聊都挡住。
• 群里想让 bot 看所有消息，却没处理好 Privacy Mode 或管理员权限。

完成检查

• pairing 已成功审批，Telegram 私聊至少能按预期进来。
• 你知道当前是 pairing、allowlist、open 还是 disabled 策略。
• 群聊场景下，bot 的可见性和 @mention 规则已经被你主动设计。

为什么建议把这篇收藏起来

• Telegram 是很多技术用户的主工作台，值得有一篇更“配置导向”的教程。
• 这篇能帮你把 token、pairing、群聊三套逻辑一次理顺。