메인 콘텐츠로 건너뛰기

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 앱 서버 하네스는 전달 세부 방식을 다르게 구현합니다.

​
런타임 경계

스티어링은 이미 실행 중인 도구 호출을 중단하지 않습니다. Pi는 모델 경계에서 대기 중인 스티어링 메시지를 확인합니다.
  1. 어시스턴트가 도구 호출을 요청합니다.
  2. Pi가 현재 어시스턴트 메시지의 도구 호출 배치를 실행합니다.
  3. Pi가 턴 종료 이벤트를 내보냅니다.
  4. Pi가 대기 중인 스티어링 메시지를 비웁니다.
  5. Pi가 다음 LLM 호출 전에 해당 메시지를 사용자 메시지로 추가합니다.
이렇게 하면 도구 결과가 이를 요청한 어시스턴트 메시지와 짝을 이루도록 유지한 다음, 다음 모델 호출이 최신 사용자 입력을 볼 수 있습니다. 네이티브 Codex 앱 서버 하네스는 Pi의 내부 스티어링 큐 대신 turn/steer를 노출합니다. OpenClaw는 같은 모드를 여기에 맞게 조정합니다.
  • steer는 구성된 조용한 창 동안 대기 중인 메시지를 배치한 다음, 수집된 모든 사용자 입력을 도착 순서대로 포함하는 단일 turn/steer 요청을 보냅니다.
  • queue는 별도의 turn/steer 요청을 보내 기존의 직렬화된 형태를 유지합니다.
  • followup, collect, steer-backlog, interrupt는 활성 Codex 턴 주변에서 OpenClaw가 소유하는 큐 동작으로 유지됩니다.
Codex 검토 및 수동 Compaction 턴은 동일 턴 스티어링을 거부합니다. 런타임이 스티어링을 수락할 수 없으면, OpenClaw는 해당 모드가 허용하는 경우 후속 큐로 대체합니다.

​
모드

모드활성 실행 동작이후 후속 동작
steer대기 중인 모든 스티어링 메시지를 다음 런타임 경계에서 함께 주입합니다. 이것이 기본값입니다.스티어링을 사용할 수 없을 때만 후속으로 대체합니다.
queue기존의 한 번에 하나씩 처리하는 스티어링입니다. Pi는 모델 경계마다 대기 중인 메시지를 하나씩 주입하고, Codex는 별도의 turn/steer 요청을 보냅니다.스티어링을 사용할 수 없을 때만 후속으로 대체합니다.
steer-backlogsteer와 동일한 활성 실행 스티어링 동작입니다.나중의 후속 턴을 위해 동일한 메시지도 유지합니다.
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 하네스의 경우 OpenClaw는 배치된 turn/steer를 보내기 전 조용한 창으로 동일한 디바운스 값을 사용합니다.

​
관련 항목