Skip to content

/steer 命令让你在智能体正在工作时注入指导信息(比如“优先小补丁”),而不需要等它完成或修改 queue 模式。如果当前运行时无法接受指导,OpenClaw 会把消息当成普通提示继续处理,不会丢弃。适用于需要临时调整任务方向、子智能体控制或 ACP 会话场景。

OpenClaw /steer 命令:运行时指导与队列模式配置

/steer 优先尝试把消息注入到当前活跃的运行(run)中,用于“这个任务还在跑,我想调整一下”的时机。如果当前运行时无法接受 steering,OpenClaw 不会丢弃消息,而是把它作为普通提示继续处理。

当前会话

用顶层 /steer 来向当前会话的活跃 run 发送指导:

text
/steer prefer the smaller patch and keep the tests focused
/tell summarize before making the next tool call

行为说明:

  • 只针对当前会话的活跃 run,不影响其他会话。
  • 独立于会话的 /queue 模式工作,即使队列模式设为 collectfollowup/steer 仍然尝试注入。
  • 当会话空闲或活跃 run 无法接受 steering 时,消息会回退成普通的一轮对话,不会再注入。
  • 使用当前运行时的 steering path,因此模型会在下一个支持的运行时边界看到指导。

/steer 与 /queue 模式的关系

命令/模式行为
/queue steer设置队列模式:后续普通消息在活跃 run 运行时自动尝试 steering。
/steer <message>显式命令:无论当前 /queue 设置如何,尝试把该消息注入活跃 run。若不可注入,则去掉 /steer 前缀,按普通提示处理。
/queue collect/queue followup后续普通消息不会 steering,而是等到下一轮。
/queue interrupt最新消息会替换当前活跃 run,而不是 steering。

使用建议

  • 立即引导当前运行,用 /steer <message>
  • 想让未来所有普通消息默认 steering,设 /queue steer
  • 想让后续消息排队等下一轮,设 /queue collect/queue followup
  • 想让最新消息取代当前运行,设 /queue interrupt

关于队列模式和 steering 边界,参见 命令队列Steering 队列

子智能体

当目标是一个子智能体的运行(child run)时,使用 /subagents steer

text
/subagents steer 2 focus only on the API surface

顶层 /steer 不支持按 ID 或列表索引选择子智能体,它始终指向当前会话的活跃 run。子智能体的 ID、标签及控制命令详见 子智能体

ACP 会话

当目标是一个 ACP harness 会话时,使用 /acp steer

text
/acp steer --session agent:main:acp:codex tighten the repro

ACP 会话的选取及运行时行为参见 ACP 智能体

相关文档

常见问题

/steer 和 /queue steer 有什么区别?

/steer 是一次性的显式命令,只对当前消息有效,且即时尝试注入。/queue steer 是设置队列模式,让后续所有普通消息自动尝试注入。两者可以同时存在:设了 /queue steer 后,如果你仍用 /steer 发消息,该消息也会尝试注入,但 /steer 本身不改变队列设置。

子智能体能直接用 /steer 控制吗?

不能。顶层 /steer 只针对当前会话的活跃 run。要控制子智能体,必须用 /subagents steer <子智能体ID或标签> <指导信息>。ID 来自 /subagents 命令的输出。

/steer 会改变队列模式吗?

不会。/steer 命令只尝试注入当前这条消息,不影响 /queue 的当前设置。队列模式始终由你最后一次的 /queue 命令决定。