跳转至

线程与会话

Slack 对话如何映射到 OpenClaw 会话,以及回复落在哪里。

线程、会话和回复标签

  • 私信路由为 direct;频道路由为 channel;MPIM 路由为 group。
  • Slack 路由绑定接受原始对端 ID,以及诸如 channel:C12345678、user:U12345678 和 <@U12345678> 之类的 Slack 目标形式。
  • 在默认的 session.dmScope=main 下,普通 Slack 私信会合并到 agent 的主会话中。Agent View 根消息和现有的 Assistant View 线程以 :thread:<threadTs> 会话形式保持隔离;参见 Agent View 私信。
  • 频道会话:agent:<agentId>:slack:channel:<channelId>。
  • 普通的频道顶层消息停留在逐频道会话上,即使 replyToMode 不是 off。
  • Slack 频道、MPIM、Agent View 和 Assistant View 的线程回复使用父级 Slack thread_ts 作为会话后缀(:thread:<threadTs>)。普通私信的回复线程仍然是基础私信会话上的一种 UI 交互方式。
  • 当某个合格的频道顶层根消息预期会开启一个可见的 Slack 线程时,OpenClaw 会将该根消息植入 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>,这样根消息及其后的线程回复共享同一个 OpenClaw 会话。这适用于 app_mention 事件、显式的 bot 或已配置的提及模式匹配,以及 requireMention: false 且 replyToMode 非 off 的频道。
  • channels.slack.thread.historyScope 默认为 thread;thread.inheritParent 默认为 false。
  • channels.slack.thread.initialHistoryLimit 控制新线程会话启动时获取多少条现有线程消息(默认 20;设为 0 可禁用)。房间线程植入也受 historyLimit 限制。
  • channels.slack.implicitMentions.replyToBot 控制对 bot 自身消息的回复是否绕过提及门控(默认 true)。
  • channels.slack.implicitMentions.threadParticipation 控制在 bot 已回复的线程中后续消息是否绕过提及门控(默认 true)。将其设为 false 可要求这些后续消息中包含新的显式提及。openclaw doctor --fix 会将原先的 channels.slack.thread.requireExplicitMention 键迁移到这个正向的规范标志。
  • 账户级覆盖配置位于 channels.slack.accounts.<id>.implicitMentions;共享默认配置位于 channels.defaults.implicitMentions。
  • requireMentionInBotThreads 覆盖由此 bot 启动的线程中的提及门控:false 允许未被提及的回复;true 则无论隐式回复或参与信号如何都要求提及。可在 Slack 根、账户或频道作用域配置它。省略它则保留上述隐式提及行为。其他人启动的线程保持其正常策略。参见 bot 创建的线程设置。

回复线程控制:

  • channels.slack.channels.<id>.replyToMode:针对 Slack 频道/私密频道消息的逐频道覆盖
  • channels.slack.replyToMode:off|first|all|batched(默认 off)
  • channels.slack.replyToModeByChatType:按 direct|group|channel 区分
  • 私聊的旧版回退:channels.slack.dm.replyToMode

支持手动回复标签:

  • [[reply_to_current]]
  • [[reply_to:<id>]]

对于来自 message 工具的显式 Slack 线程回复,设置 replyBroadcast: true,并配合 action: "send" 以及 threadId 或 replyTo 使用,可要求 Slack 同时将线程回复广播到父频道。这对应 Slack 的 chat.postMessage reply_broadcast 标志,仅支持文本或 Block Kit 发送,不支持媒体上传。

当 message 工具调用在 Slack 线程内运行并指向同一频道时,OpenClaw 通常会根据生效的账户、聊天类型或逐频道 replyToMode 继承当前的 Slack 线程。自动回复以及同频道的 send 或 upload-file 调用使用相同的逐频道覆盖。在 action: "send" 或 action: "upload-file" 上设置 topLevel: true 可强制改为发送新的父频道消息。threadId: null 也被接受,作为相同的顶层退出选项。

Note

replyToMode="off" 会禁用可选的出站 Slack 回复线程,包括显式的 [[reply_to_*]] 标签。Agent View 和 Assistant View 是 Slack 托管的线程化体验,因此无论此设置如何,它们的回复和状态都保留在可见的根消息上。它不会扁平化其他入站 Slack 线程会话。这不同于 Telegram,在 Telegram 中,显式标签在 "off" 模式下仍然生效。Slack 线程会将消息从频道中隐藏,而 Telegram 回复则保持内联可见。

Agent View 私信

Slack Agent View(features.agent_view)是 Slack 为 AI 应用提供的消息体验。Slack 将应用标记为 agent,在应用的 Messages 标签页中,每次在顶层输入框输入的消息都会开启一个新的根消息,由 Slack 自行创建线程;后续消息归属于该根消息的线程内。OpenClaw 将每个根消息视为独立的对话:

  • 每个根消息都会在 session.dmScope 选定的基础会话之上附加 :thread:<rootTs> 后缀,因此即使是在默认的 main 作用域下,根消息也保持隔离。使用 per-channel-peer 时,根消息形如 agent:main:slack:direct:U12345678:thread:1777244748.777299;使用 main 时,形如 agent:main:main:thread:1777244748.777299。
  • 根消息线程内的后续消息停留在该根消息的会话上。新的顶层输入框消息会开启新的会话。
  • 无论 replyToMode 如何,回复和线程状态都保留在可见的根消息上,因为线程由 Slack 管理。
  • Slack 的活动视图实体(app_context)仅以结构化的不可信上下文形式、按 Slack 的相关性顺序到达 agent;没有 app_context 的私信会清除该轮次的实体,而不会复用陈旧的实体。

Slack 从不声明应用使用哪种体验,因此 OpenClaw 会以它看到的第一个信号来认定 Agent View:一个 app_context_changed 事件、一条带有 app_context 的私信,或者成员打开 Messages 标签页时 OpenClaw 发出的无线程 assistant.threads.setSuggestedPrompts 调用。对于 Agent View 应用,Slack 以 ok 或 internal_error 回复该调用;对于 Assistant View 应用,则以 not_agent_app 回复,因此 ok 和 internal_error 都算作证据;传输失败则无法判定,并会在下次打开时重试。一条 thread_ts 等于自身 ts 的私信会被自动识别为 Slack 托管的根消息。在看到这些信号之前,普通私信根消息遵循常规私信路由。

标记是持久的,并以账户、工作区和 Slack 应用 ID 为键,因此在已知应用 ID 后,Agent View 可以在 Gateway 重启后保留。Socket Mode 在启动时从应用令牌读取应用 ID。HTTP 模式在启动后从第一个签名事件学习它,并记录一次 slack app id <id> learned from signed event。Relay 模式没有应用 ID 来源,因此其标记仅存在于运行中的进程中。位于 features.assistant_view 的现有应用会改为保留 Assistant View 线程;另请参阅 其他清单设置。

最近房间历史

已接纳的频道和群组轮次会从 Slack 获取一个最近窗口,包括在 Gateway 重启之后。channels.slack.historyLimit 限定该窗口(默认 50,并以 messages.groupChat.historyLimit 作为回退)。账户覆盖设置适用。自动观察消息窗口上限为 200 条消息;JSON 整数最大值(9007199254740991)会选择 50 条消息的默认值。

对于观察到的 DM 上下文,dmHistoryLimit 和 dms.<userId>.historyLimit 使用默认值 0(禁用),最大为 200 条消息。JSON 整数最大值会选择该禁用默认值,包括针对单个 DM 的覆盖设置。

这些已保存字段还会控制用户轮次中嵌入会话转录的修剪,其中 0 表示不修剪,且现有的驱逐缓冲仍然适用。Doctor 会保留已配置的值;观察消息上限不会施加新的转录轮次上限。 当 requireMention: true 时,不满足已配置提及或隐式提及门槛的消息不会启动代理轮次或自动历史读取。

Slack 仍然是权威来源:编辑、删除、保留策略、令牌作用域和可用性决定检索。没有单独的 OpenClaw 消息归档。 恢复不会重写先前的代理转录。 新的最近窗口遵循活动会话边界;初始线程填充保留其现有的 thread.initialHistoryLimit 行为。当前消息、 防抖源消息和后续消息会被排除在最近窗口之外。 初始线程历史仅使用其现有渲染路径一次。当 thread.historyScope: "channel" 时,最近窗口使用频道时间线, 而初始线程填充保持独立。

线程范围的历史读取仅读取该线程。Slack 按最旧优先返回线程回复,因此自动线程恢复在三页后停止。如果无法到达最近窗口末端,OpenClaw 会记录遗漏,而不是将旧前缀呈现为最近内容。过滤和 Slack 分页限制也可能产生更短的窗口。读取失败会省略自动历史,但不会丢弃目标消息。 最近窗口媒体恢复最多尝试四个图片附件,包括失败的尝试。当前消息和显式回复媒体保留其各自独立的限制。

设置 historyLimit: 0 可禁用自动房间历史,包括初始房间线程历史。显式回复和线程发起者上下文保持独立。 现有的 message(action="read") 工具可以在重启或会话重置后分页浏览较旧的 Slack 消息,具体取决于 Slack 访问权限和保留策略。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw