---
read_when:
    - thinking、fast-mode、verbose ディレクティブの解析またはデフォルトの調整
summary: /think、/fast、/verbose、/trace のディレクティブ構文と推論の可視性
title: 思考レベル
x-i18n:
    generated_at: "2026-05-10T19:56:24Z"
    model: gpt-5.5
    provider: openai
    source_hash: c75e2360a260aaf4571f2da6c7519fb4987e4c8c7947e3dc37f94a0ad260ad55
    source_path: tools/thinking.md
    workflow: 16
---

## 機能

- 任意の受信本文内のインラインディレクティブ: `/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 → プロバイダー管理の 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.7 は adaptive thinking をデフォルトにしません。thinking レベルを明示的に設定しない限り、その API effort のデフォルトはプロバイダー所有のままです。
  - Anthropic Claude Opus 4.7 は `/think xhigh` を adaptive thinking と `output_config.effort: "xhigh"` にマップします。これは `/think` が thinking ディレクティブであり、`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 の 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 ペイロードをマップするものと同じ compat メタデータを使用するため、メニュー、セッション検証、エージェント 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（`minimax/*`）は、モデルパラメーターまたはリクエストパラメーターで thinking を明示的に設定しない限り、デフォルトで `thinking: { type: "disabled" }` になります。これにより、MiniMax の非ネイティブ Anthropic ストリーム形式から `reasoning_content` デルタが漏れることを避けます。
  - Z.AI（`zai/*`）は binary thinking（`on`/`off`）のみをサポートします。非 `off` レベルはすべて `on` として扱われます（`low` にマップ）。
  - Moonshot（`moonshot/*`）は `/think off` を `thinking: { type: "disabled" }` に、非 `off` レベルをすべて `thinking: { type: "enabled" }` にマップします。thinking が有効な場合、Moonshot は `tool_choice` `auto|none` のみを受け付けます。OpenClaw は互換性のない値を `auto` に正規化します。

## 解決順序

1. メッセージ上のインラインディレクティブ（そのメッセージにのみ適用）。
2. セッションオーバーライド（ディレクティブのみのメッセージ送信で設定）。
3. エージェントごとのデフォルト（設定内の `agents.list[].thinkingDefault`）。
4. グローバルデフォルト（設定内の `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`）、コマンドはヒント付きで拒否され、セッション状態は変更されません。
- 現在の thinking レベルを確認するには、引数なしで `/think`（または `/think:`）を送信します。

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

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

## 高速モード（/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. エージェントごとのデフォルト（`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 は両方の認証パスで共有される 1 つの `/fast` トグルを維持します。
- 直接の公開 `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` モデルパラメーターは、両方が設定されている場合に高速モードのデフォルトをオーバーライドします。OpenClaw は引き続き、非 Anthropic プロキシベース URL では Anthropic サービスティア注入をスキップします。
- `/status` は、高速モードが有効な場合にのみ `Fast` を表示します。

## 詳細ディレクティブ（/verbose または /v）

- レベル: `on`（最小）| `full` | `off`（デフォルト）。
- ディレクティブのみのメッセージはセッション verbose を切り替え、`Verbose logging enabled.` / `Verbose logging disabled.` と返信します。無効なレベルは状態を変更せずにヒントを返します。
- `/verbose off` は明示的なセッションオーバーライドを保存します。Sessions UI で `inherit` を選択してクリアします。
- インラインディレクティブはそのメッセージにのみ影響します。それ以外の場合はセッション/グローバルデフォルトが適用されます。
- 現在の verbose レベルを確認するには、引数なしで `/verbose`（または `/verbose:`）を送信します。
- verbose がオンの場合、構造化ツール結果を出力するエージェント（Pi、その他の JSON エージェント）は、各ツール呼び出しをそれぞれ独自のメタデータのみのメッセージとして送り返し、利用可能な場合は `<emoji> <tool-name>: <arg>` というプレフィックスを付けます。これらのツール要約は、各ツール開始時にすぐ送信されます（別々の吹き出し）。ストリーミングデルタとしては送信されません。
- ツール失敗の要約は通常モードでも表示され続けますが、生のエラー詳細サフィックスは verbose が `on` または `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 デバッグ要約など、Plugin 所有のトレース/デバッグ行のみを公開します。
- トレース行は `/status` に表示される場合があり、通常のアシスタント返信後にフォローアップ診断メッセージとして表示される場合もあります。

## Reasoning の表示（/reasoning）

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

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

## 関連

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

## Web チャット UI

- Webチャットの思考セレクターは、ページ読み込み時に受信セッションのストア/設定からセッションに保存されたレベルを反映します。
- 別のレベルを選択すると、`sessions.patch` によってセッションのオーバーライドが即座に書き込まれます。次回送信を待つことはなく、一回限りの `thinkingOnce` オーバーライドでもありません。
- 最初のオプションは常にオーバーライド解除の選択肢です。セッションがオフ以外の有効なデフォルトを継承している場合は `Inherited: <resolved level>` と表示され、継承された思考が無効な場合は `Off` と表示されます。
- 明示的なピッカーの選択肢はオーバーライドとしてラベル付けされます。その際、プロバイダーのラベルが存在する場合は保持されます（たとえば、プロバイダーがラベル付けした `max` オプションには `Override: 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" }` を使用します。
- 明示的な思考オーバーライドを検証する必要があるツール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とラベルをレンダリングします。