运行处于活动状态时,会向聊天渠道发送输入指示器。使用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)。
never → message → thinking → instant
配置
设置智能体级别默认值:说明
- 当整个载荷正好是静默 token(例如
NO_REPLY/no_reply,大小写不敏感匹配)时,message模式不会为仅静默回复显示输入状态。 thinking只有在运行流式传输推理(reasoningLevel: "stream")时才会触发。 如果模型没有发出推理增量,输入状态就不会开始。- Heartbeat 输入状态是针对解析出的投递目标的存活信号。它会在 Heartbeat 运行开始时启动,而不是遵循
message或thinking的流式传输时机。设置typingMode: "never"可将其禁用。 - 当
target: "none"、目标无法解析、该 Heartbeat 的聊天投递被禁用,或渠道不支持输入状态时,Heartbeat 不会显示输入状态。 typingIntervalSeconds控制的是刷新节奏,不是开始时间。 默认值为 6 秒。
相关
Presence
Gateway 网关 如何跟踪已连接的客户端,并在 macOS Instances 标签页中显示它们。
Streaming and chunking
出站流式传输行为、分块边界,以及特定于渠道的投递。