消息行为
了解 OpenClaw 工作时 Slack 会话的样子,以及命令如何到达它。
Ack 回应¶
当 OpenClaw 正在处理入站消息时,ackReaction 会发送一个确认 emoji。ackReactionScope 决定该 emoji 实际发送的_时机_。
在工作过程中,确认回应保持静态。当 messages.statusReactions.enabled: true 时,实际失败会短暂显示一个错误回应,然后恢复确认回应。工具调用、思考、压缩和长时间运行的工具不会循环或累积回应,成功完成也不会闪现单独的成功 emoji。
Emoji(ackReaction)¶
解析顺序:
channels.slack.accounts.<accountId>.ackReactionchannels.slack.ackReactionmessages.ackReaction- 代理身份 emoji 回退(
agents.entries.*.identity.emoji,否则为"eyes"/ 👀)
备注:
- Slack 期望短代码(例如
"eyes")。 - 使用
""可为某个 Slack 账号或全局禁用该回应。
作用域(messages.ackReactionScope)¶
Slack 提供方从 messages.ackReactionScope 读取作用域(默认 "group-mentions")。没有 Slack 账号级或 Slack 频道级的覆盖设置;该值是网关全局的。
取值:
"all":在私信和群组中回应,包括环境性房间事件。"direct":仅在私信中回应。"group-all":对每条群组消息回应,但环境性房间事件除外(不含私信)。"group-mentions"(默认):在群组中回应,但仅在机器人被提及时(或群组中已选择加入的可提及对象被提及时)。私信被排除。"off"/"none":从不回应。
Note
默认作用域("group-mentions")不会在私信或环境性房间事件中触发确认回应。若要在入站 Slack 私信和安静的房间事件中看到配置的 ackReaction(例如 "eyes"),请将 messages.ackReactionScope 设置为 "all"。作用域更改会在下一条消息生效,无需重新连接 Slack。
回复线程、历史记录限制、文本块限制、流式传输、输入回应和 unfurl 设置会在下一条被接收的消息上生效,无需重新连接 Slack。进行中的回复会保留其开始时的设置。账号级覆盖设置也遵循相同行为。
文本流式传输¶
channels.slack.streaming 控制实时预览行为:
off:禁用实时预览流式传输。partial:用最新的部分输出替换预览文本。设置此值可恢复 2026.8.1 之前的默认行为,即progress成为默认值之前(#122552)。block:追加分块预览更新。progress(默认):在回复线程中使用 Slack 支持的原生任务卡片显示结构化进度,并回退到 Block Kit 会话卡片。在回复线程之外,默认只保留最终答案。streaming.progress.toolProgress:progress模式默认保持安静(false)。设为true可在原生卡片上为每次工具调用添加一个任务行,或在 Block Kit 卡片上添加工具活动、计划检查清单以及工具/文件/时间总计。已完成的 Block Kit 卡片仅保留文件差异总计。streaming.preview.toolProgress控制partial和block模式下的工具预览(默认:true)。streaming.preview.commandText/streaming.progress.commandText:status保留紧凑的工具进度行,同时隐藏原始命令/执行文本(默认);设为raw可选择显示命令文本。
在隐藏原始命令/执行文本的同时显示工具日志:
{
"channels": {
"slack": {
"streaming": {
"mode": "progress",
"progress": {
"toolProgress": true,
"commandText": "status"
}
}
}
}
}
当 channels.slack.streaming.mode 为 partial 时,channels.slack.streaming.nativeTransport 控制 Slack 原生文本流式传输(默认:true)。
在 progress 模式下,没有回复线程目标的轮次不会发布预览或进度消息,除非你明确选择某种展示方式。这包括有效 replyToMode: "off" 的频道回复和普通顶级私信。这些轮次会使用一个临时的输入回应,并一次性交付最终答案;失败仍使用正常的错误交付方式。任何显式的 streaming.progress 设置都会让顶级轮次进入预览,包括 commentary: true 或自定义 label。唯一的例外是 nativeTaskCards: true,它只影响线程。空的 streaming.progress 对象或仅设置 streaming.mode: "progress" 会保持安静的顶级默认行为。此规则适用于合并根设置和账号覆盖设置后的有效设置。off、partial 和 block 模式保留其现有行为。
对于线程化轮次,包括 Agent View、Assistant View 和 Slack 管理的线程,Slack 原生代理卡片仍是默认:整个轮次是一条流式消息,将叙述与实时计划/任务卡片交错呈现,并在同一条消息中以助手的回答收尾。当代理发布计划时,卡片会显示编写的计划步骤,否则显示一行稳定的工作摘要;审批请求会获得自己的行。中间的工具失败和非零命令退出默认被隐藏,因此成功的回答不会累积失败或 Recovered: … 行。设置 progress.toolProgress: true 后,它还会显示每个工具的任务行(包括工具失败),与任何编写的计划并列。常规更新以一秒为间隔合并;审批、可见失败和完成会绕过该延迟。卡片只会在轮次真正开始工作后才出现——即工具或计划活动在短暂延迟后仍在运行——因此一个简单问题会在没有卡片的情况下得到回答。
如果没有编写好的或显式的标题行,原生摘要行会以 已完成 或 失败 结束。
将 channels.slack.streaming.progress.nativeTaskCards 设为 false 可回退到 Block Kit 会话卡片。默认情况下,这条独立消息会显示评论和文本,包括斜体叙述和推理,以及可操作的审批请求。只有显式配置的进度 label 会作为纯标题出现。已完成的卡片在可用时会保留 Open in OpenClaw 或 Open work session 链接。在任一模式下,卡片都不会添加 emoji、粗体文本或状态标题,除非轮次失败时会出现一行纯文本“失败”。卡片只会在有内容可展示时才会发布,因此只有工具活动而没有评论的轮次默认不会显示卡片。如果一张正在工作中或已成功的卡片的最后可见行消失(例如已解决的审批),该卡片会被删除,而不是保留过时的行。失败的轮次会保留标记为“失败”的卡片,即使没有错误回复;没有回复的失败轮次会发布一张纯文本“失败”卡片,即使工作期间没有出现过卡片。
Set progress.toolProgress: true 为详细的 Block Kit 卡片:它会添加最近工具活动、带已完成步骤计数的计划清单、中间错误和恢复行,以及工作期间的工具/文件/时间总计。已完成的详细卡片仅在页脚保留文件差异总计。
将 channels.slack.streaming.progress.style 设置为 "compact",以使用一个纯文本进度草稿,而不是任一卡片界面。当 style 未设置时,显式设置 progress.toolProgress: false 也会选择紧凑样式。设置 style: "card" 可在 toolProgress: false 时保留卡片,或为顶层轮次选择 Block Kit 卡片。评论以斜体文本显示,已生成的推理和审批请求仍然可见。终端任务错误仍使用常规错误投递。最终响应作为新消息发布,然后在 Slack 确认投递后删除临时预览。被人工回复取代的旧预览会随之清理;持久消息和视频保留在对话中。
对于流式前言,Slack 会等待第一个完整前言后再创建消息,因此其通知包含完整想法,而不是单个 Token。一旦该消息存在,后续前言可以以编辑方式流式传输,而不会再次通知。
{
channels: {
slack: {
streaming: {
mode: "progress",
progress: {
style: "compact",
label: false,
commentary: true,
toolProgress: false,
},
},
},
},
}
紧凑进度始终使用常规最终投递,包括媒体和错误。其他草稿模式在回复无法安全替换草稿时使用常规投递,包括超大文本、拆分块负载、自定义出站身份或编辑失败。
两个界面都会通过 在 OpenClaw 中打开 链接会话,但仅当该链接可以工作时:必须设置 gateway.publicOrigin(外部可达的 Gateway 源),并且 Control UI 不得通过 gateway.controlUi.enabled: false 禁用。未设置 publicOrigin 的安装环境——即无法从 Slack 访问 OpenClaw——不会获得链接,而不是获得一个失效链接。如果 Control UI 在路径前缀下提供服务,还需设置 gateway.controlUi.basePath。
当某个轮次生成一个可见工作会话时,完成的卡片会改为通过 打开工作会话 链接到该子会话。对于多个可见工作会话,它会按接受顺序显示最多五个链接,使用它们的标签或编号的 打开工作会话 链接;隐藏的子代理不会替换对话链接。
- 必须存在回复线程,原生文本流式传输和 Slack 会话状态才会出现。线程选择仍遵循
replyToMode。 - 频道、群聊和顶层 DM 根在显式选择时使用草稿预览。没有回复线程的默认
progress轮次仅使用临时输入反应。 - 顶层 Slack DM 默认保持在线程外;Agent View 和 Assistant View 保留其基于线程的原生进度。
- 自定义出站用户名/图标设置会保持可移植预览启用。OpenClaw 保持预览或会话卡片为应用创建,并单独投递自定义的最终内容。Slack 不允许删除冒充消息。
- 媒体和非文本负载回退到常规投递。
- 在紧凑进度之外,媒体/错误最终内容会取消待处理的预览编辑;符合条件的文本/块最终内容只有在能够就地编辑预览时才会刷新。
- 原生流式回复会等待 Slack 的确认,然后才将投递标记为成功。每个完整的回复块都会单独刷新,包括短块;常规进度更新仍会合并。稍后进度卡片最终化失败不会丢弃已确认的回复。
- 显式 HTTP 429 速率限制拒绝默认最多重试两次,在 Slack 的
Retry-After延迟之后。这也适用于普通消息和上传完成;丢失的响应和服务器错误不会被重放。 - 明确的接收者或范围拒绝会为缓冲文本回退到常规投递。模糊的流式失败(例如丢失的响应)会报告失败,而不会重放未确认的文本,因为 Slack 可能已经接受了它。后续负载使用常规投递。
使用草稿预览而不是 Slack 原生文本流式传输:
保持 Slack 原生进度任务卡片对线程轮次启用:
{
channels: {
slack: {
streaming: {
mode: "progress",
progress: {
nativeTaskCards: true,
},
},
},
},
}
旧版键:
channels.slack.streamMode(replace | status_final | append)是channels.slack.streaming.mode的旧版别名。- 布尔值
channels.slack.streaming是channels.slack.streaming.mode和channels.slack.streaming.nativeTransport的旧版别名。 - 顶层
channels.slack.chunkMode和channels.slack.nativeStreaming是channels.slack.streaming.chunkMode和channels.slack.streaming.nativeTransport的旧版别名。 - 旧版别名不会在运行时读取;运行
openclaw doctor --fix可将持久化的 Slack 流式配置重写为规范键。
输入反应回退¶
typingReaction 会在 OpenClaw 处理回复时,向传入的 Slack 消息添加一个临时反应,并在运行结束时将其移除。这在非线程回复之外最有用,因为线程回复使用 Slack 的 processing 会话状态。
解析顺序:
channels.slack.accounts.<accountId>.typingReactionchannels.slack.typingReaction- 对于没有回复线程或显式选择进度呈现的默认
progress轮次,使用"hourglass_flowing_sand";否则不使用输入反应。
说明:
- Slack 期望使用短代码(例如
"hourglass_flowing_sand")。 - 使用
""可禁用输入反应,包括静默顶层轮次的默认值。 - 该反应是尽力而为的,并在回复或失败路径完成后自动尝试清理。
命令和斜杠行为¶
斜杠命令在 Slack 中显示为单个已配置的命令或多个原生命令。配置 channels.slack.slashCommand 以更改命令默认值:
enabled: falsename: "openclaw"sessionPrefix: "slack:slash"ephemeral: true
原生命令需要在你的 Slack 应用中设置额外的清单设置,并且改为在全局配置中使用 channels.slack.commands.native: true 或 commands.native: true 启用。
- Slack 的原生命令自动模式为关闭,因此
commands.native: "auto"不会启用 Slack 原生命令。
原生参数菜单按以下优先级顺序渲染为其中一种:
- 3-5 个足够短的选项:溢出("...")菜单
- 超过 100 个选项,且支持异步选项过滤:外部选择
- 1-2 个选项,或任何编码值对于选择框过长的选项:按钮块
- 其他情况(6-100 个选项,或没有异步过滤时超过 100 个):静态选择菜单,每个菜单按 100 个选项分块
斜杠会话使用隔离的键,例如 agent:<agentId>:slack:slash:<userId>,并且仍使用 CommandTargetSessionKey 将命令执行路由到目标会话。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw