输入指示器 (Typing indicators)

在运行（run）处于活跃状态时，输入指示器会发送到聊天渠道。使用 agents.defaults.typingMode 来控制 何时 开始显示输入状态，使用 typingIntervalSeconds 来控制其刷新 频率。

默认值

当 agents.defaults.typingMode 未设置 时，Clawdbot 保持传统行为：

• 私聊 (Direct chats)：一旦模型循环（model loop）开始，立即显示输入状态。
• 带提及的群聊 (Group chats with a mention)：立即显示输入状态。
• 不带提及的群聊 (Group chats without a mention)：仅在消息文本开始流式传输时显示输入状态。
• 心跳运行 (Heartbeat runs)：禁用输入指示器。

模式

将 agents.defaults.typingMode 设置为以下之一：

• never — 永不显示输入指示器。
• instant — 模型循环一开始 就显示输入状态，即使该运行稍后仅返回静默回复令牌。
• thinking — 在 第一个推理增量 (reasoning delta) 时显示输入状态（运行需要设置 reasoningLevel: "stream"）。
• message — 在 第一个非静默文本增量 时显示输入状态（忽略 NO_REPLY 静默令牌）。

“触发早晚”顺序： never → message → thinking → instant

配置

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

您可以按会话覆盖模式或频率：

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

注意事项

• message 模式不会为仅限静默的回复显示输入状态（例如用于抑制输出的 NO_REPLY 令牌）。
• thinking 仅在运行流式传输推理（reasoningLevel: "stream"）时触发。如果模型不发出推理增量，则不会显示输入状态。
• 无论处于何种模式，心跳运行从不显示输入状态。
• typingIntervalSeconds 控制 刷新频率，而不是开始时间。默认值为 6 秒。