跳转到主要内容

输入指示器

输入指示器在运行(run)激活期间发送到聊天频道。使用 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 秒。

本页面源自 openclaw/openclaw,由 BeaversLab 翻译,遵循 MIT 协议 发布。
Last modified on March 27, 2026