引导队列
当普通提示在活动会话运行期间到达,且队列模式为 steer(默认值,无需配置)时,OpenClaw 会尝试将该提示发送到活动运行时,包括在工具执行期间。OpenClaw 和原生 Codex app-server 框架以不同方式实现投递细节。
本页介绍 steer 模式下普通入站消息的队列模式转向。在 followup 或 collect 模式下,普通消息会跳过此路径,并等待活动运行结束。对于显式的 /steer <message> 命令,请参阅 Steer。
较早的 followup 不会禁用后续输入的转向。OpenClaw 会在较早的转向尝试稳定后,针对活动运行尝试每个新的转向。运行时拒绝的消息会按原始顺序保持排队;已接受的转向会进入活动轮次。
运行时边界¶
转向不会中断已经在运行的工具调用。助手消息中的工具调用是一个已提交的计划,直到其中一个开始执行:
- 助手请求工具调用。
- 在顺序模式下,OpenClaw 启动第一个可执行的调用,而不检查转向。在该助手消息中的某个调用开始之后,OpenClaw 会在每个后续调用之前进行检查,包括在异步解析、验证和预执行钩子之后。
- 正在运行的调用结束。如果之后有转向在等待,则未开始的顺序尾部会被跳过。
- 在并行模式下,OpenClaw 会一起准备并启动调用,而不进行转向检查点。等待中的转向永远不会跳过并行批次。
- 每个被跳过的调用都会收到成对的 tool start/end 事件和一个合成结果(
Skipped to process an incoming message.),按助手源顺序排列。该结果会告知模型工具未运行,Control UI 将其标记为 Skipped。 - 任一批次稳定后,OpenClaw 会在停止钩子或下一次模型调用之前检查转向。它会在工具结果之后、下一次 LLM 调用之前,追加已排空的精确转向消息。
这确保每个请求的工具调用都与一个结果配对,而不会在任何工具执行之前丢弃刚刚请求的计划。
内部更新,包括子代理完成报告,也使用此转向边界。这些更新可以从聊天记录中隐藏,并且不会出现在用户消息队列中。因此,被跳过的工具不一定意味着有用户消息在等待;代理会先处理传入的更新,再决定接下来调用哪些工具。
在内置运行时中,每个被转向的用户输入都会按顺序获得自己的已投递答案。较晚的答案不会替换较早输入的已完成答案,即使转向跳过了其待处理工具。
被转向的频道回复会将该消息的引用或转发上下文带入模型输入。引用内容保持为会话数据;对命令和待处理问题的回答使用字面传入文本。仅文本的记录条目也保留字面输入。
原生 Codex app-server 框架暴露 turn/steer,而不是 OpenClaw 运行时的内部转向队列。OpenClaw 会为配置的静默窗口批量处理排队提示,然后发送一个单一的 turn/steer 请求,其中包含所有按到达顺序收集的用户输入。Codex 的上游轮次调度器拥有其工具调度,并在模型边界处排空待处理输入;OpenClaw 不会为该运行时添加逐工具抢占。记录提交确认持久化,而不是确认后续模型请求已读取输入。
Codex 审查和手动压缩轮次拒绝同轮转向。当运行时无法在 steer 模式下接受转向时,OpenClaw 会等待活动运行结束,然后再开始提示。
在没有原生钩子准入的 Codex 安装中,当原生子代理生成可用时,另一个人的消息会作为后续排队,而不是转向活动轮次。如果线程策略已禁用原生生成,包括 ChatGPT token 共享和仅报告委派,其他人仍然可以转向正在运行的轮次。
一旦 OpenClaw 轮次结束或已交接,即使清理仍在运行,新提示也会等待下一轮次。当前轮次内的重试和压缩仍可以接收转向。当模型请求失败时,如果转向消息仍在等待,该消息不会接管轮次:OpenClaw 会为原始消息重试或回退,转向消息随后作为其自己的轮次运行。
工具启动边界¶
OpenClaw 会跟踪工具是否在整个助手消息中实际启动:
- 在助手消息中的任何工具启动之前,转向不能跳过顺序调用。仅验证或策略拒绝不算执行开始。
- 已经在运行的顺序调用会完成。等待中的转向可以跳过未开始的顺序尾部,并让模型在可见转向的情况下重新考虑。
- 并行批次永远不会因转向而跳过调用。准备好的调用会一起启动,转向在批次稳定后检查。
- 流式工具批次和同一助手消息末尾的任何剩余调用共享此启动状态。较早的调用启动后,后续的顺序批次可以被跳过;后续的并行批次仍会运行。
- 记录保持仅追加且结构上配对:助手工具调用、真实或合成工具结果,然后是转向用户消息。
因转向而被跳过的工具不会触发失败警告。即使后续调用被跳过,真正的工具失败仍可报告。
停止已在运行的工作与重定向未来工作是不同的意图。当最新消息应中止活动运行而不是转向它时,请使用 /queue interrupt(或 /stop)。
模式¶
| 模式 | 活动运行行为 | 后续行为 |
|---|---|---|
| 模式 | 活动运行行为 | 后续行为 |
|---|---|---|
steer |
在可行时,将 prompt 引导到活动运行时。 | 如果无法引导,则等待活动运行结束。 |
followup |
不进行引导。 | 在活动运行结束后,稍后运行排队消息。 |
collect |
不进行引导。 | 在防抖窗口后,将兼容的排队消息合并为一个后续回合。 |
interrupt |
中止活动运行,而不是引导它。 | 中止后启动最新消息。 |
具有独立持久入口准入的消息(包括 Discord 和 Telegram 消息)不兼容批量处理:collect 会将它们保留为独立的后续回合。兼容的 Gateway chat.send 输入仍可以合并。参见 队列模式。
突发示例¶
如果四个用户在代理执行工具调用时发送消息:
- OpenClaw 保留运行时配置的引导排空模式和 FIFO 顺序。逐个消费者会将后续消息保留到后续边界;
all消费者会一起注入排队的 FIFO 批次。Codex 会将其静默窗口期间收集到的消息作为一个批量turn/steer接收。 - 使用
/queue collect时,OpenClaw 不进行引导。它等待活动运行结束,然后在防抖窗口后创建后续回合,仅合并兼容的排队消息。 - 使用
/queue interrupt时,OpenClaw 中止活动运行,并改为启动最新消息,而不是引导。
范围¶
引导始终针对当前活动会话运行。它不会创建新会话、更改活动运行的工具策略,或按发送者拆分消息。在多用户频道中,传入 prompt 已包含发送者和路由上下文,因此下一次模型调用可以看到每条消息的发送者。
通过 agent RPC 启动的可见用户回合也可以接收兼容的引导。带有可选回复的直接后台回合会将新的人类消息排队,用于一个可以提供所需答案的后续回合。
这包括子代理完成和命令公告:当引导被拒绝时,消息会在公告及其清理完成后自动运行。输入仍保持排队状态,并在等待期间仍可取消。
当不同已登录人员具有相同权限时,可以引导彼此的活动回合,包括从不同浏览器或重新连接后。该回合保留其原始所有者的权限、工具绑定和审批目标。
个人工具(screen 和 theme)代表一个指定人员操作。当多人已引导该回合时,代理必须将该人员的已验证 requester_profile.id 作为 user 传递,以选择更改谁的视图或外观;如果不明确,则询问。每条经过身份验证的 Control UI 消息都会在代理的用户角色对话上下文中包含其请求者的已验证配置文件 ID。
会话工具和 sessions_spawn 在多人已引导该回合时,也会将请求者的已验证 requester_profile.id 作为 user 使用。会话访问和派生子的权限使用该人员的权限。被引导的回合与会话中的后续回合一样,使用会话所选的模型账户。
在多人员回合中,未选择的会话调用仅可针对该回合自身的会话使用所有者的权限;其他目标和全会话发现需要使用请求者的 requester_profile.id 作为 user 的会话工具。
没有 user 选择器的个人指令和其他个人设置无法从多人已引导的回合中读取或更改。该人员应使用新的 Control UI 消息在自己的回合中询问。对于混合人员回合中的 Crabbox 打开并显示请求,请创建不带 presentation 的环境,然后使用 screen 并配合 desktop_show 或 portal_show、其 environmentId,以及请求者的 requester_profile.id 作为 user。
不同的权限(角色范围、会话访问上限、沙箱要求、允许的代理、模型访问、访问授权或工具策略)会将消息排队为后续回合;对执行策略、工作区或绑定工具的更改也可能需要后续回合。
自动凭据轮换和模型回退也会保留活动回合。 只要所选模型保持不变、仍允许回退且当前权限匹配,新输入就可以引导该回合。选择或锁定模型、固定不同账户或更改工具权限可能需要后续回合。对待定问题的回答仍会发送给问题的原始所有者。
个人 USER.md 上下文
遵循会话分配的人类所有者,否则遵循其经过身份验证的人类创建者。另一位具有相同权限的参与者可以在不切换该个人上下文的情况下进行引导,并且收集的消息保持相同的会话选择。重新分配在下一个新回合生效;它不会替换正在运行的回合的个人指令。个人上下文选择不会授予工具权限或更改审批目标。
已接受的跨会话引导在发送回合结束后保留所选发送者的源权限。访问撤销仍可在输入提交到转录之前阻止该输入。
可见消息或发送确认并不意味着活动运行时已消费它。当已接受的消息正在等待工作进程设置或工作区同步时,Control UI 会显示特定通知。 在回合创建其 worktree 或准备其运行时期间发送的引导会保持为该回合的待定状态。一旦运行时就绪,OpenClaw 会检查它是否可以接受该输入。如果回合结束或无法接受,消息将保持排队状态,用于后续回合。 等待后续回合的消息会显示在编辑器上方的队列中,包括当 Gateway 排队一条无法引导的消息时。它们会在重连期间一直保留在那里,直到被消费或取消,而不会再次发送。
chat.send 返回的 runId 在转向回退为后续消息时,仍然是该输入的公开标识。队列接纳不会使其完成。其终结事件会在后续执行结束时到达,并携带该执行的成功、失败或取消结果。collect 批次会使用批次结果完成每个已消费输入的 runId。在消费前被拒绝、取消或丢弃的输入(包括队列溢出)会立即收到其终结结果。被接受到活动轮次中的转向仍会在其转录接收后完成该输入的 runId,但不会完成活动轮次。
如果你希望消息默认进入队列,而不是转向活动运行,请使用 followup 或 collect。如果最新提示应替换活动运行,请使用 interrupt。
取消待处理的转向¶
经过授权的 Gateway 客户端可以在消息仍等待在 OpenClaw 运行时的转向队列或后续队列中、且投递开始前,使用 chat.abort({ sessionKey,
runId }) 撤回该消息。请使用该消息的 chat.send 返回的 runId。这会撤回该消息,而不会停止活动运行,也不会将其作为后续消息重试。
一旦投递开始,取消无法保证撤回或撤销已完成的工作。如果无法确认投递,OpenClaw 会报告不确定性,并保留该输入而不重放它。不确定的转向回执不会停止活动运行或其正在运行的工具。请使用 /stop 显式停止该工作。
防抖¶
内置队列防抖适用于已排队的 followup 和 collect 投递。在使用原生 Codex 框架的 steer 模式下,它还会在发送批量 turn/steer 之前设置静默窗口。OpenClaw 活动转向不使用防抖计时器;在工具启动和模型边界处,它会按照运行时配置的转向排空模式以 FIFO 方式排空。
相关¶
- 命令队列
- 转向
- 消息
- 代理循环
- Codex 框架运行时 - 原生 Codex 框架上的
turn/steer行为
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw