跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

运行处于活动状态时,会向聊天渠道发送输入指示器。使用 agents.defaults.typingMode 控制输入状态何时开始,使用 typingIntervalSeconds 控制它多久刷新一次。

默认值

agents.defaults.typingMode 未设置时,OpenClaw 会保持旧版行为:
  • 直接聊天:模型循环一开始,输入状态就会立即开始。
  • 带有提及的群聊:输入状态会立即开始。
  • 不带提及的群聊:只有在消息文本开始流式传输时,输入状态才会开始。
  • Heartbeat 运行:如果解析出的 Heartbeat 目标是支持输入状态的聊天,且输入状态未被禁用,则输入状态会在 Heartbeat 运行开始时启动。

模式

agents.defaults.typingMode 设置为以下之一:
  • never - 永不显示输入指示器。
  • instant - 模型循环一开始就开始输入状态,即使该运行之后只返回静默回复 token。
  • thinking - 在第一个推理增量时开始输入状态(该运行需要 reasoningLevel: "stream")。
  • message - 在第一个非静默文本增量时开始输入状态(忽略 NO_REPLY 静默 token)。
“触发早晚”的顺序: nevermessagethinkinginstant

配置

设置智能体级别默认值:
{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}
按会话覆盖模式或节奏:
{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

说明

  • 当整个载荷正好是静默 token(例如 NO_REPLY / no_reply,大小写不敏感匹配)时,message 模式不会为仅静默回复显示输入状态。
  • thinking 只有在运行流式传输推理(reasoningLevel: "stream")时才会触发。 如果模型没有发出推理增量,输入状态就不会开始。
  • Heartbeat 输入状态是针对解析出的投递目标的存活信号。它会在 Heartbeat 运行开始时启动,而不是遵循 messagethinking 的流式传输时机。设置 typingMode: "never" 可将其禁用。
  • target: "none"、目标无法解析、该 Heartbeat 的聊天投递被禁用,或渠道不支持输入状态时,Heartbeat 不会显示输入状态。
  • typingIntervalSeconds 控制的是刷新节奏,不是开始时间。 默认值为 6 秒。

相关

Presence

Gateway 网关 如何跟踪已连接的客户端,并在 macOS Instances 标签页中显示它们。

Streaming and chunking

出站流式传输行为、分块边界,以及特定于渠道的投递。