ClawCN - OpenClaw 中文版

主题

消息 ​

本页将 OpenClaw 如何处理入站消息、会话、队列、流式传输和推理可见性整合在一起。

消息流(高层视图) ​

Inbound message
  -> routing/bindings -> session key
  -> queue (if a run is active)
  -> agent run (streaming + tools)
  -> outbound replies (channel limits + chunking)

关键配置位于配置文件中:

  • messages.* 用于前缀、队列和群组行为。
  • agents.defaults.* 用于块流式传输和分块默认值。
  • 频道覆盖(channels.whatsapp.*、channels.telegram.* 等)用于限制和流式开关。

完整架构请参见配置。

入站去重 ​

频道可能在重新连接后重新投递相同的消息。OpenClaw 保留一个短期缓存,以频道/账户/对等方/会话/消息 ID 为键,这样重复投递不会触发另一次代理运行。

入站防抖 ​

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

配置(全局默认 + 每频道覆盖):

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

注意:

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

会话和设备 ​

会话由网关拥有,而非客户端。

  • 直接聊天折叠到代理主会话密钥中。
  • 群组/频道获得自己的会话密钥。
  • 会话存储和记录位于网关主机上。

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

详情:会话管理。

入站正文和历史上下文 ​

OpenClaw 将提示正文与命令正文分开:

  • 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.<id>.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)

详情:流式传输 + 分块。

推理可见性和令牌 ​

OpenClaw 可以显示或隐藏模型推理:

  • /reasoning on|off|stream 控制可见性。
  • 模型生成的推理内容仍计入令牌使用量。
  • Telegram 支持将推理流式传输到草稿气泡中。

详情:思考 + 推理指令和令牌使用。

前缀、线程和回复 ​

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

  • messages.responsePrefix(出站前缀)和 channels.whatsapp.messagePrefix(WhatsApp 入站前缀)
  • 通过 replyToMode 和每频道默认值进行回复线程

详情:配置和频道文档。