跳轉到主要內容

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.

​
功能

  • 在任何傳入本文中使用行內指令：/t <level>、/think:<level>，或 /thinking <level>。
  • 等級（別名）：off | minimal | low | medium | high | xhigh | adaptive | max
    • 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）
    • x-high、x_high、extra-high、extra high 和 extra_high 對應到 xhigh。
    • highest 對應到 high。
  • 供應商注意事項：
    • 思考選單與選擇器由供應商設定檔驅動。供應商 Plugin 會宣告所選模型的確切等級集，包括二元 on 等標籤。
    • 只有支援它們的供應商/模型設定檔才會顯示 adaptive、xhigh 和 max。對不支援等級輸入的指令會被拒絕，並顯示該模型的有效選項。
    • 既有儲存的不支援等級會依供應商設定檔排名重新對應。在非自適應模型上，adaptive 會退回到 medium，而 xhigh 和 max 會退回到所選模型支援的最大非 off 等級。
    • Anthropic Claude 4.6 模型在未明確設定思考等級時，預設為 adaptive。
    • Anthropic Claude Opus 4.7 不會預設為自適應思考。除非你明確設定思考等級，否則其 API effort 預設值仍由供應商擁有。
    • Anthropic Claude Opus 4.7 會將 /think xhigh 對應到自適應思考加上 output_config.effort: "xhigh"，因為 /think 是思考指令，而 xhigh 是 Opus 4.7 的 effort 設定。
    • Anthropic Claude Opus 4.7 也公開 /think max；它會對應到相同的供應商擁有最大 effort 路徑。
    • 直接 DeepSeek V4 模型會公開 /think xhigh|max；兩者都對應到 DeepSeek reasoning_effort: "max"，而較低的非 off 等級則對應到 high。
    • 經 OpenRouter 路由的 DeepSeek V4 模型會公開 /think xhigh，並傳送 OpenRouter 支援的 reasoning_effort 值。儲存的 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 會省略已停用的推理 payload，而不是傳送不支援的值。
    • 自訂 OpenAI 相容目錄項目可透過將 models.providers.<provider>.models[].compat.supportedReasoningEfforts 設為包含 "xhigh"，選擇加入 /think xhigh。這會使用相同的相容性中繼資料來對應傳出的 OpenAI 推理 effort payload，因此選單、工作階段驗證、agent CLI 和 llm-task 會與傳輸行為一致。
    • 過時的已設定 OpenRouter Hunter Alpha refs 會略過代理推理注入，因為該已退役路由可能透過推理欄位傳回最終答案文字。
    • Google Gemini 會將 /think adaptive 對應到 Gemini 的供應商擁有動態思考。Gemini 3 請求會省略固定的 thinkingLevel，而 Gemini 2.5 請求會傳送 thinkingBudget: -1；固定等級仍會對應到該模型系列最接近的 Gemini thinkingLevel 或預算。
    • Anthropic 相容串流路徑上的 MiniMax (minimax/*) 預設為 thinking: { type: "disabled" }，除非你在模型參數或請求參數中明確設定思考。這可避免從 MiniMax 的非原生 Anthropic 串流格式洩漏 reasoning_content 增量。
    • Z.AI (zai/*) 僅支援二元思考（on/off）。任何非 off 等級都會被視為 on（對應到 low）。
    • Moonshot (moonshot/*) 會將 /think off 對應到 thinking: { type: "disabled" }，並將任何非 off 等級對應到 thinking: { type: "enabled" }。啟用思考時，Moonshot 只接受 tool_choice auto|none；OpenClaw 會將不相容的值正規化為 auto。

​
解析順序

  1. 訊息上的行內指令（僅套用到該訊息）。
  2. 工作階段覆寫（透過傳送只有指令的訊息來設定）。
  3. 每個 agent 的預設值（設定中的 agents.list[].thinkingDefault）。
  4. 全域預設值（設定中的 agents.defaults.thinkingDefault）。
  5. 後援：可用時使用供應商宣告的預設值；否則具推理能力的模型會解析為 medium 或該模型最接近且支援的非 off 等級，而非推理模型則維持 off。

​
設定工作階段預設值

  • 傳送只有指令的訊息（允許空白），例如 /think:medium 或 /t high。
  • 這會固定在目前工作階段（預設依傳送者區分）。使用 /think default 清除工作階段覆寫，並繼承已設定/供應商預設值；別名包括 inherit、clear、reset 和 unpin。
  • /think off 會儲存明確的 off 覆寫。它會停用思考，直到你變更或清除工作階段覆寫。
  • 會傳送確認回覆（Thinking level set to high. / Thinking disabled.）。如果等級無效（例如 /thinking big），指令會被拒絕並提供提示，工作階段狀態保持不變。
  • 傳送沒有引數的 /think（或 /think:）以查看目前的思考等級。

​
依 agent 套用

  • 嵌入式 Pi：解析後的等級會傳遞到處理序內 Pi agent 執行階段。
  • Claude CLI 後端：使用 claude-cli 時，非 off 等級會以 --effort 傳遞給 Claude Code；請參閱 CLI 後端。

​
快速模式（/fast）

  • 等級：on|off|default。
  • 只有指令的訊息會切換工作階段快速模式覆寫，並回覆 Fast mode enabled. / Fast mode disabled.。使用 /fast default 清除工作階段覆寫，並繼承已設定的預設值；別名包括 inherit、clear、reset 和 unpin。
  • 傳送沒有模式的 /fast（或 /fast status）以查看目前有效的快速模式狀態。
  • OpenClaw 會依以下順序解析快速模式：
    1. 行內/只有指令的 /fast on|off 覆寫（/fast default 會清除此層）
    2. 工作階段覆寫
    3. 每個 agent 的預設值（agents.list[].fastModeDefault）
    4. 每個模型設定：agents.defaults.models["<provider>/<model>"].params.fastMode
    5. 後援：off
  • 對於 openai/*，快速模式會在支援的 Responses 請求上傳送 service_tier=priority，對應到 OpenAI 優先處理。
  • 對於 openai-codex/*，快速模式會在 Codex Responses 上傳送相同的 service_tier=priority 旗標。OpenClaw 會在兩個驗證路徑之間保留一個共用的 /fast 切換。
  • 對於直接公開的 anthropic/* 請求，包括傳送到 api.anthropic.com 的 OAuth 驗證流量，快速模式會對應到 Anthropic service tiers：/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 模型參數會覆寫快速模式預設值。OpenClaw 仍會對非 Anthropic 代理基底 URL 略過 Anthropic service-tier 注入。
  • /status 只有在啟用快速模式時才會顯示 Fast。

​
詳細指令（/verbose 或 /v）

  • 等級：on（最小）| full | off（預設）。
  • 只有指令的訊息會切換工作階段詳細記錄，並回覆 Verbose logging enabled. / Verbose logging disabled.；無效等級會傳回提示且不變更狀態。
  • /verbose off 會儲存明確的工作階段覆寫；可在 Sessions UI 中選擇 inherit 來清除它。
  • 行內指令只會影響該訊息；否則會套用工作階段/全域預設值。
  • 傳送沒有引數的 /verbose（或 /verbose:）以查看目前的詳細等級。
  • 啟用詳細模式時，會發出結構化工具結果的 agents（Pi、其他 JSON agents）會把每個工具呼叫作為各自的僅中繼資料訊息傳回；可用時前綴為 <emoji> <tool-name>: <arg>。這些工具摘要會在每個工具啟動時立即傳送（獨立對話泡泡），而不是作為串流增量。
  • 工具失敗摘要在一般模式下仍會顯示，但原始錯誤詳細資料尾碼會被隱藏，除非 detailed 為 on 或 full。
  • 當 detailed 為 full 時，工具輸出也會在完成後轉送（獨立對話泡泡，截斷到安全長度）。如果你在執行期間切換 /verbose on|full|off，後續工具對話泡泡會遵循新設定。
  • agents.defaults.toolProgressDetail 控制 /verbose 工具摘要與進度草稿工具行的形狀。使用 "explain"（預設）取得精簡的人類可讀標籤，例如 🛠️ Exec: checking JS syntax；若你也想附加原始命令/詳細資料以便除錯，請使用 "raw"。每個 agent 的 agents.list[].toolProgressDetail 會覆寫預設值。
    • explain: 🛠️ Exec: check JS syntax for /tmp/app.js
    • raw: 🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js

​
Plugin 追蹤指令（/trace）

  • 等級：on | off（預設）。
  • 只有指令的訊息會切換工作階段 Plugin 追蹤輸出，並回覆 Plugin trace enabled. / Plugin trace disabled.。
  • 行內指令只會影響該訊息；否則會套用工作階段/全域預設值。
  • 傳送沒有引數的 /trace（或 /trace:）以查看目前的追蹤等級。
  • /trace 比 /verbose 範圍更窄：它只公開 Plugin 擁有的追蹤/除錯行，例如 Active Memory 除錯摘要。
  • 追蹤行可能出現在 /status 中，也可能在一般助理回覆後作為後續診斷訊息出現。

​
推理可見性（/reasoning）

  • 等級：on|off|stream。
  • 只有指令的訊息會切換回覆中是否顯示思考區塊。
  • 啟用時，推理會作為獨立訊息傳送，前綴為 Reasoning:。
  • stream（僅 Telegram）：在回覆產生時將推理串流到 Telegram 草稿對話泡泡，然後傳送不含推理的最終答案。
  • 別名：/reason。
  • 傳送沒有引數的 /reasoning（或 /reasoning:）以查看目前的推理等級。
  • 解析順序：行內指令，接著工作階段覆寫，接著每個 agent 的預設值（agents.list[].reasoningDefault），接著全域預設值（agents.defaults.reasoningDefault），最後是後援（off）。
格式錯誤的本機模型推理標籤會以保守方式處理。封閉的 <think>...</think> 區塊會在一般回覆中保持隱藏，且已可見文字之後未封閉的推理也會隱藏。如果回覆完全包在單一未封閉的起始標籤中，且否則會以空文字送出，OpenClaw 會移除格式錯誤的起始標籤並送出剩餘文字。

​
相關

​
Heartbeats

  • Heartbeat 探測本文是已設定的 Heartbeat 提示（預設：Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.）。Heartbeat 訊息中的行內指令會照常套用（但避免從 Heartbeat 變更工作階段預設值）。
  • Heartbeat 傳遞預設只傳送最終 payload。若也要傳送獨立的 Reasoning: 訊息（可用時），請設定 agents.defaults.heartbeat.includeReasoning: true 或每個 agent 的 agents.list[].heartbeat.includeReasoning: true。

​
網頁聊天 UI

  • 網頁聊天的思考選擇器會在頁面載入時，從傳入工作階段儲存區/設定中對應工作階段已儲存的層級。
  • 選擇另一個層級會立即透過 sessions.patch 寫入工作階段覆寫；它不會等到下一次傳送，也不是一次性的 thinkingOnce 覆寫。
  • 第一個選項永遠是清除覆寫的選項。當工作階段繼承非關閉的有效預設值時，它會顯示 Inherited: <resolved level>；當繼承的思考停用時，則顯示 Off。
  • 明確的選擇器選項會標示為覆寫，同時在有提供者標籤時保留提供者標籤（例如提供者標示為 max 的選項會顯示 Override: maximum）。
  • 選擇器使用 Gateway 工作階段列/預設值傳回的 thinkingLevels，並保留 thinkingOptions 作為舊版標籤清單。瀏覽器使用者介面不會保留自己的提供者正規表示式清單；Plugin 擁有模型專屬的層級集。
  • /think:<level> 仍可運作，並會更新相同的已儲存工作階段層級，因此聊天指令和選擇器會保持同步。

​
提供者設定檔

  • 提供者 Plugin 可以公開 resolveThinkingProfile(ctx)，用來定義模型支援的層級和預設值。
  • 代理 Claude 模型的提供者 Plugin 應重用 openclaw/plugin-sdk/provider-model-shared 中的 resolveClaudeThinkingProfile(modelId)，讓直接 Anthropic 和代理目錄保持一致。
  • 每個設定檔層級都有已儲存的標準 id（off、minimal、low、medium、high、xhigh、adaptive 或 max），並且可以包含顯示用 label。二元提供者使用 { id: "low", label: "on" }。
  • 需要驗證明確思考覆寫的工具 Plugin 應使用 api.runtime.agent.resolveThinkingPolicy({ provider, model }) 搭配 api.runtime.agent.normalizeThinkingLevel(...)；不應保留自己的提供者/模型層級清單。
  • 可存取已設定自訂模型中繼資料的工具 Plugin 可以將 catalog 傳入 resolveThinkingPolicy，讓 compat.supportedReasoningEfforts 選用項目反映在 Plugin 端驗證中。
  • 已發布的舊版鉤子（supportsXHighThinking、isBinaryThinking 和 resolveDefaultThinkingLevel）仍作為相容性配接器保留，但新的自訂層級集應使用 resolveThinkingProfile。
  • Gateway 列/預設值會公開 thinkingLevels、thinkingOptions 和 thinkingDefault，讓 ACP/聊天用戶端呈現與執行階段驗證相同的設定檔 id 和標籤。