타이핑 표시

타이핑 표시는 실행이 활성 상태인 동안 대화 채널로 전송됩니다. agents.defaults.typingMode로 타이핑 시작 시점을 제어하고, typingIntervalSeconds로 갱신 주기를 제어합니다.

기본값

agents.defaults.typingMode가 미설정이면 OpenClaw은 레거시 동작을 유지합니다:

• 직접 대화: 모델 루프가 시작되면 즉시 타이핑 시작.
• 멘션이 있는 그룹 대화: 즉시 타이핑 시작.
• 멘션이 없는 그룹 대화: 메시지 텍스트가 스트리밍되기 시작할 때만 타이핑 시작.
• 하트비트 실행: 타이핑 비활성화.

모드

agents.defaults.typingMode를 다음 중 하나로 설정합니다:

• never — 타이핑 표시를 전혀 보내지 않음.
• instant — 모델 루프가 시작되는 즉시 타이핑을 시작하며, 실행이 나중에 무음 응답 토큰만 반환해도 표시됨.
• thinking — 첫 번째 추론 델타에서 타이핑 시작 (해당 실행에 reasoningLevel: "stream" 필요).
• message — 첫 번째 비무음 텍스트 델타에서 타이핑 시작 (NO_REPLY 무음 토큰 무시).

“얼마나 일찍 발동하는가” 순서: never → message → thinking → instant

구성

{
  agent: {
    typingMode: "thinking",
    typingIntervalSeconds: 6,
  },
}

세션별로 모드나 주기를 오버라이드할 수 있습니다:

{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

참고

• message 모드는 무음 전용 응답(예: 출력을 억제하는 NO_REPLY 토큰)에서는 타이핑을 표시하지 않습니다.
• thinking은 실행이 추론을 스트리밍(reasoningLevel: "stream")하는 경우에만 발동합니다. 모델이 추론 델타를 내보내지 않으면 타이핑이 시작되지 않습니다.
• 하트비트는 모드에 관계없이 타이핑을 표시하지 않습니다.
• typingIntervalSeconds는 시작 시간이 아닌 갱신 주기를 제어합니다. 기본값은 6초입니다.