跳轉到主要內容

輸入指示器

Typing indicators are sent to the chat channel while a run is active. 在執行期間,輸入中指示會傳送到聊天頻道。使用 agents.defaults.typingMode 來控制何時開始輸入,並使用 typingIntervalSeconds 來控制更新頻率

Defaults

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 only fires if the run streams reasoning (reasoningLevel: "stream"). If the model doesn’t emit reasoning deltas, typing won’t start.
  • 心跳執行無論模式為何,都不會顯示輸入中。
  • typingIntervalSeconds 只控制更新頻率,而非開始時間。 預設為 6 秒。 The default is 6 seconds. The default is 6 seconds.