本页内容
本页内容
主流消息传递
Telegram 事件和操作
操作 Telegram 表面:反应唤醒、配置写入以及机器人在出现故障时所说的内容。
事件和操作
反应通知
Telegram 的反应会作为 message_reaction 更新到达,独立于消息载荷。当启用时,OpenClaw 会将其排入系统事件,例如 Telegram reaction added: 👍 by Alice (@alice) on msg 42。
channels.telegram.reactionNotifications:off | own | all(默认:own)channels.telegram.reactionLevel:off | ack | minimal | extensive(默认:minimal)
own 表示仅用户对 bot 发送消息的反应(通过已发送消息缓存尽力实现)。反应事件仍会遵守 Telegram 访问控制(dmPolicy、allowFrom、groupPolicy、groupAllowFrom);未授权发送者会被丢弃。
Telegram 不提供反应更新中的主题元数据。普通的非论坛群组仍处于聊天范围内。论坛和频道私信反应从 OpenClaw 的有界消息缓存(由帐户、聊天和消息 ID 键入)中恢复原始主题,因此主题配置、主题代理和对话绑定仍然适用。如果缓存的主题丢失或属于错误的范围,OpenClaw 会跳过反应通知并记录警告,而不是退回到常规或基本聊天。
allowed_updates 对于 polling/webhook 自动包含 message_reaction。
来自 Telegram 事件和命令的配置写入
默认情况下启用通道配置写入 (configWrites !== false)。 Telegram-触发的写入包括组迁移事件(migrate_to_chat_id,更新channels.telegram.groups)和/config set / /config unset(需要命令启用)。
禁用:
错误回复控制
当代理遇到投递或提供方错误时,错误策略会控制错误消息是否会发送到 Telegram 聊天中:
| 键 | 值 | 默认值 | 描述 |
|---|---|---|---|
channels.telegram.errorPolicy |
always, once, silent |
always |
always 会将每条错误消息都发送到聊天中。once 会在内置冷却窗口内,每个唯一的错误消息只发送一次。silent 则永远不会将错误消息发送到聊天中。 |
支持按账号、按群组和按主题覆盖配置(继承规则与其他 Telegram 配置键相同)。