組み込みツール
思考レベル
機能
- 任意の受信本文内でのインラインディレクティブ:
/t <レベル>、/think:<レベル>、または/thinking <レベル>。 - レベル(エイリアス):
off | minimal | low | medium | high | xhigh | adaptive- minimal → “think”
- low → “think hard”
- medium → “think harder”
- high → “ultrathink” (最大予算)
- xhigh → “ultrathink+” (GPT-5.2 + Codex モデルのみ)
- adaptive → プロバイダー管理の適応型推論予算 (Anthropic Claude 4.6 モデルファミリーでサポート)
x-high、x_high、extra-high、extra high、extra_highはxhighにマップされます。highest、maxはhighにマップされます。
- プロバイダーに関する注意:
- Anthropic Claude 4.6 モデルは、明示的な思考レベルが設定されていない場合、デフォルトで
adaptiveになります。 - Z.AI (
zai/*) はバイナリ思考 (on/off) のみをサポートします。off以外のレベルはすべてon(lowにマップ) として扱われます。 - Moonshot (
moonshot/*) は/think offをthinking: { type: "disabled" }に、off以外のレベルをthinking: { type: "enabled" }にマップします。思考が有効な場合、Moonshot はtool_choiceauto|noneのみを受け入れます。OpenClaw は互換性のない値をautoに正規化します。
- Anthropic Claude 4.6 モデルは、明示的な思考レベルが設定されていない場合、デフォルトで
解決順序
- メッセージ上のインラインディレクティブ (そのメッセージにのみ適用)。
- セッションオーバーライド (ディレクティブのみのメッセージを送信して設定)。
- グローバルデフォルト (設定内の
agents.defaults.thinkingDefault)。 - フォールバック: Anthropic Claude 4.6 モデルでは
adaptive、その他の推論可能モデルではlow、それ以外ではoff。
セッションデフォルトの設定
- ディレクティブのみのメッセージ (空白可) を送信します。例:
/think:mediumまたは/t high。 - これは現在のセッション (デフォルトでは送信者ごと) に保持されます。
/think:offまたはセッションのアイドルリセットでクリアされます。 - 確認応答が送信されます (
Thinking level set to high./Thinking disabled.)。レベルが無効な場合 (例:/thinking big)、コマンドはヒント付きで拒否され、セッション状態は変更されません。 - 引数なしで
/think(または/think:) を送信すると、現在の思考レベルを確認できます。
エージェントによる適用
- Embedded Pi: 解決されたレベルは、プロセス内の Pi エージェントランタイムに渡されます。
詳細ディレクティブ (/verbose または /v)
- レベル:
on(最小) |full|off(デフォルト)。 - ディレクティブのみのメッセージはセッションの詳細ログを切り替え、
Verbose logging enabled./Verbose logging disabled.と返信します。無効なレベルは状態を変更せずにヒントを返します。 /verbose offは明示的なセッションオーバーライドを保存します。Sessions UI でinheritを選択してクリアしてください。- インラインディレクティブはそのメッセージにのみ影響します。それ以外の場合はセッション/グローバルデフォルトが適用されます。
- 引数なしで
/verbose(または/verbose:) を送信すると、現在の詳細レベルを確認できます。 - 詳細ログがオンの場合、構造化されたツール結果を出力するエージェント (Pi、その他の JSON エージェント) は、各ツール呼び出しを独自のメタデータのみのメッセージとして送り返し、利用可能な場合 (パス/コマンド) は
<絵文字> <ツール名>: <引数>をプレフィックスとして付けます。これらのツール要約は、各ツールが開始するとすぐに (個別のバブルとして) 送信され、ストリーミングデルタとしては送信されません。 - ツール失敗の要約は通常モードでも表示されますが、生のエラー詳細のサフィックスは、詳細ログが
onまたはfullでない限り非表示になります。 - 詳細ログが
fullの場合、ツール出力も完了後に転送されます (個別のバブル、安全な長さに切り詰められます)。実行中に/verbose on|full|offを切り替えた場合、後続のツールバブルは新しい設定を尊重します。
推論の可視性 (/reasoning)
- レベル:
on|off|stream。 - ディレクティブのみのメッセージは、返信に思考ブロックを表示するかどうかを切り替えます。
- 有効にすると、推論は
Reasoning:をプレフィックスとした別のメッセージとして送信されます。 stream(Telegram のみ): 返信の生成中に推論を Telegram の下書きバブルにストリーミングし、最終的な回答を推論なしで送信します。- エイリアス:
/reason。 - 引数なしで
/reasoning(または/reasoning:) を送信すると、現在の推論レベルを確認できます。
関連項目
- 昇格モードのドキュメントは 昇格モード にあります。
ハートビート
- ハートビートプローブの本文は、設定されたハートビートプロンプト (デフォルト:
HEARTBEAT.md が存在する場合は読み込んでください (ワークスペースコンテキスト)。厳密に従ってください。以前のチャットからの古いタスクを推測したり繰り返したりしないでください。注意が必要なものがなければ、HEARTBEAT_OK と返信してください。) です。ハートビートメッセージ内のインラインディレクティブは通常通り適用されます (ただし、ハートビートからセッションデフォルトを変更することは避けてください)。 - ハートビートの配信は、デフォルトで最終ペイロードのみです。利用可能な場合に別の
Reasoning:メッセージも送信するには、agents.defaults.heartbeat.includeReasoning: trueまたはエージェントごとにagents.list[].heartbeat.includeReasoning: trueを設定します。
Web チャット UI
- Web チャットの思考セレクターは、ページ読み込み時に受信セッションストア/設定から保存されたセッションレベルを反映します。
- 別のレベルを選択すると、次のメッセージ (
thinkingOnce) にのみ適用されます。送信後、セレクターは保存されたセッションレベルに戻ります。 - セッションデフォルトを変更するには、
/think:<レベル>ディレクティブを (以前と同様に) 送信します。セレクターは次回のリロード後にそれを反映します。