Typing indicators

기준일: 2026-07-26
공식 기준: Typing indicators

Typing indicators 문서는 OpenClaw 공식 문서(concepts/typing-indicators)를 한국어로 정리한 가이드입니다. When OpenClaw shows typing indicators and how to tune them 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

When OpenClaw shows typing indicators and how to tune them

한국어 가이드 범위: concepts/typing-indicators 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Defaults
• Modes
• 구성
• 참고
• 관련 문서

상세 내용

본문

Typing indicators are sent to the chat channel while a run is active. Use agents.defaults.typingMode to control when typing starts and typingIntervalSeconds to control how often it refreshes (keepalive cadence, default 6 seconds).

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Defaults

When agents.defaults.typingMode is unset:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Direct chats: typing starts immediately once the model loop begins.
• Group chats with a mention: typing starts immediately.
• Group chats without a mention: typing starts when the admitted run has user-visible activity, such as harness execution activity or message text.
• Heartbeat runs: typing starts when the heartbeat run begins, if the resolved heartbeat target is a typing-capable chat and typing is not disabled.

Modes

Set agents.defaults.typingMode to one of:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• never - no typing indicator, ever.
• instant - start typing as soon as the model loop begins, even if the run later returns only the silent reply token.
• thinking - start typing on the first reasoning delta, or on active harness execution after the turn is accepted.
• message - start typing on the first user-visible reply activity, such as active harness execution or a non-silent text delta. Silent reply tokens such as NO_REPLY do not count as text activity.

구성

{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}

{
  agents: {
    entries: {
      support: {
        typingMode: "message",
      },
    },
  },
}

참고

주요 항목:

• message mode does not start from silent reply tokens, but active execution can still show typing before any assistant text is available.
• thinking still reacts to streamed reasoning (reasoningLevel: "stream"), and can also start from active execution before reasoning deltas arrive.
• Heartbeat typing is a liveness signal for the resolved delivery target. It starts at heartbeat run start instead of following message or thinking stream timing. Set typingMode: "never" to disable it.
• Heartbeats do not show typing when the heartbeat target is "none", when the target cannot be resolved, when chat delivery is disabled for the heartbeat, or when the channel does not support typing.
• agents.defaults.typingIntervalSeconds controls the refresh cadence for every agent, not the start time. 기본값: 6 seconds.

관련 문서

How the Gateway tracks connected clients for the Control UI Devices page and macOS Instances tab.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/typing-indicators
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}

{
  agents: {
    entries: {
      support: {
        typingMode: "message",
      },
    },
  },
}

관련 링크

• 공식 원문: concepts/typing-indicators
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.