輸入中指示器

Documentation Index

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

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

​

預設值

• 直接聊天：模型迴圈一開始，輸入狀態就會立即開始。
• 有提及的群組聊天：輸入狀態會立即開始。
• 沒有提及的群組聊天：只有在訊息文字開始串流時，輸入狀態才會開始。
• Heartbeat 執行：如果解析出的 heartbeat 目標是支援輸入狀態的聊天，且輸入狀態未停用，則輸入狀態會在 heartbeat 執行開始時啟動。

​

模式

• never — 永遠不顯示輸入狀態指示器。
• instant — 模型迴圈一開始就開始輸入狀態，即使該執行稍後只傳回靜默回覆詞元。
• thinking — 在第一個推理增量時開始輸入狀態（該執行需要 reasoningLevel: "stream"）。
• message — 在第一個非靜默文字增量時開始輸入狀態（忽略 NO_REPLY 靜默詞元）。

​

設定

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

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

​

注意事項

• message 模式在整個有效負載正好是靜默詞元時（例如 NO_REPLY / no_reply， 以不區分大小寫的方式比對），不會為純靜默回覆顯示輸入狀態。
• thinking 只有在執行串流推理時才會觸發（reasoningLevel: "stream"）。 如果模型沒有發出推理增量，輸入狀態就不會開始。
• Heartbeat 輸入狀態是針對解析出的遞送目標的存活訊號。它會在 heartbeat 執行開始時啟動，而不是遵循 message 或 thinking 的串流時機。設定 typingMode: "never" 可停用它。
• 當 target: "none"、目標無法解析、heartbeat 的聊天遞送已停用，或頻道不支援輸入狀態時，Heartbeats 不會顯示輸入狀態。
• typingIntervalSeconds 控制的是重新整理節奏，不是開始時間。 預設值為 6 秒。

​

相關內容

• Presence
• 串流與分塊