打字指示器

在运行活跃时,打字指示器会发送到聊天通道。使用 agents.defaults.typingMode 控制何时开始打字,使用 typingIntervalSeconds 控制多久刷新一次。

默认值

agents.defaults.typingMode 未设置时,OpenClaw 保持旧版行为:

  • 直接聊天:一旦模型循环开始,打字立即开始。
  • 带提及的群组聊天:打字立即开始。
  • 不带提及的群组聊天:仅当消息文本开始流式传输时,打字才开始。
  • 心跳运行:打字禁用。

模式

agents.defaults.typingMode 设置为以下之一:

  • never — 永远不显示打字指示器。
  • instant一旦模型循环开始就开始打字,即使运行后来只返回静默回复令牌。
  • thinking — 在第一个推理增量时开始打字(需要运行启用 reasoningLevel: "stream")。
  • message — 在第一个非静默文本增量时开始打字(忽略用于抑制输出的 NO_REPLY 静默令牌)。

“多早触发”的顺序: nevermessagethinkinginstant

配置

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

你可以按会话覆盖模式或节奏:

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

说明

  • message 模式不会为纯静默回复显示打字(例如用于抑制输出的 NO_REPLY 令牌)。
  • thinking 仅在运行流式传输推理时触发(reasoningLevel: "stream")。如果模型不发出推理增量,打字不会开始。
  • 心跳从不显示打字,无论模式如何。
  • typingIntervalSeconds 控制刷新节奏,而不是开始时间。默认是 6 秒。