> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/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 | ultra`，大致对应 Anthropic 经典 “think” \< “think hard” \< “think harder” \< “ultrathink” 的魔法词阶梯：
  * minimal \~ “think”
  * low \~ “think hard”
  * medium \~ “think harder”
  * high \~ “ultrathink”（最大预算）
  * xhigh \~ “ultrathink+”（GPT-5.2+ 和 Codex models，以及 Anthropic Claude Opus 4.7+ effort）
  * adaptive → provider-managed 自适应思考（Anthropic/Bedrock 上的 Claude 4.6、Anthropic Claude Opus 4.7+ 和 Google Gemini dynamic thinking 支持）
  * max → provider max reasoning（Anthropic Claude Opus 4.7+；Ollama 将其映射为其最高原生 `think` effort）
  * ultra → provider max reasoning，并在所选 model/runtime 支持时启用主动式 sub-agent 编排
  * `x-high`、`x_high`、`extra-high`、`extra high` 和 `extra_high` 映射到 `xhigh`。
  * `highest` 映射到 `high`。
* Provider 说明：
  * Thinking 菜单和选择器由 provider profile 驱动。Provider plugins 会为所选 model 声明确切的级别集合，包括二元 `on` 等标签。
  * 只有支持这些级别的 provider/model/runtime profile 才会展示 `adaptive`、`xhigh`、`max` 和 `ultra`。对于不支持级别的类型化指令，会根据该 model 的有效选项拒绝请求。
  * 已存储的不支持级别会根据 provider profile rank 重新映射。在不支持自适应思考的 model 上，`adaptive` 会回退到 `medium`；而 `xhigh` 和 `max` 会回退到所选 model 支持的最大非 off 级别。
  * 未显式设置 thinking 级别时，Anthropic Claude 4.6 models 默认使用 `adaptive`。
  * Anthropic Claude Opus 4.8 和 Opus 4.7 在未显式设置 thinking 级别时保持关闭。启用自适应思考后，Opus 4.8 的 provider-owned effort 默认值为 `high`。
  * Anthropic Claude Opus 4.7+ 会将 `/think xhigh` 映射为自适应思考加上 `output_config.effort: "xhigh"`，因为 `/think` 是 thinking directive，而 `xhigh` 是 Opus 的 effort 设置。
  * Anthropic Claude Opus 4.7+ 还支持 `/think max`；它会映射到相同的 provider-owned max effort 路径。
  * Direct DeepSeek V4 models 支持 `/think xhigh|max`；两者都会映射到 DeepSeek 的 `reasoning_effort: "max"`，而较低的非 off 级别会映射到 `high`。
  * 通过 OpenRouter 路由的 DeepSeek V4 models 支持 `/think xhigh`，并发送 OpenRouter 支持的 `reasoning.effort` 值，而不是 DeepSeek 原生顶层的 `reasoning_effort`。较低的非 off 级别会映射到 `high`，而已存储的 `max` 覆盖值会回退到 `xhigh`。
  * 支持 thinking 的 Ollama models 支持 `/think low|medium|high|max`。经过验证的完整 effort Ollama Cloud families（例如 GLM 5.2 和 DeepSeek V4）会发送每个匹配的原生 `think` effort，包括 `max`；其他 models 和本地 Ollama 会将 `/think max` 保持为兼容的 `high` 映射。
  * OpenAI GPT models 会根据 model-specific Responses API effort 支持映射 `/think`。只有当目标 model 支持时，`/think off` 才会发送 `reasoning.effort: "none"`；否则 OpenClaw 会省略已禁用的 reasoning payload，而不是发送不支持的值。
  * GPT-5.6 Sol 和 Terra 通过 Codex runtime 原生支持 `/think ultra`。GPT-5.6 Luna 通过 `max` 暴露级别，因为其 Codex catalog 未声明 Ultra。
  * 内嵌的 OpenClaw runtime 为 GPT-5.6 Sol、Terra 和 Luna 暴露逻辑上的 `/think ultra`。它会发送 provider max effort，并添加运行范围内的主动式 sub-agent 编排指导。
  * 自定义的 OpenAI-compatible catalog entries 可以通过将 `"xhigh"` 添加到 `models.providers.<provider>.models[].compat.supportedReasoningEfforts` 来选择启用 `/think xhigh`。这使用与映射出站 OpenAI reasoning effort payload 相同的 compat metadata，因此菜单、session validation、agent CLI 和 `llm-task` 会与传输行为保持一致。
  * 过时的已配置 OpenRouter Hunter Alpha refs 会跳过 proxy reasoning 注入，因为该已退役路由可能会通过 reasoning fields 返回最终答案文本。
  * Google Gemini 会将 `/think adaptive` 映射为 Gemini 的 provider-owned dynamic thinking。Gemini 3 requests 会省略固定的 `thinkingLevel`，而 Gemini 2.5 requests 会发送 `thinkingBudget: -1`；固定级别仍会映射到对应 model family 最接近的 Gemini `thinkingLevel` 或 budget。
  * Anthropic-compatible streaming path 上的 MiniMax M2.x（`minimax/MiniMax-M2*`）默认使用 `thinking: { type: "disabled" }`，除非你在 model params 或 request params 中显式设置 thinking。这可以避免 M2.x 的非原生 Anthropic stream format 泄露 `reasoning_content` deltas。MiniMax-M3（以及 M3.x）不受此限制：M3 会输出正确的 Anthropic thinking blocks，并在 thinking 被禁用时返回空 content，因此 OpenClaw 会让 M3 保持 provider 的 omitted/adaptive thinking path。
  * Z.AI（`zai/*`）对于大多数 GLM models 是二元的（`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` field 和固定 sampling overrides，并保留 K3 支持的 tool choices。Kimi Code K3（`kimi/k3` 和 `kimi/k3-256k`）支持完整的 `/think` 梯度，默认值为 `high`：`off` 发送 `thinking.type: "disabled"`，`minimal`/`low` 映射到 low effort，`medium`/`high`/`adaptive` 映射到 high effort，而 `xhigh`/`max` 映射到 max effort。当前的 Kimi Code refs 还包括 `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/*` models 会将 `/think off` 映射为 `thinking: { type: "disabled" }`，并将任何非 `off` 级别映射为 `thinking: { type: "enabled" }`。启用 K2 thinking 时，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` 会存储一个显式的 off 覆盖。它会禁用 thinking，直到你更改或清除该会话覆盖。
* 会发送确认回复（`Thinking level set to high.` / `Thinking disabled.`）。如果级别无效（例如 `/thinking big`），命令会被拒绝并给出提示，同时会话状态保持不变。
* 发送不带参数的 `/think`（或 `/think:`）即可查看当前 thinking 级别。

## 按 agent 应用

* **嵌入式 OpenClaw**：解析后的等级会传递给进程内的 OpenClaw agent 运行时。
* **Claude CLI 后端**：具体的非 off 等级在使用 `claude-cli` 时会作为 `--effort` 传递给 Claude Code；`adaptive` 会移除已配置的 effort 标志，并将实际 effort 交由 Claude Code 的环境、设置和模型默认值决定。参见 [CLI 后端](/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` 覆盖设置
  2. 仅包含指令的消息中存储的会话覆盖设置（`/fast default` 会清除这一层）
  3. Agent 级默认值（`agents.entries.*.fastModeDefault`）
  4. 全局默认值（`agents.defaults.fastModeDefault`）
  5. 按模型配置（`agents.defaults.models["<provider>/<model>"].params.fastMode`）
  6. 回退值：`off`
* 有效的模型范围 `params.fastMode` / `params.fast_mode` 值和有效的截止时间键属于类型化的 Agent 运行时控制项。它们不计入作者编写的 provider 请求参数，也不会自行选择 OpenClaw 或 Codex。当配方依赖某个运行时时，请固定设置 `agentRuntime.id: "openclaw"` 或 `agentRuntime.id: "codex"`。
* `auto` 会将会话/配置模式保持为 auto，但会独立解析每次新的模型调用。在自动截止时间之前开始的调用会启用快速模式；之后的重试、回退、工具结果或续接调用则会在快速模式禁用的情况下开始。截止时间默认为 60 秒；在活动模型上设置 `agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds` 可修改此值。
* 对于 `openai/*`，快速模式映射到 OpenAI API 快速模式（原称 Priority processing）。OpenClaw 当前会在受支持的 Responses 请求中发送 `service_tier=priority`。
* 在 Codex harness 回合中，共享运行时控制会优先于已配置的原生 app-server tier：快速模式开启时发送 `priority`，快速模式关闭时发送 `null` 以清除由 OpenClaw 所拥有的 tier，而 auto 则会为每次模型调用单独决定。仅当没有提供共享快速模式运行控制时，才会使用已配置的 Codex tier。请参阅 [Codex harness](/plugins/codex-harness#shared-fast-mode-and-codex-fast-mode)。
* 对于直接的公开 `anthropic/*` 请求，包括发送至 `api.anthropic.com` 的 OAuth 身份验证流量，快速模式会映射到 Anthropic 服务 tier：`/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 服务 tier 注入。
* `/status` 会报告已解析的 OpenClaw 策略（`on`、`off` 或 `auto`）以及所选运行时。它不会报告已完成请求实际采用或返回的上游服务 tier。有关 provider 详细信息，请参阅 [OpenAI 快速模式](/providers/openai#advanced-configuration)。

## 详细日志指令（/verbose 或 /v）

* 级别：`on`（最简）| `full` | `off`（默认）。
* 仅包含指令的消息会切换会话详细日志，并回复 `Verbose logging enabled.` / `Verbose logging disabled.`；无效级别会返回提示，但不会更改状态。
* `/verbose off` 会存储显式的会话覆盖设置；通过 Sessions UI 选择 `inherit` 可清除该设置。
* 授权的外部频道发送者可以持久化会话详细日志覆盖设置。Internal gateway/webchat clients 需要 `operator.admin` 才能持久化该设置。
* 内联指令只影响该消息；其他情况下应用会话／全局默认设置。
* 发送不带参数的 `/verbose`（或 `/verbose:`）以查看当前详细日志级别。
* 当详细日志开启时，发送结构化工具结果的 agents 会将每次工具调用作为单独的、仅包含安全元数据的消息发回。Shell 工具会显示其标签，但不会显示命令文本。这些工具摘要会在每个工具启动后立即发送（作为单独的气泡），而不是作为流式增量发送。
* 工具失败摘要在普通模式下仍然可见，但原始错误详细信息后缀只有在详细日志为 `full` 时才会显示。
* 当详细日志为 `full` 时，工具输出也会在完成后转发（作为单独的气泡，并截断至安全长度）。如果在运行进行中切换 `/verbose on|full|off`，后续工具气泡会遵循新的设置。
* `agents.defaults.toolProgressDetail` 控制 `/verbose` 工具摘要和进度草稿工具行的格式。使用 `"explain"`（默认）获取简洁的人类可读标签，使用 `"raw"` 获取未删节的非 Shell 详细信息。独立 Shell 摘要需要 `/verbose full` 才能显示命令文本；进度草稿需要频道显式选择加入 `streaming.*.commandText: "raw"`。每个 agent 的 `agents.entries.*.toolProgressDetail` 会覆盖默认设置。
  * `/verbose on`：`🛠️ Exec`
  * `/verbose full` + `explain`：`🛠️ Exec: check JS syntax for /tmp/app.js`
  * `/verbose full` + `raw`：`🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js`

## 插件追踪指令（/trace）

* 级别：`on` | `off`（默认）。
* 仅包含指令的消息会切换会话插件追踪输出并回复 `插件追踪已启用。` / `插件追踪已禁用。`。
* 内联指令只影响该消息；否则会应用会话/全局默认值。
* 发送不带参数的 `/trace`（或 `/trace:`）可查看当前追踪级别。
* `/trace` 比 `/verbose` 更窄：它只暴露插件拥有的追踪/调试行，例如 Active Memory 调试摘要。
* 追踪行可以出现在 `/status` 中，也可以作为正常 assistant 回复后的后续诊断消息出现。

## 推理可见性（/reasoning）

* 层级：`on|off|stream`。
* 仅指令消息会切换回复中是否显示思考块。
* 启用后，推理会作为一条**单独的消息**发送，并以前缀 `Thinking` 开头。
* `stream`：当当前通道支持推理预览时，会在回复生成过程中流式传输推理，然后发送不包含推理的最终答案。
* 别名：`/reason`。
* 发送不带参数的 `/reasoning`（或 `/reasoning:`）可查看当前推理级别。
* 解析顺序：行内指令，其次会话覆盖，然后每个 agent 的默认值（`agents.entries.*.reasoningDefault`），再然后全局默认值（`agents.defaults.reasoningDefault`），最后回退到（`off`）。

对格式错误的本地模型 reasoning 标签会采取保守处理。已闭合的 `<think>...</think>` 块在正常回复中会保持隐藏，而在已显示文本之后出现的未闭合 reasoning 也会被隐藏。如果一条回复完全包裹在一个未闭合的起始标签中，并且否则会以空文本交付，OpenClaw 会移除格式错误的起始标签并交付剩余文本。

## 相关

* 提升模式文档位于 [提升模式](/tools/elevated)。

## 心跳

* 心跳探测正文是已配置的心跳提示词（默认值：`在提供心跳监控暂存上下文时，遵循该上下文。重复性任务属于自动化任务；请使用自动化工具创建或更改其计划，而不是使用心跳暂存。不要从之前的聊天中推断或重复旧任务。如果没有需要处理的事项，请回复 HEARTBEAT_OK。`）。心跳消息中的内联指令照常适用（但应避免通过心跳更改会话默认设置）。
* 心跳传递使用最近一次具备出站能力的非推理载荷。单独的推理或 `Thinking` 载荷仍保留在内部，而仅包含推理的心跳结果不会产生提醒。

## Web 聊天 UI

* Web 聊天的思考级别选择器会在页面加载时，镜像入站会话存储／配置中的会话已存储级别。
* 选择其他级别会通过 `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/chat 客户端渲染与运行时校验相同的配置文件 id 和 label。