🦞AI龙虾指南
Community Guide

将 OpenClaw 接入 Telegram

最适合作为第一条渠道的 Telegram 指南，包含 Bot 创建、配置和配对逻辑。

2026/03/13

为什么 Telegram 是默认首选

Telegram 是最适合作为第一条渠道的原因很简单：

  • 不需要公网 IP
  • 不需要反向代理
  • Bot 创建速度快
  • 配对闭环最容易理解

这意味着你可以在不额外做网络工程的前提下，验证渠道层是否正常。

基本接入流程

橙色皮书给出的顺序是：

  1. 通过 @BotFather 创建 Bot
  2. 拿到 Bot Token
  3. 把 Token 写入 OpenClaw 渠道配置
  4. 重启 Gateway
  5. 发消息并完成配对

最小配置示例

channels:
  telegram:
    enabled: true
    botToken: "YOUR_BOT_TOKEN"
    dmPolicy: pairing

这里最关键的安全设置是 pairing。它可以避免陌生用户直接使用你的实例和模型额度。

重启后会发生什么

当 Gateway 正常运行后：

  • Bot 开始收消息
  • 未配对用户私聊时先收到配对码
  • 你从已信任入口批准这个配对码
  • 然后对话才真正开始

常见错误

  • 把渠道问题和模型问题混在一起排查
  • 改配置后忘记重启 Gateway
  • 误以为所有渠道都需要公网暴露

Telegram 的价值之一，就是它能帮你绕开第三类复杂度。

下一步看什么