Typing indicators 설정하기

채팅 앱을 쓰다 보면 상대방이 답장을 쓰고 있는지 궁금할 때가 많아요. 특히 AI 모델이 응답을 생성하는 동안 화면에 아무런 표시가 없으면, 사용자는 앱이 멈췄거나 오류가 발생했다고 생각하기 쉽죠.

이런 상황을 방지하기 위해 Typing indicators를 활용해 보세요. 모델이 현재 작업 중이라는 신호를 사용자에게 실시간으로 전달해서 대화의 흐름을 자연스럽게 유지할 수 있습니다.

필요한 것

• OpenClaw 설정 파일 접근 권한
• thinking 모드 사용 시: reasoningLevel: "stream" 설정 필요

빠른 시작

가장 빠르게 타이핑 표시를 활성화하는 방법입니다. agent 설정에서 원하는 모드와 갱신 간격을 지정하세요.

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

특정 세션에서만 설정을 다르게 적용하고 싶다면 아래와 같이 세션별로 오버라이드할 수 있습니다.

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

주요 설정 모드

agents.defaults.typingMode에 설정할 수 있는 값은 총 4가지입니다.

• never: 타이핑 표시를 전혀 사용하지 않습니다.
• instant: 모델 루프가 시작되자마자 타이핑 표시를 시작합니다. 나중에 silent reply 토큰만 반환되더라도 즉시 표시됩니다.
• thinking: 첫 번째 reasoning delta가 발생할 때 타이핑을 시작합니다. (스트리밍 설정이 필요합니다.)
• message: silent 토큰이 아닌 실제 텍스트 delta가 처음 발생할 때 타이핑을 시작합니다.

타이핑 표시가 실행되는 시점은 never → message → thinking → instant 순서로 빨라집니다.

알아두어야 할 기본 동작

별도로 typingMode를 설정하지 않으면 OpenClaw는 다음의 기본 동작(legacy behavior)을 따릅니다.

• Direct chats: 모델 루프가 시작되면 즉시 타이핑을 표시합니다.
• Group chats (mention 포함): 멘션이 있으면 즉시 타이핑을 표시합니다.
• Group chats (mention 미포함): 메시지 텍스트 스트리밍이 시작될 때만 타이핑을 표시합니다.
• Heartbeat runs: 타이핑 표시가 비활성화됩니다.

문제 해결

• thinking 모드에서 타이핑 표시가 나타나지 않아요: 이 모드는 실행 시 reasoningLevel: "stream" 설정이 반드시 필요합니다. 모델이 reasoning delta를 내보내지 않으면 타이핑 표시가 시작되지 않습니다.
• message 모드에서 특정 응답에 타이핑 표시가 없어요: NO_REPLY 같은 silent 토큰만 있는 응답의 경우, 이 모드에서는 타이핑 표시를 하지 않습니다.
• Heartbeat 실행 시 표시가 안 돼요: Heartbeat는 설정 모드와 상관없이 타이핑 표시를 지원하지 않습니다.
• 표시 간격을 조절하고 싶어요: typingIntervalSeconds는 타이핑 시작 시간이 아니라, 표시를 갱신하는 주기입니다. 기본값은 6초입니다.

궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Agent Defaults 설정 가이드
• Session Configuration 상세 보기