メインコンテンツへスキップ

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 ハーネスでは、配信の詳細が異なる方法で実装されています。

ランタイム境界

ステアリングは、すでに実行中のツール呼び出しを中断しません。Pi はモデル境界でキュー内のステアリングメッセージを確認します。
  1. アシスタントがツール呼び出しを要求します。
  2. Pi が現在のアシスタントメッセージのツール呼び出しバッチを実行します。
  3. Pi がターン終了イベントを発行します。
  4. Pi がキュー内のステアリングメッセージを排出します。
  5. Pi が次の LLM 呼び出しの前に、それらのメッセージをユーザーメッセージとして追加します。
これにより、ツール結果はそれを要求したアシスタントメッセージと対応付けられたままになり、次のモデル呼び出しが最新のユーザー入力を参照できるようになります。 ネイティブの Codex app-server ハーネスは、Pi の内部ステアリングキューの代わりに turn/steer を公開します。OpenClaw はそこで同じモードを次のように適用します。
  • steer は、設定された静止時間枠の間にキュー内のメッセージをまとめ、その後、収集したすべてのユーザー入力を到着順に含む単一の turn/steer リクエストを送信します。
  • queue は、個別の turn/steer リクエストを送信することで従来のシリアライズされた形を維持します。
  • followupcollectsteer-backloginterrupt は、アクティブな Codex ターンの周囲で OpenClaw が所有するキュー動作のままです。
Codex レビューと手動 Compaction ターンは、同一ターンのステアリングを拒否します。ランタイムがステアリングを受け入れられない場合、OpenClaw はそのモードで許可されている場合にフォローアップキューへフォールバックします。

モード

モードアクティブ実行時の動作後続フォローアップの動作
steer次のランタイム境界で、キュー内のすべてのステアリングメッセージをまとめて注入します。これがデフォルトです。ステアリングが利用できない場合にのみフォローアップへフォールバックします。
queue従来の1件ずつのステアリングです。Pi はモデル境界ごとにキュー内のメッセージを1件注入し、Codex は個別の turn/steer リクエストを送信します。ステアリングが利用できない場合にのみフォローアップへフォールバックします。
steer-backlogsteer と同じアクティブ実行時のステアリング動作です。後続のフォローアップターン用にも同じメッセージを保持します。
followup現在の実行をステアリングしません。キュー内のメッセージを後で実行します。
collect現在の実行をステアリングしません。デバウンス時間枠の後、互換性のあるキュー内のメッセージを1つの後続ターンにまとめます。
interruptアクティブな実行を中止し、その後で最新のメッセージを開始します。なし。

バースト例

エージェントがツール呼び出しを実行している間に4人のユーザーがメッセージを送信した場合:
  • steer: アクティブなランタイムは、次のモデル判断の前に4件すべてのメッセージを到着順に受け取ります。Pi は次のモデル境界でそれらを排出し、Codex は1つにバッチ化された turn/steer としてそれらを受け取ります。
  • queue: 従来のシリアライズされたステアリングです。Pi はキュー内のメッセージを1件ずつ注入し、Codex は個別の turn/steer リクエストを受け取ります。
  • collect: OpenClaw はアクティブな実行が終了するまで待ち、その後、デバウンス時間枠の後に互換性のあるキュー内のメッセージを含むフォローアップターンを作成します。

スコープ

ステアリングは常に現在のアクティブなセッション実行を対象にします。新しいセッションを作成したり、アクティブな実行のツールポリシーを変更したり、送信者ごとにメッセージを分割したりすることはありません。マルチユーザーチャンネルでは、受信プロンプトにすでに送信者とルートのコンテキストが含まれているため、次のモデル呼び出しは各メッセージを誰が送信したかを確認できます。 OpenClaw に、互換性のあるメッセージをまとめ、フォローアップキューのドロップポリシーを保持できる後続のフォローアップターンを構築させたい場合は、collect を使用してください。古い1件ずつのステアリング動作が必要な場合にのみ、queue を使用してください。

デバウンス

messages.queue.debounceMs は、collectfollowupsteer-backlog、およびアクティブ実行時のステアリングが利用できない場合の steer フォールバックを含む、フォローアップ配信に適用されます。Pi では、アクティブな steer 自体はデバウンスタイマーを使用しません。Pi は次のモデル境界まで自然にメッセージをバッチ化するためです。ネイティブの Codex ハーネスでは、OpenClaw はバッチ化された turn/steer を送信する前の静止時間枠として同じデバウンス値を使用します。

関連