Typing indicators(输入指示器)
输入指示器在运行活跃时发送到聊天频道。使用 agents.defaults.typingMode 控制何时开始输入,使用 typingIntervalSeconds 控制刷新频率。
默认值
当 agents.defaults.typingMode 未设置时,OpenClaw 保持传统行为:
- 直接聊天:一旦模型循环开始,立即开始输入。
- 带提及的群组聊天:立即开始输入。
- 不带提及的群组聊天:仅当消息文本开始流式传输时才开始输入。
- 心跳运行:禁用输入。
模式
将 agents.defaults.typingMode 设置为以下之一:
- never — 永不显示输入指示器。
- instant — 一旦模型循环开始就开始输入,即使运行后来只返回静默回复 token。
- thinking — 在第一个推理增量时开始输入(需要为运行设置 reasoningLevel: "stream")。
- message — 在第一个非静默文本增量时开始输入(忽略 NO_REPLY 静默 token)。
"触发早晚"顺序: never → message → thinking → instant
配置
{
agent: {
typingMode: "thinking",
typingIntervalSeconds: 6
}
}
你可以按会话覆盖模式或节奏:
{
session: {
typingMode: "message",
typingIntervalSeconds: 4
}
}
注意
- message 模式不会为纯静默回复显示输入(例如用于抑制输出的 NO_REPLY token)。
- thinking 仅在运行流式传输推理(reasoningLevel: "stream")时触发。如果模型不发出推理增量,输入不会开始。
- 心跳永不显示输入,无论模式如何。
- typingIntervalSeconds 控制刷新节奏,而非开始时间。默认为 6 秒。