OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

思考層級

功能說明

  • 任何傳入內文中的行內指令：/t <level>、/think:<level> 或 /thinking <level>。
  • 層級（別名）：off | minimal | low | medium | high | xhigh | adaptive | max | ultra，大致對應 Anthropic 經典的 "think" < "think hard" < "think harder" < "ultrathink" 魔法詞階梯：
    • minimal ~ "think"
    • low ~ "think hard"
    • medium ~ "think harder"
    • high ~ "ultrathink"（預算上限）
    • xhigh ~ "ultrathink+"（GPT-5.2+ 和 Codex 模型，以及 Anthropic Claude Opus 4.7+ 的 effort）
    • adaptive → 由供應商管理的自適應思考（支援 Anthropic/Bedrock 上的 Claude 4.6、Anthropic Claude Opus 4.7+，以及 Google Gemini 動態思考）
    • max → 供應商最大推理強度（Anthropic Claude Opus 4.7+；Ollama 會將此對應至其最高的原生 think effort）
    • ultra → 供應商最大推理強度，加上所選模型／執行階段支援時的主動子代理程式協調
    • x-high、x_high、extra-high、extra high 和 extra_high 會對應至 xhigh。
    • highest 會對應至 high。
  • 供應商注意事項：
    • 思考選單與選擇器由供應商設定檔驅動。供應商外掛會宣告所選模型的確切層級集合，包括二元 on 等標籤。
    • adaptive、xhigh、max 和 ultra 只會針對支援它們的供應商／模型／執行階段設定檔顯示。若輸入不受支援層級的指令，系統會拒絕，並顯示該模型的有效選項。
    • 現有已儲存但不受支援的層級，會依供應商設定檔的排名重新對應。在非自適應模型上，adaptive 會退回至 medium，而 xhigh 和 max 會退回至所選模型支援的最高非關閉層級。
    • 若未明確設定思考層級，Anthropic Claude 4.6 模型預設為 adaptive。
    • Anthropic Claude Opus 4.8 和 Opus 4.7 會維持關閉思考，除非你明確設定思考層級。啟用自適應思考後，Opus 4.8 由供應商擁有的 effort 預設值為 high。
    • Anthropic Claude Opus 4.7+ 會將 /think xhigh 對應至自適應思考加上 output_config.effort: "xhigh"，因為 /think 是思考指令，而 xhigh 是 Opus 的 effort 設定。
    • Anthropic Claude Opus 4.7+ 也提供 /think max；它會對應至相同的供應商最大 effort 路徑。
    • 直接使用的 DeepSeek V4 模型提供 /think xhigh|max；兩者都會對應至 DeepSeek reasoning_effort: "max"，而較低的非關閉層級會對應至 high。
    • 透過 OpenRouter 路由的 DeepSeek V4 模型提供 /think xhigh，並傳送 OpenRouter 支援的 reasoning.effort 值，而非 DeepSeek 原生的頂層 reasoning_effort。較低的非關閉層級會對應至 high，而已儲存的 max 覆寫值會退回至 xhigh。
    • 支援思考的 Ollama 模型提供 /think low|medium|high|max；max 會對應至原生 think: "high"，因為 Ollama 的原生 API 接受 low、medium 和 high effort 字串。
    • OpenAI GPT 模型會透過模型專屬的 Responses API effort 支援來對應 /think。只有目標模型支援時，/think off 才會傳送 reasoning.effort: "none"；否則 OpenClaw 會省略已停用的推理承載資料，而不會傳送不受支援的值。
    • GPT-5.6 Sol 和 Terra 透過 Codex 執行階段提供原生 /think ultra。GPT-5.6 Luna 提供至 max 的層級，因為其 Codex 目錄未宣告 Ultra。
    • 內嵌式 OpenClaw 執行階段為 GPT-5.6 Sol、Terra 和 Luna 提供邏輯 /think ultra。它會傳送供應商最大 effort，並加入以執行為範圍的主動子代理程式協調指引。
    • 自訂 OpenAI 相容目錄項目可將 models.providers.<provider>.models[].compat.supportedReasoningEfforts 設為包含 "xhigh"，以選擇啟用 /think xhigh。這會使用對應傳出 OpenAI 推理 effort 承載資料的相同相容性中繼資料，使選單、工作階段驗證、代理程式命令列介面和 llm-task 與傳輸行為一致。
    • 設定中過時的 OpenRouter Hunter Alpha 參照會略過代理推理注入，因為該已淘汰的路由可能透過推理欄位傳回最終答案文字。
    • Google Gemini 會將 /think adaptive 對應至 Gemini 由供應商擁有的動態思考。Gemini 3 請求會省略固定的 thinkingLevel，而 Gemini 2.5 請求則會傳送 thinkingBudget: -1；固定層級仍會對應至該模型系列最接近的 Gemini thinkingLevel 或預算。
    • Anthropic 相容串流路徑上的 MiniMax M2.x（minimax/MiniMax-M2*）預設為 thinking: { type: "disabled" }，除非你在模型參數或請求參數中明確設定思考。這可避免 M2.x 的非原生 Anthropic 串流格式洩漏 reasoning_content 差異內容。MiniMax-M3（和 M3.x）不受此限制：M3 會發出正確的 Anthropic 思考區塊，並在停用思考時傳回空白內容，因此 OpenClaw 會讓 M3 維持使用供應商的省略／自適應思考路徑。
    • Z.AI（zai/*）對多數 GLM 模型採用二元模式（on/off）。GLM-5.2 是例外：它提供 /think off|low|high|max，將 low 和 high 對應至 Z.AI reasoning_effort: "high"，並將 max 對應至 reasoning_effort: "max"。
    • Moonshot API Kimi K3（moonshot/kimi-k3）一律以 max 進行思考、傳送 reasoning_effort: "max"、省略 K2 的 thinking 欄位與固定取樣覆寫值，並保留 K3 支援的工具選擇。Kimi Code K3（kimi/k3 和 kimi/k3[1m]）提供 /think off|max：關閉會傳送 thinking.type: "disabled"，而 max 會傳送具有最大 effort 的自適應思考。目前的 Kimi Code 參照也包括 kimi/kimi-for-coding 和 kimi/kimi-for-coding-highspeed。Kimi K2.7 Code（moonshot/kimi-k2.7-code 和 moonshot/kimi-k2.7-code-highspeed）一律進行思考，只提供 on，並省略傳出的 thinking 和 reasoning_effort。其他 moonshot/* 模型會將 /think off 對應至 thinking: { type: "disabled" }，並將任何非 off 層級對應至 thinking: { type: "enabled" }。啟用 K2 思考時，Moonshot 只接受 tool_choice auto|none；OpenClaw 會將不相容的值正規化為 auto。

解析順序

  1. 訊息中的行內指令（僅套用至該訊息）。
  2. 工作階段覆寫（透過傳送僅含指令的訊息來設定）。
  3. 個別代理程式預設值（設定中的 agents.entries.*.thinkingDefault）。
  4. 全域預設值（設定中的 agents.defaults.thinkingDefault）。
  5. 後備：若有供應商宣告的預設值，則使用該值；否則具備推理能力的模型會解析為 medium，或該模型最接近的受支援非 off 層級，而非推理模型則維持 off。

設定工作階段預設值

  • 傳送一則僅包含該指令的訊息（允許空白字元），例如 /think:medium 或 /t high。
  • 該設定會在目前工作階段中持續生效（預設為個別傳送者）。使用 /think default 可清除工作階段覆寫並繼承設定／供應商預設值；別名包括 inherit、clear、reset 和 unpin。
  • /think off 會儲存明確的關閉覆寫。它會停用思考，直到你變更或清除工作階段覆寫。
  • 系統會傳送確認回覆（Thinking level set to high. / Thinking disabled.）。如果層級無效（例如 /thinking big），該命令會遭拒並提供提示，且工作階段狀態維持不變。
  • 傳送不含引數的 /think（或 /think:），即可查看目前的思考層級。

代理程式的套用方式

  • 內嵌式 OpenClaw：解析後的層級會傳遞至行程內 OpenClaw 代理程式執行階段。
  • Claude 命令列介面後端：使用 claude-cli 時，具體的非關閉層級會以 --effort 傳遞至 Claude Code；adaptive 會移除已設定的 effort 旗標，並將實際 effort 委派給 Claude Code 的環境、設定和模型預設值。請參閱命令列介面後端。

快速模式 (/fast)

  • 層級：auto|on|off|default。
  • 僅含指令的訊息會切換工作階段快速模式覆寫，並回覆 Fast mode set to auto.、Fast mode enabled. 或 Fast mode disabled.。使用 /fast default 可清除工作階段覆寫並繼承已設定的預設值；別名包括 inherit、clear、reset 和 unpin。
  • 傳送不含模式的 /fast（或 /fast status），即可查看目前實際生效的快速模式狀態。
  • OpenClaw 會依下列順序解析快速模式：
    1. 行內／僅含指令的 /fast auto|on|off 覆寫（/fast default 會清除此層）
    2. 工作階段覆寫
    3. 個別代理程式預設值（agents.entries.*.fastModeDefault）
    4. 個別模型設定：agents.defaults.models["<provider>/<model>"].params.fastMode
    5. 後備：off
  • auto 會讓工作階段／設定模式維持自動，但會針對每次新的模型呼叫獨立解析。在自動截止時間前開始的呼叫會啟用快速模式；較晚的重試、後備、工具結果或接續呼叫開始時，快速模式會停用。截止時間預設為 60 秒；在作用中模型上設定 agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds 即可變更。
  • 對於 openai/*，快速模式會在受支援的 Responses 請求中傳送 service_tier=priority，以對應至 OpenAI 優先處理。
  • 對於由 Codex 支援的 openai/* / openai-codex/* 模型，快速模式會在 Codex Responses 上傳送相同的 service_tier=priority 旗標。原生 Codex 應用程式伺服器回合只會在 turn/start 或執行緒啟動／恢復時接收該層級，因此 auto 無法變更已在執行中的應用程式伺服器回合層級；它會套用至 OpenClaw 啟動的下一個模型回合。
  • 對於直接公開的 anthropic/* 請求（包括傳送至 api.anthropic.com 且經 OAuth 驗證的流量），快速模式會對應至 Anthropic 服務層級：/fast on 會設定 service_tier=auto，/fast off 會設定 service_tier=standard_only。
  • 對於 Anthropic 相容路徑上的 minimax/*，/fast on（或 params.fastMode: true）會將 MiniMax-M2.7 改寫為 MiniMax-M2.7-highspeed。
  • 若同時設定，明確的 Anthropic serviceTier / service_tier 模型參數會覆寫快速模式預設值。對非 Anthropic 代理基底 URL，OpenClaw 仍會略過 Anthropic 服務層級注入。
  • 啟用快速模式時，/status 會顯示 Fast；設定模式為自動時，則顯示 Fast:auto。

詳細輸出指令 (/verbose 或 /v)

  • 層級：on（最低）| full | off（預設）。
  • 僅含指令的訊息會切換工作階段的詳細輸出，並回覆 Verbose logging enabled. / Verbose logging disabled.；無效的層級會傳回提示，而不變更狀態。
  • /verbose off 會儲存明確的工作階段覆寫；若要清除，請在工作階段 UI 中選擇 inherit。
  • 獲授權的外部頻道傳送者可以持久保存工作階段的詳細輸出覆寫。內部閘道／網頁聊天用戶端需要 operator.admin 才能持久保存。
  • 行內指令只影響該則訊息；其他情況則套用工作階段／全域預設值。
  • 傳送不含引數的 /verbose（或 /verbose:），即可查看目前的詳細輸出層級。
  • 開啟詳細輸出時，會發出結構化工具結果的代理程式會將每次工具呼叫各自傳回為僅含中繼資料的訊息，並在可用時加上 <emoji> <tool-name>: <arg> 前綴。這些工具摘要會在各工具啟動時立即傳送（分開的訊息泡泡），而不是以串流差異形式傳送。
  • 在一般模式下仍會顯示工具失敗摘要，但除非詳細輸出為 full，否則會隱藏原始錯誤詳細資料的後綴。
  • 當詳細輸出為 full 時，工具完成後也會轉送其輸出（分開的訊息泡泡，截斷至安全長度）。若在執行進行中切換 /verbose on|full|off，後續的工具訊息泡泡會採用新設定。
  • agents.defaults.toolProgressDetail 控制 /verbose 工具摘要與進度草稿工具行的呈現形式。使用 "explain"（預設）可顯示精簡易懂的標籤，例如 🛠️ Exec: checking JS syntax；若偵錯時也需要附加原始命令／詳細資料，請使用 "raw"。各代理程式的 agents.entries.*.toolProgressDetail 會覆寫預設值。
    • explain：🛠️ Exec: check JS syntax for /tmp/app.js
    • raw：🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js

外掛追蹤指令（/trace）

  • 層級：on | off（預設）。
  • 僅含指令的訊息會切換工作階段的外掛追蹤輸出，並回覆 Plugin trace enabled. / Plugin trace disabled.。
  • 行內指令只影響該則訊息；其他情況則套用工作階段／全域預設值。
  • 傳送不含引數的 /trace（或 /trace:），即可查看目前的追蹤層級。
  • /trace 的範圍比 /verbose 更窄：它只會顯示外掛所擁有的追蹤／偵錯行，例如主動記憶的偵錯摘要。
  • 追蹤行可能出現在 /status 中，也可能在一般助理回覆後作為後續診斷訊息顯示。

推理可見性（/reasoning）

  • 層級：on|off|stream。
  • 僅含指令的訊息會切換是否在回覆中顯示思考區塊。
  • 啟用後，推理會以加上 Thinking 前綴的獨立訊息傳送。
  • stream：當使用中的頻道支援推理預覽時，會在產生回覆期間串流傳送推理內容，接著傳送不含推理內容的最終答案。
  • 別名：/reason。
  • 傳送不含引數的 /reasoning（或 /reasoning:），即可查看目前的推理層級。
  • 解析順序：行內指令、工作階段覆寫、各代理程式預設值（agents.entries.*.reasoningDefault）、全域預設值（agents.defaults.reasoningDefault），最後為備援值（off）。

系統會保守處理格式錯誤的本機模型推理標記。在一般回覆中，已閉合的 <think>...</think> 區塊會維持隱藏，已顯示文字後未閉合的推理內容也會隱藏。如果回覆完全包覆於單一未閉合的起始標記中，且原本會以空白文字送達，OpenClaw 會移除格式錯誤的起始標記，並送達其餘文字。

相關內容

心跳偵測

  • 心跳偵測探查的本文是已設定的心跳偵測提示詞（預設：Follow the heartbeat monitor scratch context when provided. Recurring tasks are cron jobs; create or change their schedules with cron tools or the openclaw cron CLI, not heartbeat scratch. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.）。心跳偵測訊息中的行內指令會照常套用（但應避免透過心跳偵測變更工作階段預設值）。
  • 心跳偵測的傳送預設只包含最終承載內容。若也要傳送獨立的 Thinking 訊息（可用時），請設定 agents.defaults.heartbeat.includeReasoning: true 或各代理程式的 agents.entries.*.heartbeat.includeReasoning: true。

網頁聊天 UI

  • 頁面載入時，網頁聊天的思考選擇器會反映輸入工作階段儲存區／設定中已儲存的工作階段層級。
  • 選擇其他層級後，會立即透過 sessions.patch 寫入工作階段覆寫；它不會等到下一次傳送，也不是一次性的 thinkingOnce 覆寫。
  • 若在模型、推理或速度選擇器的變更仍在套用時傳送訊息，系統會等待所有待處理的選擇器修補完成；若變更失敗，訊息會保持未傳送狀態，以供檢查。
  • 第一個選項一律是清除覆寫選項。它會顯示 Inherited: <resolved level>，包括繼承的思考功能停用時所顯示的 Inherited: Off。
  • 明確的選擇器選項會使用其直接層級標籤，並在有提供者標籤時予以保留（例如，提供者標示為 max 的選項會顯示 Maximum）。
  • 選擇器使用閘道工作階段資料列／預設值傳回的 thinkingLevels，並保留 thinkingOptions 作為舊版標籤清單。瀏覽器 UI 不會維護自己的提供者規則運算式清單；各外掛擁有模型專屬的層級集合。
  • /think:<level> 仍然有效，且會更新相同的已儲存工作階段層級，因此聊天指令與選擇器會保持同步。

提供者設定檔

  • 提供者外掛可以公開 resolveThinkingProfile(ctx)，以定義模型支援的層級與預設值。
  • 代理 Claude 模型的提供者外掛應重複使用 openclaw/plugin-sdk/provider-model-shared 中的 resolveClaudeThinkingProfile(modelId)，使直接 Anthropic 與代理目錄保持一致。
  • 每個設定檔層級都有一個已儲存的標準 id（off、minimal、low、medium、high、xhigh、adaptive、max 或 ultra），且可包含顯示用的 label。二元提供者使用 { id: "low", label: "on" }。
  • 設定檔掛鉤會在可用時接收合併後的目錄資訊，包括 reasoning、compat.thinkingFormat 與 compat.supportedReasoningEfforts。只有在已設定的請求合約支援相符的承載內容時，才使用這些資訊公開二元或自訂設定檔。
  • 需要驗證明確思考覆寫的工具外掛應使用 api.runtime.agent.resolveThinkingPolicy({ provider, model, agentRuntime }) 搭配 api.runtime.agent.normalizeThinkingLevel(...)；不應自行維護提供者／模型層級清單。當工具擁有執行路徑時（例如永遠嵌入式的執行），請傳入 agentRuntime。
  • 可存取已設定自訂模型中繼資料的工具外掛，可以將 catalog 傳入 resolveThinkingPolicy，使 compat.supportedReasoningEfforts 的選擇啟用反映在外掛端驗證中。
  • 已發布的舊版掛鉤（supportsXHighThinking、isBinaryThinking 與 resolveDefaultThinkingLevel）會保留作為相容性配接器，但新的自訂層級集合應使用 resolveThinkingProfile。
  • 閘道資料列／預設值會公開 thinkingLevels、thinkingOptions 與 thinkingDefault，讓 ACP／聊天用戶端呈現與執行階段驗證所用內容相同的設定檔 ID 與標籤。
Was this useful?
On this page

On this page