Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

当会话运行已在流式传输时又收到一条消息，OpenClaw 可以将该消息发送到活动运行时，而不是为同一会话启动另一次运行。公开模式与运行时无关；Pi 和原生 Codex app-server harness 会以不同方式实现交付细节。

​
运行时边界

引导不会中断已经在运行的工具调用。Pi 会在模型边界检查排队的引导消息：
  1. 助手请求工具调用。
  2. Pi 执行当前助手消息的工具调用批次。
  3. Pi 发出回合结束事件。
  4. Pi 清空排队的引导消息。
  5. Pi 在下一次 LLM 调用之前，将这些消息追加为用户消息。
这会让工具结果与请求它们的助手消息保持配对，然后让下一次模型调用看到最新的用户输入。 原生 Codex app-server harness 暴露的是 turn/steer，而不是 Pi 的内部 Steering queue。OpenClaw 会在那里适配相同模式：
  • steer 会在配置的静默窗口内批量收集排队消息，然后按到达顺序，用所有已收集的用户输入发送单个 turn/steer 请求。
  • queue 通过发送单独的 turn/steer 请求来保持旧版序列化形态。
  • followup、collect、steer-backlog 和 interrupt 仍然是 OpenClaw 围绕活动 Codex 回合拥有的队列行为。
Codex 审查和手动压缩回合会拒绝同回合引导。当运行时无法接受引导时，OpenClaw 会在该模式允许的情况下回退到跟进队列。 本页说明普通入站消息的队列模式引导。对于显式的 /steer <message> 命令，请参阅 Steer。

​
模式

模式活动运行行为后续跟进行为
steer在下一个运行时边界一起注入所有排队的引导消息。这是默认值。仅当引导不可用时回退到跟进。
queue旧版逐条引导。Pi 在每个模型边界注入一条排队消息；Codex 发送单独的 turn/steer 请求。仅当引导不可用时回退到跟进。
steer-backlog与 steer 相同的活动运行引导行为。也会为稍后的跟进回合保留同一条消息。
followup不引导当前运行。稍后运行排队消息。
collect不引导当前运行。在防抖窗口之后，将兼容的排队消息合并为一个稍后的回合。
interrupt中止活动运行，然后启动最新消息。无。

​
突发示例

如果四个用户在智能体执行工具调用时发送消息：
  • steer：活动运行时会在下一次模型决策之前，按到达顺序接收全部四条消息。Pi 会在下一个模型边界清空它们；Codex 会以一个批量 turn/steer 接收它们。
  • queue：旧版序列化引导。Pi 每次注入一条排队消息；Codex 接收单独的 turn/steer 请求。
  • collect：OpenClaw 等待活动运行结束，然后在防抖窗口之后，用兼容的排队消息创建一个跟进回合。

​
范围

引导始终以当前活动会话运行为目标。它不会创建新会话、改变活动运行的工具策略，也不会按发送者拆分消息。在多用户渠道中，入站提示已经包含发送者和路由上下文，因此下一次模型调用可以看到每条消息是谁发送的。 当你希望 OpenClaw 构建一个稍后的跟进回合，并且该回合可以合并兼容消息且保留跟进队列丢弃策略时，请使用 collect。只有在需要较旧的逐条引导行为时，才使用 queue。

​
防抖

messages.queue.debounceMs 适用于跟进交付，包括 collect、followup、steer-backlog，以及活动运行引导不可用时的 steer 回退。对于 Pi，活动 steer 本身不使用防抖计时器，因为 Pi 会自然地批量收集消息直到下一个模型边界。对于原生 Codex harness，OpenClaw 会把相同的防抖值用作发送批量 turn/steer 之前的静默窗口。

​
相关