Telegram | OpenClaw 中文站

聊天渠道 3 个部分 3 条关键信息

Telegram Bot API

Telegram 是最快能把 OpenClaw 接进真实聊天场景的渠道之一。默认使用长轮询，可选 webhook；私信默认走配对审批，群组默认按提及激活。

快速设置

1. 到 @BotFather 创建机器人并复制 token。

2. 通过环境变量 TELEGRAM_BOT_TOKEN 或配置 channels.telegram.botToken 提供令牌。

3. 启动 Gateway，私信访问默认会生成配对码，需要你手动批准。

4. 若要接入群组，进一步配置 channels.telegram.groups 与提及规则。

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

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: true }
      }
    }
  }
}

Privacy

如果机器人要看到所有群组消息，要么关闭 BotFather 隐私模式，要么把机器人设成管理员。

Formatting

OpenClaw 会把常见 Markdown 结构转换成 Telegram 安全 HTML；如果 Telegram 拒绝 HTML，系统会回退为纯文本。

Streaming

在支持线程模式的场景下，Telegram 私信能通过草稿气泡流式展示部分回复。

Troubleshooting

setMyCommands failed、sendMessage 失败通常和 IPv6 / DNS / 出站 HTTPS 连通性有关。