文档
消息

消息

适用范围

在以下情况使用此页面：

  • 解释入站消息如何成为回复
  • 阐明会话、排队模式或流式传输行为
  • 记录推理可见性和使用影响

此页面将 Moltbot 如何处理入站消息、会话、排队、流式传输和推理可见性联系在一起。

消息流（高级） 

入站消息
  -> 路由/绑定 -> 会话键
  -> 队列（如果运行处于活动状态）
  -> 代理运行（流式传输 + 工具）
  -> 出站回复（通道限制 + 分块）

关键旋钮位于配置中：

  • messages.* 用于前缀、排队和群组行为。
  • agents.defaults.* 用于块流式传输和分块默认值。
  • 通道覆盖（channels.whatsapp.*、channels.telegram.* 等）用于上限和流式传输切换。

有关完整架构，请参阅配置。

入站去重

通道可以在重新连接后重新传递相同的消息。Moltbot 保留一个短期缓存，按通道/帐户/对等方/会话/消息 id 键控，因此重复传递不会触发另一个代理运行。

入站防抖

来自 同一发件人的快速连续消息可以通过 messages.inbound 批处理到单个代理轮次中。防抖的作用域为每个通道 + 对话，并使用最新消息进行回复线程/ID。

配置（全局默认值 + 每通道覆盖）：

{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
        discord: 1500
      }
    }
  }
}

注意：

  • 防抖适用于 仅文本消息；媒体/附件立即刷新。
  • 控制命令绕过防抖，因此它们保持独立。

会话和设备

会话由网关拥有，而不是客户端。

  • 直接聊天折叠到代理主会话键。
  • 群组/通道获得自己的会话键。
  • 会话存储和脚本位于网关主机上。

多个设备/通道可以映射到同一会话，但历史记录不会完全同步回每个客户端。建议：使用一个主设备进行长对话，以避免上下文分歧。控制 UI 和 TUI 始终显示网关支持的会话脚本，因此它们是真相来源。

详细信息：会话管理。

入站主体和历史上下文

Moltbot 将 提示主体与 命令主体分开：

  • Body：发送到代理的提示文本。这可能包括通道信封和可选的历史记录包装器。
  • CommandBody：用于指令/命令解析的原始用户文本。
  • RawBody：CommandBody 的传统别名（为兼容性而保留）。

当通道提供历史记录时，它使用共享包装器：

  • [Chat messages since your last reply - for context]
  • [Current message - respond to this]

对于 非直接聊天（群组/通道/房间），当前消息主体以发件人标签为前缀（与历史记录条目使用的样式相同）。这使实时和排队/历史消息在代理提示中保持一致。

历史缓冲区是 仅待处理：它们包括 未 触发运行的群组消息（例如，提及限制的消息）并 排除已经在会话脚本中的消息。

指令剥离仅适用于 当前消息 部分，因此历史记录保持完整。包装历史的通道应该将 CommandBody（或 RawBody``）设置为原始消息文本，并保持 Body作为组合提示。 历史缓冲区可通过messages.groupChat.historyLimit（全局默认值）和每通道覆盖（如 channels.slack.historyLimit或channels.telegram.accounts..historyLimit）配置（设置为 0` 以禁用）。

排队和后续

如果运行已经处于活动状态，入站消息可以排队、引导到当前运行或为后续轮次收集。

  • 通过 messages.queue（和 messages.queue.byChannel）配置。
  • 模式：interrupt、steer、followup、collect，以及积压变体。

详细信息：排队。

流式传输、分块和批处理

块流式传输在模型生成文本块时发送部分回复。 分块尊重通道文本限制并避免拆分围栏代码。

关键设置：

  • agents.defaults.blockStreamingDefault（on|off，默认关闭）
  • agents.defaults.blockStreamingBreak（text_end|message_end）
  • agents.defaults.blockStreamingChunk（minChars|maxChars|breakPreference）
  • agents.defaults.blockStreamingCoalesce（基于空闲的批处理）
  • agents.defaults.humanDelay（块回复之间的人为暂停）
  • 通道覆盖：*.blockStreaming 和 *.blockStreamingCoalesce（非 Telegram 通道需要显式 *.blockStreaming: true）

详细信息：流式传输 + 分块。

推理可见性和令牌

Moltbot 可以公开或隐藏模型推理：

  • /reasoning on|off|stream 控制可见性。
  • 推理内容在被模型产生时仍然计入令牌使用。
  • Telegram 支持推理流式传输到草稿气泡。

详细信息：思考 + 推理指令和令牌使用。

前缀、线程和回复

出站消息格式化集中在 messages 中：

  • messages.responsePrefix（出站前缀）和 channels.whatsapp.messagePrefix（WhatsApp 入站前缀）
  • 通过 replyToMode 和每通道默认值的回复线程

详细信息：配置 和通道文档。

网关架构形式化验证（安全模型）