Telegram (Bot API)

状态:生产就绪,支持通过 grammY 实现机器人私聊 + 群组。默认使用长轮询;可选 webhook。

快速设置(新手)

使用 @BotFather 创建机器人(直接链接)。确认用户名完全是 @BotFather,然后复制令牌。
设置令牌:
- 环境变量:TELEGRAM_BOT_TOKEN=...
- 或配置:channels.telegram.botToken: "..."。
- 如果两者都设置,配置优先(环境变量回退仅适用于默认账户)。
启动网关。
私聊访问默认使用配对;首次联系时批准配对代码。

最小配置:

json5

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

它是什么

由网关拥有的 Telegram Bot API 频道。
确定性路由:回复返回到 Telegram;模型永远不会选择频道。
私聊共享代理的主会话;群组保持隔离(agent:<agentId>:telegram:group:<chatId>)。

设置(快速路径)

1) 创建机器人令牌(BotFather)

打开 Telegram 并与 @BotFather 聊天(直接链接)。确认用户名完全是 @BotFather。
运行 /newbot,然后按照提示操作(名称 + 以 bot 结尾的用户名)。
复制令牌并安全存储。

可选的 BotFather 设置:

/setjoingroups — 允许/拒绝将机器人添加到群组。
/setprivacy — 控制机器人是否能看到所有群组消息。

2) 配置令牌(环境变量或配置)

示例:

json5

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

环境变量选项:TELEGRAM_BOT_TOKEN=...(适用于默认账户)。如果环境变量和配置都设置了,配置优先。

多账户支持:使用 channels.telegram.accounts 配置每个账户的令牌和可选的 name。共享模式请参见 gateway/configuration。

启动网关。当令牌被解析时 Telegram 启动(配置优先,环境变量回退)。
私聊访问默认使用配对。当机器人首次被联系时批准代码。
对于群组:添加机器人,决定隐私/管理员行为(见下文),然后设置 channels.telegram.groups 以控制提及门控 + 允许列表。

令牌 + 隐私 + 权限(Telegram 端)

令牌创建(BotFather)

/newbot 创建机器人并返回令牌(保密)。
如果令牌泄露,通过 @BotFather 撤销/重新生成它并更新您的配置。

群组消息可见性(隐私模式)

Telegram 机器人默认使用隐私模式,这会限制它们接收的群组消息。如果您的机器人必须看到_所有_群组消息,您有两个选项:

使用 /setprivacy 禁用隐私模式或
将机器人添加为群组管理员(管理员机器人接收所有消息)。

注意: 当您切换隐私模式时,Telegram 要求从每个群组中移除 + 重新添加机器人,更改才能生效。

群组权限(管理员权限)

管理员状态在群组内设置(Telegram UI)。管理员机器人始终接收所有群组消息,因此如果您需要完全可见性,请使用管理员。

工作原理(行为)

入站消息被规范化为共享频道信封,带有回复上下文和媒体占位符。
默认情况下,群组回复需要提及(原生 @提及或 agents.list[].groupChat.mentionPatterns / messages.groupChat.mentionPatterns)。
多代理覆盖:在 agents.list[].groupChat.mentionPatterns 上设置每个代理的模式。
回复始终路由回同一个 Telegram 聊天。
长轮询使用 grammY runner,具有每个聊天的排序;总体并发由 agents.defaults.maxConcurrent 限制。
Telegram Bot API 不支持已读回执;没有 sendReadReceipts 选项。

草稿流式传输

OpenClaw 可以使用 sendMessageDraft 在 Telegram 私聊中流式传输部分回复。

要求:

在 @BotFather 中为机器人启用线程模式(论坛主题模式)。
仅限私聊线程(Telegram 在入站消息中包含 message_thread_id)。
channels.telegram.streamMode 未设置为 "off"(默认:"partial","block" 启用分块草稿更新)。

草稿流式传输仅限私聊;Telegram 不支持群组或频道中的流式传输。

格式化(Telegram HTML)

出站 Telegram 文本使用 parse_mode: "HTML"(Telegram 支持的标签子集)。
Markdown 风格的输入被渲染为 Telegram 安全 HTML(粗体/斜体/删除线/代码/链接);块元素被扁平化为带换行符/项目符号的文本。
模型的原始 HTML 被转义以避免 Telegram 解析错误。
如果 Telegram 拒绝 HTML 负载,OpenClaw 将同一消息作为纯文本重试。

命令(原生 + 自定义)

OpenClaw 在启动时向 Telegram 的机器人菜单注册原生命令(如 /status、/reset、/model)。您可以通过配置向菜单添加自定义命令:

json5

{
  channels: {
    telegram: {
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
    },
  },
}

故障排除

日志中的 setMyCommands failed 通常意味着到 api.telegram.org 的出站 HTTPS/DNS 被阻止。
如果您看到 sendMessage 或 sendChatAction 失败,请检查 IPv6 路由和 DNS。

更多帮助:频道故障排除。

注意:

自定义命令仅是菜单项;OpenClaw 不会实现它们,除非您在其他地方处理它们。
命令名称被规范化(删除前导 /,小写)并且必须匹配 a-z、0-9、_(1–32 个字符)。
自定义命令不能覆盖原生命令。冲突会被忽略并记录。
如果 commands.native 被禁用,则只注册自定义命令(如果没有则清除)。

限制

出站文本被分块为 channels.telegram.textChunkLimit(默认 4000)。
可选换行分块:设置 channels.telegram.chunkMode="newline" 在长度分块之前按空行(段落边界)拆分。
媒体下载/上传上限为 channels.telegram.mediaMaxMb(默认 5)。
Telegram Bot API 请求在 channels.telegram.timeoutSeconds 后超时(默认 500,通过 grammY)。设置较低值以避免长时间挂起。
群组历史上下文使用 channels.telegram.historyLimit(或 channels.telegram.accounts.*.historyLimit),回退到 messages.groupChat.historyLimit。设置 0 禁用(默认 50)。
私聊历史可以用 channels.telegram.dmHistoryLimit(用户轮次)限制。每用户覆盖:channels.telegram.dms["<user_id>"].historyLimit。

群组激活模式

默认情况下,机器人仅响应群组中的提及(@botname 或 agents.list[].groupChat.mentionPatterns 中的模式)。要更改此行为:

通过配置(推荐)

json5

{
  channels: {
    telegram: {
      groups: {
        "-1001234567890": { requireMention: false }, // always respond in this group
      },
    },
  },
}

重要: 设置 channels.telegram.groups 会创建一个允许列表 - 只有列出的群组(或 "*")会被接受。论坛主题继承其父群组配置(allowFrom、requireMention、skills、prompts),除非您在 channels.telegram.groups.<groupId>.topics.<topicId> 下添加每个主题的覆盖。

允许所有群组并始终响应:

json5

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false }, // all groups, always respond
      },
    },
  },
}

保持所有群组仅提及(默认行为):

json5

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: true }, // or omit groups entirely
      },
    },
  },
}

通过命令(会话级)

在群组中发送:

/activation always - 响应所有消息
/activation mention - 需要提及(默认)

注意: 命令仅更新会话状态。要在重启后保持持久行为,请使用配置。

获取群组聊天 ID

将群组中的任何消息转发到 Telegram 上的 @userinfobot 或 @getidsbot 以查看聊天 ID(如 -1001234567890 的负数)。

提示: 要获取您自己的用户 ID,私聊机器人,它将回复您的用户 ID(配对消息),或在命令启用后使用 /whoami。

隐私注意: @userinfobot 是第三方机器人。如果您愿意,可以将机器人添加到群组,发送消息,并使用 openclaw logs --follow 读取 chat.id,或使用 Bot API getUpdates。

配置写入

默认情况下,Telegram 允许写入由频道事件或 /config set|unset 触发的配置更新。

这发生在:

群组升级为超级群组,Telegram 发出 migrate_to_chat_id(聊天 ID 更改)。OpenClaw 可以自动迁移 channels.telegram.groups。
您在 Telegram 聊天中运行 /config set 或 /config unset(需要 commands.config: true)。

禁用:

json5

{
  channels: { telegram: { configWrites: false } },
}

主题(论坛超级群组)

Telegram 论坛主题每条消息包含一个 message_thread_id。OpenClaw:

将 :topic:<threadId> 附加到 Telegram 群组会话键,以便每个主题隔离。
发送输入指示器并用 message_thread_id 回复,以便响应保留在主题中。
常规主题(线程 id 1)是特殊的:消息发送时省略 message_thread_id(Telegram 拒绝它),但输入指示器仍包含它。
在模板上下文中公开 MessageThreadId + IsForum 用于路由/模板化。
主题特定配置在 channels.telegram.groups.<chatId>.topics.<threadId> 下可用(技能、允许列表、自动回复、系统提示、禁用)。
主题配置继承群组设置(requireMention、allowlists、skills、prompts、enabled),除非每个主题覆盖。

在某些边缘情况下,私聊可以包含 message_thread_id。OpenClaw 保持私聊会话键不变,但在存在时仍将线程 id 用于回复/草稿流式传输。

内联按钮

Telegram 支持带有回调按钮的内联键盘。

json5

{
  channels: {
    telegram: {
      capabilities: {
        inlineButtons: "allowlist",
      },
    },
  },
}

每个账户的配置:

json5

{
  channels: {
    telegram: {
      accounts: {
        main: {
          capabilities: {
            inlineButtons: "allowlist",
          },
        },
      },
    },
  },
}

范围:

off — 禁用内联按钮
dm — 仅私聊(阻止群组目标)
group — 仅群组(阻止私聊目标)
all — 私聊 + 群组
allowlist — 私聊 + 群组,但仅限 allowFrom/groupAllowFrom 允许的发送者(与控制命令相同的规则)

默认:allowlist。旧版:capabilities: ["inlineButtons"] = inlineButtons: "all"。

发送按钮

使用带有 buttons 参数的消息工具:

json5

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  message: "Choose an option:",
  buttons: [
    [
      { text: "Yes", callback_data: "yes" },
      { text: "No", callback_data: "no" },
    ],
    [{ text: "Cancel", callback_data: "cancel" }],
  ],
}

当用户点击按钮时,回调数据以以下格式作为消息发送回代理: callback_data: value

配置选项

Telegram 功能可以在两个级别配置(上面显示对象形式;仍支持旧版字符串数组):

channels.telegram.capabilities:应用于所有 Telegram 账户的全局默认功能配置,除非被覆盖。
channels.telegram.accounts.<account>.capabilities:覆盖该特定账户的全局默认值的每个账户功能。

当所有 Telegram 机器人/账户应具有相同行为时,使用全局设置。当不同的机器人需要不同的行为时(例如,一个账户仅处理私聊,而另一个在群组中被允许),使用每个账户配置。

访问控制(私聊 + 群组)

私聊访问

默认:channels.telegram.dmPolicy = "pairing"。未知发送者收到配对代码;在批准之前忽略消息(代码 1 小时后过期)。
批准通过:
- openclaw pairing list telegram
- openclaw pairing approve telegram <CODE>
配对是用于 Telegram 私聊的默认令牌交换。详情:配对
channels.telegram.allowFrom 接受数字用户 ID(推荐)或 @username 条目。它不是机器人用户名;使用人类发送者的 ID。向导接受 @username 并在可能的情况下将其解析为数字 ID。

查找您的 Telegram 用户 ID

更安全(无第三方机器人):

启动网关并私聊您的机器人。
运行 openclaw logs --follow 并查找 from.id。

备选(官方 Bot API):

私聊您的机器人。
使用您的机器人令牌获取更新并读取 message.from.id:
bash
```
curl "https://api.telegram.org/bot<bot_token>/getUpdates"
```
1

第三方(隐私较低):

私聊 @userinfobot 或 @getidsbot 并使用返回的用户 ID。

群组访问

两个独立的控制:

1. 允许哪些群组(通过 channels.telegram.groups 的群组允许列表):

没有 groups 配置 = 允许所有群组
有 groups 配置 = 只允许列出的群组或 "*"
示例:"groups": { "-1001234567890": {}, "*": {} } 允许所有群组

2. 允许哪些发送者(通过 channels.telegram.groupPolicy 的发送者过滤):

"open" = 允许群组中的所有发送者发送消息
"allowlist" = 只有 channels.telegram.groupAllowFrom 中的发送者可以发送消息
"disabled" = 不接受任何群组消息默认为 groupPolicy: "allowlist"(被阻止,除非您添加 groupAllowFrom)。

大多数用户想要:groupPolicy: "allowlist" + groupAllowFrom + 在 channels.telegram.groups 中列出的特定群组

长轮询 vs webhook

默认:长轮询(无需公共 URL)。
Webhook 模式:设置 channels.telegram.webhookUrl 和 channels.telegram.webhookSecret(可选 channels.telegram.webhookPath)。
- 本地侦听器绑定到 0.0.0.0:8787 并默认提供 POST /telegram-webhook。
- 如果您的公共 URL 不同,请使用反向代理并将 channels.telegram.webhookUrl 指向公共端点。

回复线程

Telegram 通过标签支持可选的线程回复:

[[reply_to_current]] -- 回复触发消息。
[[reply_to:<id>]] -- 回复特定消息 ID。

由 channels.telegram.replyToMode 控制:

first(默认)、all、off。

音频消息(语音 vs 文件)

Telegram 区分语音笔记(圆形气泡)和音频文件(元数据卡)。 OpenClaw 默认为音频文件以实现向后兼容。

要在代理回复中强制使用语音笔记气泡,请在回复中的任何位置包含此标签:

[[audio_as_voice]] — 将音频作为语音笔记而不是文件发送。

该标签从传递的文本中剥离。其他频道忽略此标签。

对于消息工具发送,设置带有语音兼容音频 media URL 的 asVoice: true (当存在媒体时 message 是可选的):

json5

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  media: "https://example.com/voice.ogg",
  asVoice: true,
}

贴纸

OpenClaw 支持通过智能缓存接收和发送 Telegram 贴纸。

接收贴纸

当用户发送贴纸时,OpenClaw 根据贴纸类型处理它:

静态贴纸(WEBP): 下载并通过视觉处理。贴纸在消息内容中显示为 <media:sticker> 占位符。
动画贴纸(TGS): 跳过(不支持 Lottie 格式处理)。
视频贴纸(WEBM): 跳过(不支持视频格式处理)。

接收贴纸时可用的模板上下文字段:

Sticker — 对象包含:
- emoji — 与贴纸关联的表情符号
- setName — 贴纸集名称
- fileId — Telegram 文件 ID(发送相同贴纸)
- fileUniqueId — 用于缓存查找的稳定 ID
- cachedDescription — 可用时的缓存视觉描述

贴纸缓存

贴纸通过 AI 的视觉功能处理以生成描述。由于相同的贴纸经常重复发送,OpenClaw 缓存这些描述以避免冗余的 API 调用。

工作原理:

首次遇到: 贴纸图像被发送到 AI 进行视觉分析。AI 生成描述(例如,"一只卡通猫热情地挥手")。
缓存存储: 描述与贴纸的文件 ID、表情符号和集合名称一起保存。
后续遇到: 当再次看到相同的贴纸时,直接使用缓存的描述。图像不会发送到 AI。

缓存位置: ~/.openclaw/telegram/sticker-cache.json

缓存条目格式:

json

{
  "fileId": "CAACAgIAAxkBAAI...",
  "fileUniqueId": "AgADBAADb6cxG2Y",
  "emoji": "👋",
  "setName": "CoolCats",
  "description": "A cartoon cat waving enthusiastically",
  "cachedAt": "2026-01-15T10:30:00.000Z"
}

好处:

通过避免对同一贴纸的重复视觉调用来降低 API 成本
缓存贴纸的响应时间更快(无视觉处理延迟)
支持基于缓存描述的贴纸搜索功能

缓存在收到贴纸时自动填充。不需要手动缓存管理。

发送贴纸

代理可以使用 sticker 和 sticker-search 操作发送和搜索贴纸。这些默认禁用,必须在配置中启用:

json5

{
  channels: {
    telegram: {
      actions: {
        sticker: true,
      },
    },
  },
}

发送贴纸:

json5

{
  action: "sticker",
  channel: "telegram",
  to: "123456789",
  fileId: "CAACAgIAAxkBAAI...",
}

参数:

fileId(必需)— 贴纸的 Telegram 文件 ID。从接收贴纸时的 Sticker.fileId 或 sticker-search 结果获取。
replyTo(可选)— 要回复的消息 ID。
threadId(可选)— 论坛主题的消息线程 ID。

搜索贴纸:

代理可以按描述、表情符号或集合名称搜索缓存的贴纸:

json5

{
  action: "sticker-search",
  channel: "telegram",
  query: "cat waving",
  limit: 5,
}

从缓存返回匹配的贴纸:

json5

{
  ok: true,
  count: 2,
  stickers: [
    {
      fileId: "CAACAgIAAxkBAAI...",
      emoji: "👋",
      description: "A cartoon cat waving enthusiastically",
      setName: "CoolCats",
    },
  ],
}

搜索在描述文本、表情符号字符和集合名称中使用模糊匹配。

线程示例:

json5

{
  action: "sticker",
  channel: "telegram",
  to: "-1001234567890",
  fileId: "CAACAgIAAxkBAAI...",
  replyTo: 42,
  threadId: 123,
}

流式传输(草稿)

Telegram 可以在代理生成响应时流式传输草稿气泡。 OpenClaw 使用 Bot API sendMessageDraft(不是真实消息),然后将最终回复作为普通消息发送。

要求(Telegram Bot API 9.3+):

启用主题的私聊(机器人的论坛主题模式)。
入站消息必须包含 message_thread_id(私人主题线程)。
群组/超级群组/频道忽略流式传输。

配置:

channels.telegram.streamMode: "off" | "partial" | "block"(默认:partial)
- partial:使用最新流式文本更新草稿气泡。
- block:以较大块(分块)更新草稿气泡。
- off:禁用草稿流式传输。
可选(仅适用于 streamMode: "block"):
- channels.telegram.draftChunk: { minChars?, maxChars?, breakPreference? }
  - 默认值:minChars: 200、maxChars: 800、breakPreference: "paragraph"(限制为 channels.telegram.textChunkLimit)。

注意:草稿流式传输与块流式传输(频道消息)分开。块流式传输默认关闭,如果您想要早期 Telegram 消息而不是草稿更新,则需要 channels.telegram.blockStreaming: true。

推理流(仅 Telegram):

/reasoning stream 在生成回复时将推理流式传输到草稿气泡中,然后发送不带推理的最终答案。
如果 channels.telegram.streamMode 为 off,则禁用推理流。更多上下文:流式传输 + 分块。

重试策略

出站 Telegram API 调用在瞬态网络/429 错误时使用指数退避和抖动重试。通过 channels.telegram.retry 配置。参见重试策略。

代理工具(消息 + 反应)

工具:带 sendMessage 操作的 telegram(to、content、可选 mediaUrl、replyToMessageId、messageThreadId)。
工具:带 react 操作的 telegram(chatId、messageId、emoji)。
工具:带 deleteMessage 操作的 telegram(chatId、messageId)。
反应移除语义:参见 /tools/reactions。
工具门控:channels.telegram.actions.reactions、channels.telegram.actions.sendMessage、channels.telegram.actions.deleteMessage(默认:启用)和 channels.telegram.actions.sticker(默认:禁用)。

反应通知

反应如何工作: Telegram 反应作为单独的 message_reaction 事件到达,而不是作为消息负载中的属性。当用户添加反应时,OpenClaw:

从 Telegram API 接收 message_reaction 更新
将其转换为格式为 "Telegram reaction added: {emoji} by {user} on msg {id}" 的系统事件
使用与常规消息相同的会话键将系统事件排队
当下一条消息到达该对话时,系统事件被排出并添加到代理上下文之前

代理将反应视为对话历史中的系统通知,而不是消息元数据。

配置:

channels.telegram.reactionNotifications:控制哪些反应触发通知
- "off" — 忽略所有反应
- "own" — 当用户对机器人消息做出反应时通知(尽力而为;内存中)(默认)
- "all" — 通知所有反应
channels.telegram.reactionLevel:控制代理的反应能力
- "off" — 代理无法对消息做出反应
- "ack" — 机器人发送确认反应(处理时 👀)(默认)
- "minimal" — 代理可以谨慎地做出反应(指导:每 5-10 次交换 1 次)
- "extensive" — 代理可以在适当时自由做出反应

论坛群组: 论坛群组中的反应包含 message_thread_id 并使用类似 agent:main:telegram:group:{chatId}:topic:{threadId} 的会话键。这确保同一主题中的反应和消息保持在一起。

示例配置:

json5

{
  channels: {
    telegram: {
      reactionNotifications: "all", // See all reactions
      reactionLevel: "minimal", // Agent can react sparingly
    },
  },
}

要求:

Telegram 机器人必须在 allowed_updates 中明确请求 message_reaction(由 OpenClaw 自动配置)
对于 webhook 模式,反应包含在 webhook allowed_updates 中
对于轮询模式,反应包含在 getUpdates allowed_updates 中

传递目标(CLI/cron)

使用聊天 ID(123456789)或用户名(@name)作为目标。
示例:openclaw message send --channel telegram --target 123456789 --message "hi"。

故障排除

机器人不响应群组中的非提及消息:

如果您设置了 channels.telegram.groups.*.requireMention=false,Telegram 的 Bot API 隐私模式必须被禁用。
- BotFather:/setprivacy → 禁用(然后从群组中移除 + 重新添加机器人)
openclaw channels status 在配置期望未提及的群组消息时显示警告。
openclaw channels status --probe 可以额外检查显式数字群组 ID 的成员资格(它无法审核通配符 "*" 规则)。
快速测试:/activation always(仅会话;使用配置以持久化)

机器人根本看不到群组消息:

如果设置了 channels.telegram.groups,则必须列出群组或使用 "*"
检查 @BotFather 中的隐私设置 → "群组隐私"应为关闭
验证机器人实际上是成员(不仅仅是没有读取权限的管理员)
检查网关日志:openclaw logs --follow(查找"跳过群组消息")

机器人响应提及但不响应 /activation always:

/activation 命令更新会话状态但不持久化到配置
要持久化行为,将群组添加到 channels.telegram.groups 并设置 requireMention: false

像 /status 这样的命令不起作用:

确保您的 Telegram 用户 ID 已授权(通过配对或 channels.telegram.allowFrom)
即使在 groupPolicy: "open" 的群组中,命令也需要授权

长轮询在 Node 22+ 上立即中止(通常与代理/自定义 fetch 一起):

Node 22+ 对 AbortSignal 实例更严格;外部信号可能会立即中止 fetch 调用。
升级到规范化中止信号的 OpenClaw 构建,或在能够升级之前在 Node 20 上运行网关。

机器人启动后静默停止响应(或记录 HttpError: Network request ... failed):

某些主机首先将 api.telegram.org 解析为 IPv6。如果您的服务器没有可用的 IPv6 出口,grammY 可能会卡在仅 IPv6 的请求上。
通过启用 IPv6 出口或强制 api.telegram.org 的 IPv4 解析来修复(例如,使用 IPv4 A 记录添加 /etc/hosts 条目,或在您的操作系统 DNS 堆栈中优先使用 IPv4),然后重启网关。
快速检查:dig +short api.telegram.org A 和 dig +short api.telegram.org AAAA 以确认 DNS 返回的内容。

配置参考(Telegram)

完整配置:配置

提供商选项:

channels.telegram.enabled:启用/禁用频道启动。

Telegram (Bot API) ​

快速设置(新手) ​

它是什么 ​

设置(快速路径) ​

1) 创建机器人令牌(BotFather) ​

2) 配置令牌(环境变量或配置) ​

令牌 + 隐私 + 权限(Telegram 端) ​

令牌创建(BotFather) ​

群组消息可见性(隐私模式) ​

群组权限(管理员权限) ​

工作原理(行为) ​

草稿流式传输 ​

格式化(Telegram HTML) ​

命令(原生 + 自定义) ​

故障排除 ​

限制 ​

群组激活模式 ​

通过配置(推荐) ​

通过命令(会话级) ​

获取群组聊天 ID ​

配置写入 ​

主题(论坛超级群组) ​

内联按钮 ​

发送按钮 ​

配置选项 ​

访问控制(私聊 + 群组) ​

私聊访问 ​

查找您的 Telegram 用户 ID ​

群组访问 ​

长轮询 vs webhook ​

回复线程 ​

音频消息(语音 vs 文件) ​

贴纸 ​

接收贴纸 ​

贴纸缓存 ​

发送贴纸 ​

流式传输(草稿) ​

重试策略 ​

代理工具(消息 + 反应) ​

反应通知 ​

传递目标(CLI/cron) ​

故障排除 ​

配置参考(Telegram) ​

Telegram (Bot API)

快速设置(新手)

它是什么

设置(快速路径)

1) 创建机器人令牌(BotFather)

2) 配置令牌(环境变量或配置)

令牌 + 隐私 + 权限(Telegram 端)

令牌创建(BotFather)

群组消息可见性(隐私模式)

群组权限(管理员权限)

工作原理(行为)

草稿流式传输

格式化(Telegram HTML)

命令(原生 + 自定义)

故障排除

限制

群组激活模式

通过配置(推荐)

通过命令(会话级)

获取群组聊天 ID

配置写入

主题(论坛超级群组)

内联按钮

发送按钮

配置选项

访问控制(私聊 + 群组)

私聊访问

查找您的 Telegram 用户 ID

群组访问

长轮询 vs webhook

回复线程

音频消息(语音 vs 文件)

贴纸

接收贴纸

贴纸缓存

发送贴纸

流式传输(草稿)

重试策略

代理工具(消息 + 反应)

反应通知

传递目标(CLI/cron)

故障排除

配置参考(Telegram)