OpenClaw接入Telegram

Telegram（Bot API）

状态：通过 grammY 支持机器人私信和群组，已可用于生产环境。默认使用长轮询；webhook 可选。

快速设置（入门）

1. 通过@BotFather（直达链接）创建机器人。确认用户名确实是@BotFather，然后复制 token。
2. 设置 token：
• 环境变量：TELEGRAMBOTTOKEN=...
• 或配置：channels.telegram.botToken: "..."。
• 如果两者都设置了，配置优先（环境变量回退仅适用于默认账户）。
3. 启动 Gateway 网关。
4. 私信访问默认使用配对模式；首次联系时需要批准配对码。

最小配置：

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

这是什么

• 一个由 Gateway 网关拥有的 Telegram Bot API 渠道。
• 确定性路由：回复返回到 Telegram；模型不会选择渠道。
• 私信共享智能体的主会话；群组保持隔离（agent:<agentId:telegram:group:<chatId）。

设置（快速路径）

1）创建机器人 token（BotFather）

1. 打开 Telegram 并与@BotFather（直达链接）对话。确认用户名确实是@BotFather。
2. 运行/newbot，然后按照提示操作（名称 + 以bot结尾的用户名）。
3. 复制 token 并安全保存。

可选的 BotFather 设置：

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

2）配置 token（环境变量或配置文件）

示例：

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

环境变量选项：TELEGRAMBOTTOKEN=...（适用于默认账户）。 如果环境变量和配置都设置了，配置优先。 多账户支持：使用channels.telegram.accounts，每个账户有独立的 token 和可选的name。参见gateway/configuration了解共享模式。

3. 启动 Gateway 网关。当 token 解析成功时 Telegram 启动（配置优先，环境变量回退）。
4. 私信访问默认为配对模式。机器人首次被联系时批准配对码。
5. 对于群组：添加机器人，决定隐私/管理员行为（见下文），然后设置channels.telegram.groups来控制提及门控和允许列表。

Token + 隐私 + 权限（Telegram 端）

Token 创建（BotFather）

• /newbot创建机器人并返回 token（请保密）。
• 如果 token 泄露，通过 @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 可以在 Telegram 私信中使用sendMessageDraft流式传输部分回复。 要求：

• 在 @BotFather 中为机器人启用线程模式（论坛话题模式）。
• 仅限私聊线程（Telegram 在入站消息中包含messagethreadid）。
• 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）。 你可以通过配置向菜单添加自定义命令：

{ channels: { telegram: { customCommands: [ { command: "backup", description: "Git 备份" }, { command: "generate", description: "创建图片" }, ], }, }, }

故障排除

• 日志中出现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后超时（通过 grammY 默认 500）。设置较低的值以避免长时间挂起。
• 群组历史上下文使用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中的模式）。要更改此行为：

通过配置（推荐）

{ channels: { telegram: { groups: { "-1001234567890": { requireMention: false }, // 在此群组中始终响应 }, }, }, }

重要：

设置channels.telegram.groups会创建一个允许列表只有列出的群组（或"*"）会被接受。 论坛话题继承其父群组配置（allowFrom、requireMention、skills、prompts），除非你在channels.telegram.groups.<groupId.topics.<topicId下添加每话题覆盖。 要允许所有群组并始终响应：

{ channels: { telegram: { groups: { "*": { requireMention: false }, // 所有群组，始终响应 }, }, }, }

要保持所有群组仅提及响应（默认行为）：

{ channels: { telegram: { groups: { "*": { requireMention: true }, // 或完全省略 groups }, }, }, }

通过命令（会话级别）

在群组中发送：

• /activation always响应所有消息
• /activation mention需要提及（默认）

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

获取群组聊天 ID

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

提示：要获取你自己的用户 ID，私信机器人，它会回复你的用户 ID（配对消息），或者在命令启用后使用/whoami。

隐私注意：@userinfobot是第三方机器人。如果你更倾向于其他方式，将机器人添加到群组，发送一条消息，然后使用openclaw logs --follow读取chat.id，或使用 Bot APIgetUpdates。

配置写入

默认情况下，Telegram 允许写入由渠道事件或/config set|unset触发的配置更新。 这发生在以下情况：

• 群组升级为超级群组，Telegram 发出migratetochat_id（聊天 ID 更改）。OpenClaw 可以自动迁移channels.telegram.groups。
• 你在 Telegram 聊天中运行/config set或/config unset（需要commands.config: true）。

禁用方式：

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

话题（论坛超级群组）

Telegram 论坛话题在每条消息中包含messagethreadid。OpenClaw：

• 将:topic:<threadId附加到 Telegram 群组会话键，使每个话题隔离。
• 发送输入指示器和回复时带上messagethreadid，使响应保持在话题内。
• 通用话题（线程 id1）是特殊的：消息发送省略messagethreadid（Telegram 会拒绝），但输入指示器仍然包含它。
• 在模板上下文中暴露MessageThreadId+IsForum用于路由/模板。
• 话题特定配置可在channels.telegram.groups.<chatId.topics.<threadId下设置（skills、允许列表、自动回复、系统提示、禁用）。
• 话题配置继承群组设置（requireMention、允许列表、skills、提示、enabled），除非每话题覆盖。

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

内联按钮

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

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

对于每账户配置：

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

作用域：

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

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

发送按钮

使用带buttons参数的消息工具：

{ action: "send", channel: "telegram", to: "123456789", message: "选择一个选项：", buttons: [ [ { text: "是", callbackdata: "yes" }, { text: "否", callbackdata: "no" }, ], [{ text: "取消", 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 私信使用的默认 token 交换。详情：配对
• channels.telegram.allowFrom接受数字用户 ID（推荐）或@username条目。这不是机器人用户名；使用人类发送者的 ID。向导接受@username并在可能时将其解析为数字 ID。

查找你的 Telegram 用户 ID

更安全（无第三方机器人）：

1. 启动 Gateway 网关并私信你的机器人。
2. 运行openclaw logs --follow并查找from.id。

备选（官方 Bot API）：

1. 私信你的机器人。

2. 使用你的机器人 token 获取更新并读取message.from.id：

   curl "https://api.telegram.org/bot<bot_token/getUpdates"

第三方（隐私性较低）：

• 私信@userinfobot或@getidsbot并使用返回的用户 id。

群组访问

两个独立的控制：允许哪些群组（通过channels.telegram.groups的群组允许列表）：

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

允许哪些发送者（通过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 通过标签支持可选的线程回复：

• replytocurrent— 回复触发消息。
• reply_to:<id— 回复特定消息 id。

通过channels.telegram.replyToMode控制：

• first（默认）、all、off。

音频消息（语音 vs 文件）

Telegram 区分语音备忘录（圆形气泡）和音频文件（元数据卡片）。 OpenClaw 默认使用音频文件以保持向后兼容性。 要在智能体回复中强制使用语音备忘录气泡，在回复中的任何位置包含此标签：

• audioasvoice— 将音频作为语音备忘录而不是文件发送。

该标签会从发送的文本中去除。其他渠道会忽略此标签。 对于消息工具发送，设置asVoice: true并配合兼容语音的音频mediaURL（当存在 media 时message是可选的）：

{ 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 调用。

工作原理：

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

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

缓存条目格式：

{ "fileId": "CAACAgIAAxkBAAI...", "fileUniqueId": "AgADBAADb6cxG2Y", "emoji": "👋", "setName": "CoolCats", "description": "一只卡通猫热情地挥手", "cachedAt": "2026-01-15T10:30:00.000Z" }

优点：

• 通过避免对相同贴纸重复调用视觉 API 来降低 API 成本
• 缓存贴纸响应更快（无视觉处理延迟）
• 基于缓存描述启用贴纸搜索功能

缓存在接收贴纸时自动填充。无需手动缓存管理。

发送贴纸

智能体可以使用sticker和sticker-search动作发送和搜索贴纸。这些默认禁用，必须在配置中启用：

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

发送贴纸：

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

参数：

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

搜索贴纸：

智能体可以按描述、表情符号或集合名称搜索缓存的贴纸：

{ action: "sticker-search", channel: "telegram", query: "猫 挥手", limit: 5, }

返回缓存中匹配的贴纸：

{ ok: true, count: 2, stickers: [ { fileId: "CAACAgIAAxkBAAI...", emoji: "👋", description: "一只卡通猫热情地挥手", setName: "CoolCats", }, ], }

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

带线程的示例：

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

流式传输（草稿）

Telegram 可以在智能体生成响应时流式传输草稿气泡。 OpenClaw 使用 Bot APIsendMessageDraft（不是真实消息），然后将最终回复作为普通消息发送。 要求（Telegram Bot API 9.3+）：

• 启用话题的私聊（机器人的论坛话题模式）。
• 入站消息必须包含messagethreadid（私有话题线程）。
• 群组/超级群组/频道的流式传输被忽略。

配置：

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

注意：草稿流式传输与分块流式传输（渠道消息）不同。 分块流式传输默认关闭，如果你想要早期 Telegram 消息而不是草稿更新，需要channels.telegram.blockStreaming: true。 推理流（仅限 Telegram）：

• /reasoning stream在回复生成时将推理流式传输到草稿气泡中，然后发送不带推理的最终答案。
• 如果channels.telegram.streamMode为off，推理流被禁用。 

重试策略

出站 Telegram API 调用在遇到临时网络/429 错误时会以指数退避和抖动进行重试。通过channels.telegram.retry配置。

智能体工具（消息 + 反应）

• 工具：telegram，使用sendMessage动作（to、content，可选mediaUrl、replyToMessageId、messageThreadId）。
• 工具：telegram，使用react动作（chatId、messageId、emoji）。
• 工具：telegram，使用deleteMessage动作（chatId、messageId）。
• 反应移除语义：参见/tools/reactions。
• 工具门控：channels.telegram.actions.reactions、channels.telegram.actions.sendMessage、channels.telegram.actions.deleteMessage（默认：启用），以及channels.telegram.actions.sticker（默认：禁用）。

反应通知

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

1. 从 Telegram API 接收message_reaction更新
2. 将其转换为系统事件，格式为："Telegram reaction added: {emoji} by {user} on msg {id}"
3. 使用与常规消息相同的会话键将系统事件加入队列
4. 当该对话中的下一条消息到达时，系统事件被排出并前置到智能体的上下文中

智能体将反应视为对话历史中的系统通知，而不是消息元数据。

配置：

• channels.telegram.reactionNotifications：控制哪些反应触发通知
• "off"— 忽略所有反应
• "own"— 当用户对机器人消息做出反应时通知（尽力而为；内存中）（默认）
• "all"— 通知所有反应
• channels.telegram.reactionLevel：控制智能体的反应能力
• "off"— 智能体不能对消息做出反应
• "ack"— 机器人发送确认反应（处理时显示 👀）（默认）
• "minimal"— 智能体可以少量反应（指导：每 5-10 次交换 1 次）
• "extensive"— 智能体可以在适当时自由反应

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

{ channels: { telegram: { reactionNotifications: "all", // 查看所有反应 reactionLevel: "minimal", // 智能体可以少量反应 }, }, }

要求：

• Telegram 机器人必须在allowed_updates中明确请求message_reaction（由 OpenClaw 自动配置）
• 对于 webhook 模式，反应包含在 webhookallowed_updates中
• 对于轮询模式，反应包含在getUpdatesallowed_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→Disable（然后从群组中移除并重新添加机器人）
• openclaw channels status在配置期望未提及群组消息时显示警告。
• openclaw channels status --probe可以额外检查显式数字群组 ID 的成员资格（它无法审计通配符"*"规则）。
• 快速测试：/activation always（仅会话级别；使用配置以持久化）

机器人完全看不到群组消息：

• 如果设置了channels.telegram.groups，群组必须被列出或使用"*"
• 在 @BotFather 中检查隐私设置 →“Group Privacy”应为OFF
• 验证机器人确实是成员（不仅仅是没有读取权限的管理员）
• 检查 Gateway 网关日志：openclaw logs --follow（查找”skipping group message”）

机器人响应提及但不响应/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 上运行 Gateway 网关。

机器人启动后静默停止响应（或日志显示HttpError: Network request ... failed）：

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

完整配置：配置提供商选项：

• channels.telegram.enabled：启用/禁用渠道启动。
• channels.telegram.botToken：机器人 token（BotFather）。
• channels.telegram.tokenFile：从文件路径读取 token。
• channels.telegram.dmPolicy：pairing | allowlist | open | disabled（默认：pairing）。
• channels.telegram.allowFrom：私信允许列表（id/用户名）。open需要"*"。
• channels.telegram.groupPolicy：open | allowlist | disabled（默认：allowlist）。
• channels.telegram.groupAllowFrom：群组发送者允许列表（id/用户名）。
• channels.telegram.groups：每群组默认值 + 允许列表（使用"*"作为全局默认值）。
• channels.telegram.groups.<id.requireMention：提及门控默认值。
• channels.telegram.groups.<id.skills：skill 过滤器（省略 = 所有 skills，空 = 无）。
• channels.telegram.groups.<id.allowFrom：每群组发送者允许列表覆盖。
• channels.telegram.groups.<id.systemPrompt：群组的额外系统提示。
• channels.telegram.groups.<id.enabled：为false时禁用群组。
• channels.telegram.groups.<id.topics.<threadId.*：每话题覆盖（与群组相同的字段）。
• channels.telegram.groups.<id.topics.<threadId.requireMention：每话题提及门控覆盖。
• channels.telegram.capabilities.inlineButtons：off | dm | group | all | allowlist（默认：allowlist）。
• channels.telegram.accounts.<account.capabilities.inlineButtons：每账户覆盖。
• channels.telegram.replyToMode：off | first | all（默认：off）。
• channels.telegram.textChunkLimit：出站分块大小（字符）。
• channels.telegram.chunkMode：length（默认）或newline在长度分块之前按空行（段落边界）分割。
• channels.telegram.linkPreview：切换出站消息的链接预览（默认：true）。
• channels.telegram.streamMode：off | partial | block（草稿流式传输）。
• channels.telegram.mediaMaxMb：入站/出站媒体上限（MB）。
• channels.telegram.retry：出站 Telegram API 调用的重试策略（attempts、minDelayMs、maxDelayMs、jitter）。
• channels.telegram.network.autoSelectFamily：覆盖 Node autoSelectFamily（true=启用，false=禁用）。在 Node 22 上默认禁用以避免 Happy Eyeballs 超时。
• channels.telegram.proxy：Bot API 调用的代理 URL（SOCKS/HTTP）。
• channels.telegram.webhookUrl：启用 webhook 模式（需要channels.telegram.webhookSecret）。
• channels.telegram.webhookSecret：webhook 密钥（设置 webhookUrl 时必需）。
• channels.telegram.webhookPath：本地 webhook 路径（默认/telegram-webhook）。
• channels.telegram.actions.reactions：门控 Telegram 工具反应。
• channels.telegram.actions.sendMessage：门控 Telegram 工具消息发送。
• channels.telegram.actions.deleteMessage：门控 Telegram 工具消息删除。
• channels.telegram.actions.sticker：门控 Telegram 贴纸动作 — 发送和搜索（默认：false）。
• channels.telegram.reactionNotifications：off | own | all— 控制哪些反应触发系统事件（未设置时默认：own）。
• channels.telegram.reactionLevel：off | ack | minimal | extensive— 控制智能体的反应能力（未设置时默认：minimal）。

相关全局选项：

• agents.list[].groupChat.mentionPatterns（提及门控模式）。
• messages.groupChat.mentionPatterns（全局回退）。
• commands.native（默认为"auto"→ Telegram/Discord 开启，Slack 关闭）、commands.text、commands.useAccessGroups（命令行为）。使用channels.telegram.commands.native覆盖。
• messages.responsePrefix、messages.ackReaction、messages.ackReactionScope、messages.removeAckAfterReply。