alvis
bedb527145
Some checks failed
ClawSweeper Dispatch / dispatch (push) Has been cancelled
CodeQL / Security High (actions) (push) Has been cancelled
CodeQL / Security High (channel-runtime-boundary) (push) Has been cancelled
CodeQL / Security High (core-auth-secrets) (push) Has been cancelled
CodeQL / Security High (mcp-process-tool-boundary) (push) Has been cancelled
CodeQL / Security High (network-ssrf-boundary) (push) Has been cancelled
CodeQL / Security High (plugin-trust-boundary) (push) Has been cancelled
CodeQL / Security High (process-exec-boundary) (push) Has been cancelled
Docs Sync Publish Repo / sync-publish-repo (push) Has been cancelled
Docs / docs (push) Has been cancelled
OpenClaw Stable Main Closeout / Resolve stable release closeout inputs (push) Has been cancelled
OpenClaw Stable Main Closeout / Verify stable main closeout (push) Has been cancelled
Workflow Sanity / no-tabs (push) Has been cancelled
Workflow Sanity / actionlint (push) Has been cancelled
Workflow Sanity / generated-doc-baselines (push) Has been cancelled
CI / runner-admission (push) Has been cancelled
CI / preflight (push) Has been cancelled
CI / security-fast (push) Has been cancelled
CI / pnpm-store-warmup (push) Has been cancelled
CI / build-artifacts (push) Has been cancelled
CI / native-i18n (push) Has been cancelled
CI / ${{ matrix.check_name }} (push) Has been cancelled
CI / ${{ matrix.checkName }} (push) Has been cancelled
CI / checks-node-compat-node22 (push) Has been cancelled
CI / check-bundled-channel-config-metadata (push) Has been cancelled
CI / check-dependencies (push) Has been cancelled
CI / check-guards (push) Has been cancelled
CI / check-lint (push) Has been cancelled
CI / check-prod-types (push) Has been cancelled
CI / check-shrinkwrap (push) Has been cancelled
CI / check-test-types (push) Has been cancelled
CI / check-additional-boundaries-a (push) Has been cancelled
CI / check-additional-boundaries-bcd (push) Has been cancelled
CI / check-additional-extension-bundled (push) Has been cancelled
CI / check-additional-extension-channels (push) Has been cancelled
CI / check-additional-extension-package-boundary (push) Has been cancelled
CI / check-additional-runtime-topology-architecture (push) Has been cancelled
CI / check-session-accessor-boundary (push) Has been cancelled
CI / check-session-transcript-reader-boundary (push) Has been cancelled
CI / check-docs (push) Has been cancelled
CI / skills-python (push) Has been cancelled
CI / macos-swift (push) Has been cancelled
CI / ios-build (push) Has been cancelled
CI / ci-timings-summary (push) Has been cancelled
Native App Locale Refresh / Refresh native fa (push) Has been cancelled
Native App Locale Refresh / Refresh native fr (push) Has been cancelled
Native App Locale Refresh / Refresh native hi (push) Has been cancelled
Native App Locale Refresh / Refresh native id (push) Has been cancelled
Native App Locale Refresh / Refresh native it (push) Has been cancelled
Native App Locale Refresh / Refresh native ja-JP (push) Has been cancelled
Control UI Locale Refresh / plan (push) Has been cancelled
Control UI Locale Refresh / Refresh ${{ matrix.locale }} (push) Has been cancelled
Control UI Locale Refresh / Commit control UI locale refresh (push) Has been cancelled
Live Media Runner Image / Build live media runner image (push) Has been cancelled
Native App Locale Refresh / Refresh native ar (push) Has been cancelled
Native App Locale Refresh / Refresh native de (push) Has been cancelled
Native App Locale Refresh / Refresh native es (push) Has been cancelled
Native App Locale Refresh / Refresh native ko (push) Has been cancelled
Native App Locale Refresh / Refresh native nl (push) Has been cancelled
Native App Locale Refresh / Refresh native pl (push) Has been cancelled
Native App Locale Refresh / Refresh native pt-BR (push) Has been cancelled
Native App Locale Refresh / Refresh native ru (push) Has been cancelled
Native App Locale Refresh / Refresh native sv (push) Has been cancelled
Native App Locale Refresh / Refresh native th (push) Has been cancelled
Native App Locale Refresh / Refresh native tr (push) Has been cancelled
Native App Locale Refresh / Refresh native uk (push) Has been cancelled
Native App Locale Refresh / Refresh native vi (push) Has been cancelled
Native App Locale Refresh / Refresh native zh-CN (push) Has been cancelled
Native App Locale Refresh / Refresh native zh-TW (push) Has been cancelled
Native App Locale Refresh / Commit native locale refresh (push) Has been cancelled
Plugin Init Scaffold Validation / Validate provider scaffold (push) Has been cancelled
Plugin NPM Release / preview_plugins_npm (push) Has been cancelled
Plugin NPM Release / Validate release publish approval (push) Has been cancelled
Plugin NPM Release / preview_plugin_pack (push) Has been cancelled
Plugin NPM Release / publish_plugins_npm (push) Has been cancelled
Sandbox Common Smoke / sandbox-common-smoke (push) Has been cancelled
Website Installer Sync / static (push) Has been cancelled
Website Installer Sync / linux-docker (push) Has been cancelled
Website Installer Sync / macos-installer (push) Has been cancelled
Website Installer Sync / windows-installer (push) Has been cancelled
Website Installer Sync / sync-website (push) Has been cancelled
Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11), free to diverge. Tree copied sans upstream .git; upstream remote added for future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19. Preserves docs/ARCHITECTURE.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2
78 lines
2.6 KiB
Markdown
78 lines
2.6 KiB
Markdown
---
|
|
summary: "Steer an active run without changing queue mode"
|
|
read_when:
|
|
- Using /steer or /tell while an agent is already running
|
|
- Comparing /steer with /queue modes
|
|
- Deciding whether to steer the current run or an ACP session
|
|
title: "Steer"
|
|
sidebarTitle: "Steer"
|
|
---
|
|
|
|
`/steer` first tries to send guidance to an already-active run. It is for
|
|
"adjust this run while it is still working" moments. If the current runtime
|
|
cannot accept steering, OpenClaw sends the message as a normal prompt instead
|
|
of dropping it.
|
|
|
|
## Current session
|
|
|
|
Use top-level `/steer` to target the active run for the current session:
|
|
|
|
```text
|
|
/steer prefer the smaller patch and keep the tests focused
|
|
/tell summarize before making the next tool call
|
|
```
|
|
|
|
Behavior:
|
|
|
|
- Targets only the current session's active run.
|
|
- Works independently of the session's `/queue` mode.
|
|
- Starts a normal turn with the same message when the session is idle or the
|
|
active run cannot accept steering.
|
|
- Uses the active runtime's steering path, so the model sees the guidance at
|
|
the next supported runtime boundary.
|
|
|
|
## Steer vs queue
|
|
|
|
`/queue steer` makes normal inbound messages try to steer the active run when
|
|
they arrive while a run is active. `/steer <message>` is an explicit command
|
|
that tries to inject that command's message into the active run at the next
|
|
supported runtime boundary, regardless of the stored `/queue` setting. When
|
|
that injection is not available, the command prefix is stripped and `<message>`
|
|
continues as a normal prompt.
|
|
|
|
Use:
|
|
|
|
- `/steer <message>` when you want to guide the active run right now.
|
|
- `/queue steer` when you want future normal messages to steer active runs by
|
|
default.
|
|
- `/queue collect` or `/queue followup` when future normal messages should wait
|
|
for a later turn instead of steering the active run.
|
|
- `/queue interrupt` when the newest message should replace the active run
|
|
instead of steering it.
|
|
|
|
For queue modes and steering boundaries, see [Command queue](/concepts/queue) and
|
|
[Steering queue](/concepts/queue-steering).
|
|
|
|
## Sub-agents
|
|
|
|
Top-level `/steer` targets the current session's active run. Sub-agents report
|
|
back to their parent/requester session; `/subagents` is for visibility only.
|
|
|
|
## ACP sessions
|
|
|
|
Use `/acp steer` when the target is an ACP harness session:
|
|
|
|
```text
|
|
/acp steer --session agent:main:acp:codex tighten the repro
|
|
```
|
|
|
|
See [ACP agents](/tools/acp-agents) for ACP session selection and runtime
|
|
behavior.
|
|
|
|
## Related
|
|
|
|
- [Slash commands](/tools/slash-commands)
|
|
- [Command queue](/concepts/queue)
|
|
- [Steering queue](/concepts/queue-steering)
|
|
- [Sub-agents](/tools/subagents)
|