> ## 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`。おおよそ 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 → プロバイダー管理の adaptive thinking (Anthropic/Bedrock の Claude 4.6、Anthropic Claude Opus 4.7+、および Google Gemini dynamic thinking で対応)
  * max → プロバイダー最大 reasoning (Anthropic Claude Opus 4.7+。Ollama はこれをネイティブの最高 `think` effort にマップ)
  * `x-high`、`x_high`、`extra-high`、`extra high`、および `extra_high` は `xhigh` にマップされます。
  * `highest` は `high` にマップされます。
* プロバイダーに関する注記:
  * Thinking メニューとピッカーはプロバイダープロファイルによって駆動されます。プロバイダー Plugin は、binary `on` などのラベルを含め、選択されたモデルの正確なレベルセットを宣言します。
  * `adaptive`、`xhigh`、`max` は、それらに対応するプロバイダー/モデルプロファイルでのみ表示されます。対応していないレベルの型付きディレクティブは、そのモデルで有効な選択肢とともに拒否されます。
  * 既存の保存済み未対応レベルは、プロバイダープロファイルの順位によって再マップされます。`adaptive` は非 adaptive モデルでは `medium` にフォールバックし、`xhigh` と `max` は選択されたモデルで対応する最大の非 off レベルにフォールバックします。
  * Anthropic Claude 4.6 モデルは、明示的な thinking レベルが設定されていない場合、デフォルトで `adaptive` になります。
  * Anthropic Claude Opus 4.8 と Opus 4.7 は、thinking レベルを明示的に設定しない限り thinking をオフのままにします。Opus 4.8 のプロバイダー所有 effort デフォルトは、adaptive thinking が有効化された後は `high` です。
  * Anthropic Claude Opus 4.7+ は `/think xhigh` を adaptive thinking と `output_config.effort: "xhigh"` にマップします。これは `/think` が thinking ディレクティブであり、`xhigh` が Opus の 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` を公開し、DeepSeek ネイティブのトップレベル `reasoning_effort` ではなく、OpenRouter 対応の `reasoning.effort` 値を送信します。より低い非 off レベルは `high` にマップされ、保存済みの `max` オーバーライドは `xhigh` にフォールバックします。
  * Ollama の thinking 対応モデルは `/think low|medium|high|max` を公開します。Ollama のネイティブ API は `low`、`medium`、`high` の effort 文字列を受け入れるため、`max` はネイティブの `think: "high"` にマップされます。
  * OpenAI GPT モデルは、モデル固有の Responses API effort 対応を通じて `/think` をマップします。`/think off` は対象モデルが対応している場合にのみ `reasoning.effort: "none"` を送信します。それ以外の場合、OpenClaw は未対応の値を送信する代わりに、無効化された reasoning ペイロードを省略します。
  * カスタム OpenAI 互換カタログエントリーは、`models.providers.<provider>.models[].compat.supportedReasoningEfforts` に `"xhigh"` を含めることで `/think xhigh` にオプトインできます。これは送信側 OpenAI reasoning effort ペイロードをマップするものと同じ互換メタデータを使用するため、メニュー、セッション検証、エージェント CLI、`llm-task` がトランスポート挙動と一致します。
  * 古い設定済みの OpenRouter Hunter Alpha 参照は、その廃止済みルートが reasoning フィールドを通じて最終回答テキストを返す可能性があったため、プロキシ reasoning 注入をスキップします。
  * Google Gemini は `/think adaptive` を Gemini のプロバイダー所有 dynamic thinking にマップします。Gemini 3 リクエストは固定の `thinkingLevel` を省略し、Gemini 2.5 リクエストは `thinkingBudget: -1` を送信します。固定レベルは引き続き、そのモデルファミリーに最も近い Gemini `thinkingLevel` または予算にマップされます。
  * Anthropic 互換ストリーミングパス上の MiniMax M2.x (`minimax/MiniMax-M2*`) は、モデルパラメーターまたはリクエストパラメーターで thinking を明示的に設定しない限り、デフォルトで `thinking: { type: "disabled" }` になります。これにより、M2.x の非ネイティブ Anthropic ストリーム形式から `reasoning_content` デルタが漏れることを避けます。MiniMax-M3 (および M3.x) は例外です。M3 は適切な Anthropic thinking ブロックを出力し、thinking が無効な場合は空の content を返すため、OpenClaw は M3 をプロバイダーの省略/adaptive thinking パスのままにします。
  * Z.AI (`zai/*`) はほとんどの GLM モデルで binary (`on`/`off`) です。GLM-5.2 は例外です。これは `/think off|low|high|max` を公開し、`low` と `high` を Z.AI `reasoning_effort: "high"` にマップし、`max` を `reasoning_effort: "max"` にマップします。
  * Moonshot Kimi K2.7 Code (`moonshot/kimi-k2.7-code`) は常に thinking します。そのプロファイルは `on` のみを公開し、OpenClaw は Moonshot が要求するとおり送信側 `thinking` フィールドを省略します。他の `moonshot/*` モデルは `/think off` を `thinking: { type: "disabled" }` にマップし、任意の非 `off` レベルを `thinking: { type: "enabled" }` にマップします。thinking が有効な場合、Moonshot は `tool_choice` `auto|none` のみを受け入れます。OpenClaw は互換性のない値を `auto` に正規化します。

## 解決順序

1. メッセージ上のインラインディレクティブ (そのメッセージにのみ適用)。
2. セッションオーバーライド (ディレクティブのみのメッセージを送信して設定)。
3. エージェントごとのデフォルト (config 内の `agents.list[].thinkingDefault`)。
4. グローバルデフォルト (config 内の `agents.defaults.thinkingDefault`)。
5. フォールバック: 利用可能な場合はプロバイダー宣言のデフォルト。それ以外の場合、reasoning 対応モデルは `medium` またはそのモデルで対応する最も近い非 `off` レベルに解決され、非 reasoning モデルは `off` のままです。

## セッションデフォルトの設定

* ディレクティブ**のみ**のメッセージを送信します (空白は許可)。例: `/think:medium` または `/t high`。
* これは現在のセッションに固定されます (デフォルトでは送信者ごと)。`/think default` を使用するとセッションオーバーライドをクリアし、設定済み/プロバイダーデフォルトを継承します。エイリアスには `inherit`、`clear`、`reset`、`unpin` があります。
* `/think off` は明示的な off オーバーライドを保存します。セッションオーバーライドを変更またはクリアするまで thinking を無効にします。
* 確認返信が送信されます (`Thinking level set to high.` / `Thinking disabled.`)。レベルが無効な場合 (例: `/thinking big`)、コマンドはヒント付きで拒否され、セッション状態は変更されません。
* 引数なしで `/think` (または `/think:`) を送信すると、現在の thinking レベルを確認できます。

## エージェントによる適用

* **組み込み OpenClaw**: 解決されたレベルは、インプロセス OpenClaw エージェントランタイムに渡されます。
* **Claude CLI バックエンド**: `claude-cli` を使用している場合、非 off レベルは `--effort` として Claude Code に渡されます。[CLI バックエンド](/ja-JP/gateway/cli-backends) を参照してください。

## 高速モード (/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.list[].fastModeDefault`)
  4. モデルごとの設定: `agents.defaults.models["<provider>/<model>"].params.fastMode`
  5. フォールバック: `off`
* `auto` はセッション/config モードを auto のままにしますが、新しい各モデル呼び出しを個別に解決します。auto カットオフ前に開始した呼び出しでは高速モードが有効になります。後続の retry、fallback、tool-result、または continuation 呼び出しは高速モード無効で開始します。カットオフのデフォルトは 60 秒です。変更するには、アクティブモデルで `agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds` を設定します。
* `openai/*` では、高速モードは対応する Responses リクエストで `service_tier=priority` を送信することで OpenAI priority processing にマップされます。
* Codex バックエンドの `openai/*` / `openai-codex/*` モデルでは、高速モードは Codex Responses に同じ `service_tier=priority` フラグを送信します。ネイティブ Codex app-server ターンは `turn/start` または thread start/resume の場合のみ tier を受け取るため、`auto` はすでに実行中の app-server ターンを再 tier 化できません。OpenClaw が開始する次のモデルターンに適用されます。
* OAuth 認証済みで `api.anthropic.com` に送信されるトラフィックを含む、直接の公開 `anthropic/*` リクエストでは、高速モードは 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` を、設定済みモードが auto の場合は `Fast:auto` を表示します。

## 詳細ディレクティブ (/verbose または /v)

* レベル: `on` (最小) | `full` | `off` (デフォルト)。
* ディレクティブのみのメッセージはセッション verbose を切り替え、`Verbose logging enabled.` / `Verbose logging disabled.` と返信します。無効なレベルは状態を変更せずにヒントを返します。
* `/verbose off` は明示的なセッションオーバーライドを保存します。Sessions UI で `inherit` を選択してクリアします。
* 認可された外部チャネル送信者は、セッション verbose オーバーライドを永続化できます。内部 Gateway/webchat クライアントが永続化するには `operator.admin` が必要です。
* インラインディレクティブはそのメッセージにのみ影響します。それ以外の場合はセッション/グローバルデフォルトが適用されます。
* 引数なしで `/verbose` (または `/verbose:`) を送信すると、現在の verbose レベルを確認できます。
* verbose が on の場合、構造化されたツール結果を出力するエージェントは、各ツール呼び出しをメタデータのみの独立したメッセージとして送り返します。利用可能な場合は `<emoji> <tool-name>: <arg>` が先頭に付きます。これらのツール要約は、ストリーミングデルタではなく、各ツールの開始直後に送信されます (別バブル)。
* ツール失敗の要約は通常モードでも表示されたままですが、生のエラー詳細サフィックスは verbose が `full` でない限り非表示になります。
* verbose が `full` の場合、ツール出力も完了後に転送されます (別バブル、安全な長さに切り詰め)。実行中に `/verbose on|full|off` を切り替えると、以後のツールバブルは新しい設定に従います。
* `agents.defaults.toolProgressDetail` は `/verbose` ツール要約と進捗ドラフトのツール行の形式を制御します。`🛠️ Exec: checking JS syntax` のようなコンパクトな人間向けラベルには `"explain"` (デフォルト) を使用します。デバッグのために生のコマンド/詳細も追加したい場合は `"raw"` を使用します。エージェントごとの `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` より範囲が狭く、Active Memory debug summaries などの Plugin 所有の trace/debug 行のみを公開します。
* トレース行は `/status` 内、および通常のアシスタント返信後のフォローアップ診断メッセージとして表示されることがあります。

## Reasoning の表示 (/reasoning)

* レベル: `on|off|stream`。
* ディレクティブのみのメッセージは、thinking ブロックを返信に表示するかどうかを切り替えます。
* 有効な場合、reasoning は `Thinking` というプレフィックス付きの**別メッセージ**として送信されます。
* `stream`: アクティブなチャネルが reasoning プレビューに対応している場合、返信生成中に reasoning をストリーミングし、その後 reasoning なしで最終回答を送信します。
* エイリアス: `/reason`。
* 引数なしで `/reasoning` (または `/reasoning:`) を送信すると、現在の reasoning レベルを確認できます。
* 解決順序: インラインディレクティブ、次にセッションオーバーライド、次にエージェントごとのデフォルト (`agents.list[].reasoningDefault`)、次にグローバルデフォルト (`agents.defaults.reasoningDefault`)、次にフォールバック (`off`)。

不正な形式のローカルモデル推論タグは保守的に処理されます。閉じられた `<think>...</think>` ブロックは通常の返信では非表示のままで、すでに表示されたテキストの後にある閉じられていない推論も非表示になります。返信全体が単一の閉じられていない開始タグで囲まれており、そのままだと空のテキストとして配信される場合、OpenClaw は不正な形式の開始タグを削除し、残りのテキストを配信します。

## 関連

* 昇格モードのドキュメントは [昇格モード](/ja-JP/tools/elevated) にあります。

## Heartbeat

* 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 の配信はデフォルトで最終ペイロードのみです。別個の `Thinking` メッセージ（利用可能な場合）も送信するには、`agents.defaults.heartbeat.includeReasoning: true` またはエージェントごとの `agents.list[].heartbeat.includeReasoning: true` を設定します。

## Web チャット UI

* Web チャットの思考セレクターは、ページ読み込み時に受信セッションストア/設定からセッションに保存されたレベルを反映します。
* 別のレベルを選択すると、`sessions.patch` を介してセッションの上書きが即座に書き込まれます。次回送信まで待たず、1 回限りの `thinkingOnce` 上書きでもありません。
* 最初のオプションは常に上書きをクリアする選択肢です。継承された思考が無効な場合の `Inherited: Off` を含め、`Inherited: <resolved level>` と表示されます。
* 明示的なピッカー選択では、プロバイダーラベルが存在する場合はそれを保持しつつ、直接のレベルラベルを使用します（たとえばプロバイダーラベル付きの `max` オプションでは `Maximum`）。
* ピッカーは Gateway セッション行/デフォルトから返される `thinkingLevels` を使用し、`thinkingOptions` はレガシーのラベル一覧として保持されます。ブラウザー UI は独自のプロバイダー正規表現リストを保持しません。モデル固有のレベルセットは Plugin が所有します。
* `/think:<level>` は引き続き機能し、同じ保存済みセッションレベルを更新するため、チャットディレクティブとピッカーは同期されたままになります。

## プロバイダープロファイル

* プロバイダー Plugin は、モデルがサポートするレベルとデフォルトを定義するために `resolveThinkingProfile(ctx)` を公開できます。
* Claude モデルをプロキシするプロバイダー Plugin は、直接の Anthropic カタログとプロキシカタログの整合性を保つために、`openclaw/plugin-sdk/provider-model-shared` の `resolveClaudeThinkingProfile(modelId)` を再利用する必要があります。
* 各プロファイルレベルには、保存される正規の `id`（`off`、`minimal`、`low`、`medium`、`high`、`xhigh`、`adaptive`、または `max`）があり、表示用の `label` を含めることができます。バイナリプロバイダーは `{ id: "low", label: "on" }` を使用します。
* プロファイルフックは、利用可能な場合、`reasoning`、`compat.thinkingFormat`、`compat.supportedReasoningEfforts` を含む統合済みカタログ情報を受け取ります。これらの情報を使用して、設定済みのリクエスト契約が対応するペイロードをサポートする場合にのみ、バイナリまたはカスタムプロファイルを公開してください。
* 明示的な思考上書きを検証する必要があるツール Plugin は、`api.runtime.agent.resolveThinkingPolicy({ provider, model })` と `api.runtime.agent.normalizeThinkingLevel(...)` を使用する必要があります。独自のプロバイダー/モデルレベル一覧を保持してはいけません。
* 設定済みカスタムモデルメタデータにアクセスできるツール Plugin は、`resolveThinkingPolicy` に `catalog` を渡すことで、`compat.supportedReasoningEfforts` のオプトインを Plugin 側の検証に反映できます。
* 公開済みのレガシーフック（`supportsXHighThinking`、`isBinaryThinking`、`resolveDefaultThinkingLevel`）は互換性アダプターとして残りますが、新しいカスタムレベルセットでは `resolveThinkingProfile` を使用する必要があります。
* Gateway 行/デフォルトは `thinkingLevels`、`thinkingOptions`、`thinkingDefault` を公開するため、ACP/チャットクライアントはランタイム検証で使用されるものと同じプロファイル ID とラベルをレンダリングします。