跳转到内容
OpenClaw Docs

思考级别

作用

Section titled “作用”
  • 任何传入正文中的内联指令：/t <level>、/think:<level> 或 /thinking <level>。
  • 级别（别名）：off | minimal | low | medium | high | xhigh | adaptive | max
    • minimal → “think”
    • low → “think hard”
    • medium → “think harder”
    • high → “ultrathink” (max budget)
    • 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 努力程度）
    • x-high、x_high、extra-high、extra high 和 extra_high 映射至 xhigh。
    • highest 映射至 high。
  • 提供商注意事项：
    • 思考菜单和选择器由提供商配置文件驱动。提供商插件会为所选模型声明确切的级别集，包括诸如二进制 on 之类的标签。
    • adaptive、xhigh 和 max 仅针对支持它们的提供商/模型配置文件进行展示。对于不受支持的级别，输入的指令将被拒绝，并显示该模型的有效选项。
    • 现有的已存储的不受支持的级别会根据提供商配置文件排名重新映射。在非自适应模型上，adaptive 会回退至 medium，而 xhigh 和 max 会回退至所选模型支持的最大的非关闭级别。
    • 当未设置明确的思考级别时，Anthropic Claude 4.6 模型默认为 adaptive。
    • Anthropic Claude Opus 4.7 默认不采用自适应思考。除非您明确设置了思考级别，否则其 API 努力程度默认值仍由提供商拥有。
    • Anthropic Claude Opus 4.7 将 /think xhigh 映射至自适应思考加上 output_config.effort: "xhigh"，因为 /think 是思考指令，而 xhigh 是 Opus 4.7 的努力程度设置。
    • Anthropic Claude Opus 4.7 也暴露了 /think max；它映射到同一提供商拥有的最大努力路径。
    • Direct DeepSeek V4 模型暴露 /think xhigh|max；两者都映射到 DeepSeek reasoning_effort: "max"，而较低的非官方级别映射到 high。
    • OpenRouter-routed DeepSeek V4 模型暴露 /think xhigh 并发送 OpenRouter 支持的 reasoning_effort 值。存储的 max 覆盖回退到 xhigh。
    • Ollama thinking-capable 模型暴露 /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-compatible 目录条目可以通过设置 models.providers.<provider>.models[].compat.supportedReasoningEfforts 来包含 "xhigh" 从而选择加入 /think xhigh。这使用了映射出站 OpenAI reasoning effort payload 的相同兼容元数据，因此菜单、会话验证、agent CLI 和 llm-task 与传输行为一致。
    • 过时配置的 OpenRouter Hunter Alpha 引用会跳过代理推理注入，因为该已停用的路由可能会通过推理字段返回最终答案文本。
    • Google Gemini 将 /think adaptive 映射到 Gemini 提供商拥有的动态思考。Gemini 3 请求省略了固定的 thinkingLevel，而 Gemini 2.5 请求则发送 thinkingBudget: -1；固定级别仍然映射到该模型系列最接近的 Gemini thinkingLevel 或预算。
    • MiniMax (MiniMaxminimax/*Anthropic) 在 Anthropic 兼容的流式传输路径上默认为 thinking: { type: "disabled" }，除非您在模型参数或请求参数中显式设置了思考。这可以避免从 MiniMax 的非原生 Anthropic 流格式中泄漏 reasoning_contentMiniMaxAnthropic 增量。
    • Z.AI (zai/*) 仅支持二元思考（on/off）。任何非 off 级别都被视为 on（映射到 low）。
    • Moonshot (Moonshotmoonshot/*) 将 /think off 映射到 thinking: { type: "disabled" }，并将任何非 off 级别映射到 thinking: { type: "enabled" }Moonshot。当启用思考时，Moonshot 仅接受 tool_choice auto|noneOpenClaw；OpenClaw 会将不兼容的值标准化为 auto。

解析顺序

Section titled “解析顺序”
  1. 消息中的内联指令（仅适用于该消息）。
  2. 会话覆盖（通过发送仅包含指令的消息来设置）。
  3. 每个代理的默认值（配置中的 agents.list[].thinkingDefault）。
  4. 全局默认值（配置中的 agents.defaults.thinkingDefault）。
  5. 回退：如果可用，使用提供商声明的默认值；否则，具备推理能力的模型解析为 medium 或该模型支持的最近非 off 级别，而非推理模型保持 off。

设置会话默认值

Section titled “设置会话默认值”
  • 发送一条仅包含指令的消息（允许使用空格），例如 /think:medium 或 /t high。
  • 该设置在当前会话中保持有效（默认按发送者）。使用 /think default 清除会话覆盖并继承已配置/提供商的默认值；别名包括 inherit、clear、reset 和 unpin。
  • /think off 存储一个显式的关闭覆盖。它会禁用思考，直到您更改或清除会话覆盖。
  • 将发送确认回复（Thinking level set to high. / Thinking disabled.）。如果级别无效（例如 /thinking big），命令将被拒绝并提示，且会话状态保持不变。
  • 发送不带参数的 /think（或 /think:）以查看当前的思考级别。

由代理应用

Section titled “由代理应用”
  • 嵌入式 Pi：解析后的级别将传递给进程内 Pi 代理运行时。
  • Claude CLI 后端：非关闭级别在使用 claude-cli 时会作为 --effort 传递给 Claude Code；请参阅 CLI 后端。

快速模式 (/fast)

Section titled “快速模式 (/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/*OpenAI，快速模式通过在支持的 Responses 请求中发送 service_tier=priority，映射到 OpenAI 优先处理。
  • 对于 openai-codex/*，快速模式在 Codex Responses 上发送相同的 service_tier=priorityOpenClaw 标志。OpenClaw 在这两种身份验证路径之间保持一个共享的 /fast 切换开关。
  • 对于直接的公共 anthropic/*OAuth 请求，包括发送到 api.anthropic.comAnthropic 的 OAuth 身份验证流量，快速模式映射到 Anthropic 服务层级：/fast on 设置 service_tier=auto，/fast off 设置 service_tier=standard_only。
  • 对于 Anthropic 兼容路径上的 minimax/*Anthropic，/fast on（或 params.fastMode: true）会将 MiniMax-M2.7 重写为 MiniMax-M2.7-highspeed。
  • 当两者都设置时，显式的 Anthropic AnthropicserviceTier / service_tierOpenClawAnthropicAnthropic 模型参数会覆盖快速模式的默认值。对于非 Anthropic 代理基础 URL，OpenClaw 仍然跳过 Anthropic 服务层级的注入。
  • /status 仅在启用快速模式时显示 Fast。

详细指令（/verbose 或 /v）

Section titled “详细指令（/verbose 或 /v）”
  • 级别：on（最少）| full | off（默认）。
  • 仅包含指令的消息会切换会话的详细模式并回复 Verbose logging enabled. / Verbose logging disabled.；无效的级别将返回提示而不更改状态。
  • /verbose off 存储显式的会话覆盖；可以通过会话 UI 选择 inherit 来清除它。
  • 内联指令仅影响该条消息；否则应用会话/全局默认值。
  • 发送不带参数的 /verbose（或 /verbose:）以查看当前的详细级别。
  • 当 verbose 开启时，发出结构化工具结果（Pi、其他 JSON 代理）的代理会将每个工具调用作为仅包含元数据的消息发回，并在可用时以 <emoji> <tool-name>: <arg> 为前缀。这些工具摘要会在每个工具启动时立即发送（独立的气泡），而不是作为流式增量发送。
  • 工具失败摘要在正常模式下仍然可见，但原始错误详细后缀会被隐藏，除非 verbose 为 on 或 full。
  • 当 verbose 为 full 时，工具输出也会在完成后转发（独立的气泡，截断为安全长度）。如果在运行过程中切换 /verbose on|full|off，后续的工具气泡将遵循新设置。
  • agents.defaults.toolProgressDetail 控制 /verbose 工具摘要和进度草稿工具行的形状。使用 "explain"（默认）以获取紧凑的人类可读标签，例如 🛠️ Exec: checking JS syntax；当您还需要附加原始命令/详细信息以进行调试时，请使用 "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

插件跟踪指令 (/trace)

Section titled “插件跟踪指令 (/trace)”
  • 级别：on | off（默认）。
  • 仅包含指令的消息会切换会话插件跟踪输出并回复 Plugin trace enabled. / Plugin trace disabled.。
  • 内联指令仅影响该消息；否则适用会话/全局默认设置。
  • 发送不带参数的 /trace（或 /trace:）以查看当前的跟踪级别。
  • /trace 比 /verbose 更窄：它仅显示插件拥有的跟踪/调试行，例如活动内存 (Active Memory) 调试摘要。
  • 跟踪行可以出现在 /status 中，并作为正常助手回复之后的后续诊断消息出现。

推理可见性 (/reasoning)

Section titled “推理可见性 (/reasoning)”
  • 级别：on|off|stream。
  • 仅包含指令的消息会切换是否在回复中显示思维块。
  • 启用后，推理将作为以 Thinking 为前缀的单独消息发送。
  • stream（仅限 Telegram）：在生成回复的同时将推理内容流式传输到 Telegram 起草气泡中，然后发送不包含推理内容的最终回复。
  • 别名：/reason。
  • 发送不带参数的 /reasoning（或 /reasoning:）以查看当前的推理级别。
  • 解析顺序：内联指令，然后是会话覆盖，接着是每个代理的默认值（agents.list[].reasoningDefault），然后是全局默认值（agents.defaults.reasoningDefault），最后是回退值（off）。

格式错误的本地模型推理标签会被保守处理。已关闭的 <think>...</think> 块在正常回复中保持隐藏，并且在已可见文本之后未关闭的推理内容也会被隐藏。如果回复完全包含在一个单独的未闭合开始标签中，并且原本会作为空文本发送，OpenClaw 将移除该格式错误的开始标签并发送剩余的文本。

相关

Section titled “相关”

心跳

Section titled “心跳”
  • 心跳探测正文是配置的心跳提示词（默认：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.）。心跳消息中的内联指令照常应用（但请避免从心跳更改会话默认值）。
  • 心跳传递默认仅包含最终负载。若要同时发送单独的 Thinking 消息（如果可用），请设置 agents.defaults.heartbeat.includeReasoning: true 或针对每个代理的 agents.list[].heartbeat.includeReasoning: true。

Web 聊天界面

Section titled “Web 聊天界面”
  • Web 聊天思考选择器会在页面加载时，从传入的会话存储/配置中镜像反映会话存储的级别。
  • 选择另一个级别会通过 sessions.patch 立即写入会话覆盖；它不会等待下一次发送，也不是一次性的 thinkingOnce 覆盖。
  • 第一个选项始终是清除覆盖的选择。当会话继承非“关闭”的有效默认值时，它显示 Inherited: <resolved level>；当继承的思考被禁用时，它显示 Off。
  • 显式选择器选项被标记为覆盖，同时保留现有的提供商标签（例如，对于带有提供商标签的 max 选项，使用 Override: maximum）。
  • 选择器使用网关会话行/默认值返回的 thinkingLevels，并将 thinkingOptions 保留为遗留标签列表。浏览器 UI 不维护自己的提供商正则表达式列表；插件拥有特定于模型的级别集。
  • /think:<level> 仍然有效，并更新相同的存储会话级别，因此聊天指令和选择器保持同步。

提供商配置文件

Section titled “提供商配置文件”
  • 提供商插件可以公开 resolveThinkingProfile(ctx) 来定义模型支持的级别和默认值。
  • 代理 Claude 模型的提供商插件应该从 openclaw/plugin-sdk/provider-model-shared 复用 resolveClaudeThinkingProfile(modelId)，以便直接 Anthropic 和代理目录保持一致。
  • 每个配置文件级别都有一个存储的规范 id（off、minimal、low、medium、high、xhigh、adaptive 或 max），并且可能包含一个显示 label。二进制提供商使用 { id: "low", label: "on" }。
  • 需要验证显式思考覆盖的工具插件应该使用 api.runtime.agent.resolveThinkingPolicy({ provider, model }) 加上 api.runtime.agent.normalizeThinkingLevel(...)；它们不应该维护自己的提供商/模型级别列表。
  • 有权访问配置的自定义模型元数据的工具插件可以将 catalog 传递到 resolveThinkingPolicy 中，以便 compat.supportedReasoningEfforts 选择加入反映在插件端验证中。
  • 已发布的遗留钩子（supportsXHighThinking、isBinaryThinking 和 resolveDefaultThinkingLevel）仍然作为兼容性适配器存在，但新的自定义级别集应该使用 resolveThinkingProfile。
  • Gateway(网关) 行/默认值公开 Gateway(网关)thinkingLevels、thinkingOptions 和 thinkingDefault，以便 ACP/聊天客户端呈现与运行时验证相同的配置文件 ID 和标签。