輸入指示器

輸入指示器

輸入指示器會在執行運作期間發送至聊天頻道。請使用 agents.defaults.typingMode 來控制輸入何時開始，並使用 typingIntervalSeconds 來控制多久重新整理一次。

預設值

當 agents.defaults.typingMode 未設定時，OpenClaw 將保持舊有行為：

• 直接聊天：一旦模型迴圈開始，輸入指示器會立即啟動。
• 包含提及的群組聊天：輸入指示器會立即啟動。
• 不包含提及的群組聊天：僅當訊息文字開始串流時，輸入指示器才會啟動。
• Heartbeat 執行：輸入指示器已停用。

模式

將 agents.defaults.typingMode 設定為以下其中之一：

• never — 永遠不顯示輸入指示器。
• instant — 在模型迴圈開始時立即開始輸入，即使執行 後來僅返回靜默回覆 token。
• thinking — 在第一個推理增量時開始輸入（需該次執行 使用 reasoningLevel: "stream"）。
• message — 在第一個非靜默文字增量時開始輸入（忽略 NO_REPLY 靜默 token）。

「觸發多早」的順序： never → message → thinking → instant

設定

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

您可以針對每個階段覆寫模式或頻率：

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

備註

• message 模式不會對純靜默回覆顯示輸入指示器（例如用於隱藏輸出的 NO_REPLY token）。
• thinking 僅在執行串流推理時觸發（reasoningLevel: "stream"）。 如果模型未發出推理增量，輸入指示器將不會啟動。
• 無論模式為何，Heartbeats 永遠不會顯示輸入指示器。
• typingIntervalSeconds 控制的是重新整理頻率，而非開始時間。 預設值為 6 秒。