Files
openclaw/docs/concepts/typing-indicators.md
Peter Steinberger edecdbd05e refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527)
* refactor(config): consolidate media model lists

* refactor(config): unify memory configuration

* refactor(config): consolidate TTS ownership

* refactor(config): move typing policy to agents

* refactor(config): retire product-level config surfaces

* refactor(config): share scoped tool policy type

* chore(config): refresh generated baselines

* fix(config): honor agent typing overrides

* fix(config): migrate sibling config consumers

* refactor(infra): keep base64url decoder private

* fix(config): strip invalid legacy TTS values

* chore(config): refresh rebased baseline hash

* fix(doctor): route legacy messages.tts.realtime voice to talk during tts move

* refactor(config): polish final layout names

* refactor(config): freeze retired tuning defaults

* feat(config): add fast mode default symmetry

* refactor(config): key agent entries by id

* docs(config): update final layout reference

* test(config): cover final layout migrations

* chore(config): refresh final layout baselines

* fix(config): align final layout runtime readers

* fix(config): align remaining readers

* fix(config): stabilize final layout migrations

* fix(config): finalize config projection proof

* fix(config): address final layout review

* docs(release): preserve historical config names

* fix(config): complete keyed agent migration

* fix(config): close final migration gaps

* fix(config): finish full-branch review

* fix(config): complete runtime secret detection

* fix(config): close final review findings

* fix(config): finish canonical docs and heartbeat migration

* fix(config): integrate latest main after rebase

* refactor(env): isolate test-only controls

* refactor(env): isolate build and development controls

* refactor(env): collapse process identity indirection

* refactor(env): remove duplicate config and temp aliases

* docs(env): define the operator-facing allowlist

* ci(env): ratchet production variable count

* fix(env): remove stale provider helper import

* fix(env): make ratchet sorting explicit

* test(env): keep test seam in dead-code audit

* test(env): cover ratchet growth and boundary; document surface budgets

* docs(config): document tier-eval consolidations

* docs(config): clarify speech preference ownership

* test(memory): align retired tuning fixtures

* refactor(memory): freeze engine heuristics

* refactor(config): apply tier-eval tranche

* refactor(tts): move persona shaping to providers

* refactor(compaction): move prompt policy to providers

* test(config): align hookified prompt fixtures

* chore(deadcode): classify test-only exports

* chore(github): remove unused spawn helper

* chore(deadcode): classify queue diagnostics

* chore(deadcode): remove unused lane snapshot export

* chore(plugin-sdk): ratchet consolidated surface

* fix(config): integrate latest main after rebase
2026-07-21 20:28:43 -07:00

3.1 KiB

summary, read_when, title
summary read_when title
When OpenClaw shows typing indicators and how to tune them
Changing typing indicator behavior or defaults
Typing indicators

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).

Defaults

When agents.defaults.typingMode is unset:

  • 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:

  • 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.

Order of "how early it fires": never -> message/thinking -> instant.

Configuration

Set the agent-level default:

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

Override the policy for one agent:

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

Notes

  • 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, not the start time. Default: 6 seconds. agents.entries.*.typingIntervalSeconds can override it per agent.
How the Gateway tracks connected clients for the Control UI Devices page and macOS Instances tab. Outbound streaming behavior, chunk boundaries, and channel-specific delivery.