跳轉到主要內容

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 - 模型迴圈一開始就開始顯示正在輸入,即使該執行稍後只回傳靜默回覆權杖。
  • thinking - 在第一個推理 delta 時開始顯示正在輸入(該執行需要 reasoningLevel: "stream")。
  • message - 在第一個非靜默文字 delta 時開始顯示正在輸入(忽略 NO_REPLY 靜默權杖)。
「觸發得多早」的順序: nevermessagethinkinginstant

設定

設定代理層級的預設值:
{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}
針對每個工作階段覆寫模式或節奏:
{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

備註

  • 當整個負載是確切的靜默權杖(例如 NO_REPLY / no_reply,不區分大小寫比對)時,message 模式不會對純靜默回覆顯示正在輸入。
  • thinking 只會在執行串流推理(reasoningLevel: "stream")時觸發。 如果模型未發出推理 delta,正在輸入不會開始。
  • Heartbeat 正在輸入是解析後傳遞目標的活躍訊號。它會在 heartbeat 執行開始時啟動,而不是依循 messagethinking 的串流時機。設定 typingMode: "never" 可停用。
  • target: "none"、無法解析目標、heartbeat 的聊天傳遞已停用,或通道不支援正在輸入時,Heartbeat 不會顯示正在輸入。
  • typingIntervalSeconds 控制的是重新整理節奏,不是開始時間。 預設值是 6 秒。

相關

狀態

Gateway 如何追蹤已連線的用戶端,並在 macOS Instances 分頁中顯示它們。

串流與分塊

對外串流行為、分塊邊界,以及通道特定的傳遞。