mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-03 16:51:34 +00:00
* 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
3.1 KiB
3.1 KiB
summary, read_when, title
| summary | read_when | title | |
|---|---|---|---|
| When OpenClaw shows typing indicators and how to tune them |
|
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 asNO_REPLYdo 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
messagemode does not start from silent reply tokens, but active execution can still show typing before any assistant text is available.thinkingstill 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
messageorthinkingstream timing. SettypingMode: "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.typingIntervalSecondscontrols the refresh cadence, not the start time. Default: 6 seconds.agents.entries.*.typingIntervalSecondscan override it per agent.