跳转到主要内容

输入指示

输入指示会在运行中发送到聊天渠道。使用 agents.defaults.typingMode 控制何时开始输入指示,使用 typingIntervalSeconds 控制刷新频率

默认值

agents.defaults.typingMode 未设置时,OpenClaw 保持旧行为:
  • 私聊:模型循环开始即显示输入。
  • 群聊且有 mention:立即显示输入。
  • 群聊且无 mention:仅当消息文本开始 streaming 时显示输入。
  • Heartbeat 运行:禁用输入指示。

模式

agents.defaults.typingMode 设置为:
  • never — 永不显示输入指示。
  • instant模型循环开始即显示,即便最终仅返回静默 token。
  • thinking — 在第一个推理 delta时显示(需该次运行 reasoningLevel: "stream")。
  • message — 在第一个非静默文本 delta时显示(忽略 NO_REPLY 静默 token)。
“触发越早”的顺序: nevermessagethinkinginstant

配置

{
  agent: {
    typingMode: "thinking",
    typingIntervalSeconds: 6
  }
}
可按会话覆盖模式或频率:
{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4
  }
}

  • message 模式不会为仅静默回复显示输入(例如用于抑制输出的 NO_REPLY)。
  • thinking 仅在运行流式推理时触发(reasoningLevel: "stream")。若模型不输出推理 delta,则不会开始输入指示。
  • Heartbeats 无论模式如何都不显示输入。
  • typingIntervalSeconds 控制刷新频率,而非开始时间。默认 6 秒。