本页内容
本页内容
主流消息传递
Telegram
此页面将 Telegram 机器人连接到 OpenClaw 并设置允许向其发送消息的人员。
Telegram 已为机器人 DM 和通过 grammY 的群组做好了生产准备。长轮询是默认传输。 Webhook 模式是可选的。
每页涵盖的内容
- Telegram setup — 安装机器人,设置令牌,批准第一个 DM,并将机器人添加到组中。
- 电报访问控制 — DM 策略、组白名单、提及门控和每聊天工具策略。
- 电报消息行为 — 运行时模型、流预览、本机命令、回复标签和发送限制。
- Telegram 线程和会话 — 论坛主题会话密钥、每个主题代理和 ACP 绑定。
- Telegram 丰富消息和批准 — 机器人 API 10.3 丰富消息、内联按钮、消息操作和执行批准。
- 电报媒体和附件 — 相册、语音和视频笔记、位置、场地和贴纸。
- 电报事件和操作 — 反应通知、配置写入和错误回复策略。
- Telegram 传输 — 长轮询和 webhook 模式进行比较。
- Telegram Control UI Mini App — 用
/controlui打开 Telegram 内的 Control UI。 - Telegram 故障排除 — 静默组、丢失命令、拒绝令牌和不稳定的轮询。
各部分移动的地方
先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /channels/telegram#troubleshooting)仍然可以解析。每个条目都指向现在保存内容的页面。
- 快速设置
- 电报侧设置
- 控制 UI 迷你 App
- 访问控制和激活
- 群组机器人身份
- 查找您的 Telegram 用户 ID
- 运行时行为
- 功能参考
- [设备配对命令(
device-pair插件)](</channels/telegram/messaging#device-pairing-commands-(device-pair-plugin)>) - 相册
- 音频消息
- 视频留言
- 地点和场地
- 贴纸
- 错误回复控件
- 故障排除
- 设备配对命令(
device-pair插件) - 在BotFather中创建机器人令牌
- 配置令牌和DM策略
- 验证通道
- 批准您的第一个 DM
- 将机器人添加到群组
- 隐私模式和组可见性
- 组权限
- H有用的BotFather开关
- DM 政策
- 组策略和允许列表
- 提及行为
- 直播预览(消息编辑)
- 丰富的消息格式
- 原生命令和自定义命令
- 内联按钮
- 代理和自动化的电报消息操作
- 回复线程标签
- 论坛主题和线程行为
- 相册、音频、视频和贴纸
- 反应通知
- 确认反应
- Config 从 Telegram 事件和命令写入
- 长轮询与 webhook
- 限制和 CLI 目标
- Telegram中的Exec批准
- 机器人不回复非提及群组消息
- Bot根本看不到群组消息
- 命令部分工作或根本不工作
- Startup 报告未授权令牌
- 轮询或网络不稳定
配置参考
主要参考:配置参考 - Telegram。
openclaw doctor --fix 从以前的配置范围中删除了已停用的调整设置(timeoutSeconds、mediaGroupFlushMs、pollingStallThresholdMs、retry 和 errorCooldownMs)。帐户名称和特定于发件人的工具策略密钥将被保留,即使它们与已停用的设置名称匹配也是如此。
高信号 Telegram 字段
- startup/auth:
enabled、botToken、tokenFile(必须是常规文件;符号链接被拒绝)、accounts.* - 访问控制:
dmPolicy,allowFrom,direct.*.tools,direct.*.toolsBySender,groupPolicy,groupAllowFrom,groups,groups.*.topics.*,顶层bindings[](type: "acp") - 群组介绍:
joinIntro、accounts.*.joinIntro(默认:true) - topic 默认:
groups.<chatId>.topics."*"适用于不匹配的论坛主题;确切的主题 ID 会覆盖它 - 执行审批:
execApprovals,accounts.*.execApprovals - command/menu:
commands.native,commands.nativeSkills,customCommands - threading/replies:
replyToMode,threadBindings - 流式传输:
streaming(模式off | partial | block | progress),streaming.preview.toolProgress - formatting/delivery:
textChunkLimit,streaming.chunkMode,richMessages,markdown.tables(off | bullets | code | block),linkPreview,responsePrefix - media/network:
mediaMaxMb,network.autoSelectFamily,network.dangerouslyAllowPrivateNetwork,proxy - 自定义 API 根路径:
apiRoot(仅限 Bot API 根路径;不要包含/bot<TOKEN>),trustedLocalFileRoots(自托管 Bot API 的绝对file_path根路径) - webhook:
webhookUrl、webhookSecret、webhookPath、webhookCertPath、legacyWebhook(可选显式转发端点;省略或false仅使用网关端口) - actions/capabilities:
capabilities.inlineButtons,actions.sendMessage|editMessage|deleteMessage|reactions|sticker|createForumTopic|editForumTopic - 反应:
reactionNotifications,reactionLevel - 错误:
errorPolicy,silentErrorReplies - writes/history:
configWrites,historyLimit,dmHistoryLimit,dms.*.historyLimit
mediaMaxMb 接受小数限制。超大警告使用二进制单位报告有效限制,因此 mediaMaxMb: 0.5 显示为 512KB。
多代理账户所有权
每个 Telegram 帐户都需要一个可解析的代理所有者。要将默认帐户绑定到 main,请将此条目添加到顶级 bindings 数组中:
使用为您的网关配置的代理和帐户 ID。失踪的所有者会通过频道状态中的确切绑定补救措施来阻止该帐户;其他帐户继续运行。添加绑定并重新启动网关。
升级旧版 agents.list 配置时,Doctor 在保存显式所有权之前会在绑定中保留以前的隐式帐户所有者。 Doctor 需要原始名册,并且从不提倡更窄的对话路径来实现帐户范围的所有权。缺少历史所有权需要运营商做出选择;医生报告要添加的确切绑定,而无需更改现有路线。请参阅 迁移修复 。
相关内容
本页有帮助吗?