本页内容

本页内容

主流消息传递

Telegram

此页面将 Telegram 机器人连接到 OpenClaw 并设置允许向其发送消息的人员。

Telegram 已为机器人 DM 和通过 grammY 的群组做好了生产准备。长轮询是默认传输。 Webhook 模式是可选的。

每页涵盖的内容

各部分移动的地方

先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /channels/telegram#troubleshooting)仍然可以解析。每个条目都指向现在保存内容的页面。

配置参考

主要参考:配置参考 - 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 数组中:

json5
{ agentId: "main", match: { channel: "telegram", accountId: "default" } }

使用为您的网关配置的代理和帐户 ID。失踪的所有者会通过频道状态中的确切绑定补救措施来阻止该帐户;其他帐户继续运行。添加绑定并重新启动网关。

升级旧版 agents.list 配置时,Doctor 在保存显式所有权之前会在绑定中保留以前的隐式帐户所有者。 Doctor 需要原始名册,并且从不提倡更窄的对话路径来实现帐户范围的所有权。缺少历史所有权需要运营商做出选择;医生报告要添加的确切绑定,而无需更改现有路线。请参阅 迁移修复 。

相关内容

本页有帮助吗?