线程与会话
论坛主题如何映射到会话、代理和 ACP 绑定。
论坛主题与会话¶
论坛主题与线程行为
论坛超级群组:主题会话键会追加 :topic:<threadId>;回复和正在输入状态都指向该主题线程;主题配置路径为 channels.telegram.groups.<chatId>.topics.<threadId>。
主题 ID 必须为正整数。OpenClaw 会在发出 Telegram 请求之前,拒绝投递目标中的主题 0 和显式线程选项中的主题 0。
常规主题(threadId=1)是一个特例:发送消息时会省略 message_thread_id(Telegram 会以 "thread not found" 拒绝 sendMessage(...thread_id=1)),但正在输入状态动作仍会包含 message_thread_id(经验表明,要让输入指示器显示,必须包含它)。
主题条目会继承群组设置,除非被覆盖(requireMention、requireMentionInBotThreads、allowFrom、skills、systemPrompt、enabled、groupPolicy)。agentId 仅作用于主题,不会从群组默认值继承。topics."*" 为该群组中的每个主题设置默认值;精确的主题 ID 仍然优先于 "*"。
按主题的代理路由:每个主题都可以通过主题配置中的 agentId 路由到不同的代理,从而拥有自己的工作区、记忆和会话:
{
channels: {
telegram: {
groups: {
"-1001234567890": {
topics: {
"1": { agentId: "main" }, // General topic -> main agent
"3": { agentId: "zu" }, // Dev topic -> zu agent
"5": { agentId: "coder" } // Code review -> coder agent
}
}
}
}
}
}
每个主题随后都有自己的会话键,例如 agent:zu:telegram:group:-1001234567890:topic:3。
持久 ACP 主题绑定:论坛主题可以通过顶层类型化绑定(bindings[],其中 type: "acp"、match.channel: "telegram"、peer.kind: "group",以及类似 -1001234567890:topic:42 的带主题限定 ID)固定 ACP harness 会话。目前范围仅限于群组/超级群组中的论坛主题。参见 ACP 代理。
从聊天中生成绑定线程的 ACP 会话:/acp spawn <agent> --thread here|auto 会将当前主题绑定到新的 ACP 会话;后续消息会直接路由到该会话,OpenClaw 会在主题内固定生成确认信息。由 session.threadBindings.spawnSessions 控制(默认:true)。
启动时会先等待已存储的线程绑定,然后才接受更新。关闭时会先处理完已接受的绑定变更,然后再由替代机器人重新加载。内置的 Telegram 处理器通过共享的 SQLite worker 持久化绑定,因此存储不会阻塞消息处理。已弃用的同步 Plugin SDK touch 和生命周期 setter 会在同一绑定所有者上保持其即时行为,直到下一个 SDK 主版本。
无论全局、针对 Telegram、还是针对单个账户禁用 threadBindings.enabled,普通 Telegram 消息仍然可以正常工作。
模板上下文会暴露 MessageThreadId 和 IsForum。带有 message_thread_id 的 DM 聊天会保留回复元数据,但只有在 Telegram getMe 返回 has_topics_enabled: true 时,才会使用感知线程的会话键。
已退役的 dm.threadReplies 和 direct.*.threadReplies 覆盖项已被移除;BotFather 的线程模式是唯一事实来源。运行 openclaw doctor --fix 可移除过期的配置键。
机器人创建的论坛主题¶
在群组或主题上设置 requireMentionInBotThreads,可仅覆盖由接收机器人创建的论坛主题中的提及门控。false 允许未提及的消息在该处开始对话;true 则要求提及,包括回复机器人的消息。省略该设置会保留现有行为。主题设置优先于所选群组设置。相同的路径也可在 channels.telegram.accounts.<accountId>.groups 下使用。
OpenClaw 会通过观察到的 forum_topic_created 服务消息,或机器人成功创建主题的操作来记录创建者。所有权特定于该机器人:其他机器人的主题或人类创建的主题会保持其常规提及策略。在主题中回复并不会让机器人成为其创建者。
主题所有权会与主题名称一起保存在现有缓存中,该缓存最多保留 2,048 个最近使用的主题。在 OpenClaw 观察到之前创建的主题,以及被逐出的缓存条目,都会保持常规提及策略。Telegram 不提供主题所有者查询来恢复这些信息。此设置不会改变 DM 主题、授权、群组静默策略或可见回复策略。配置和 Telegram 可见性要求请参阅提及行为。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw