Skip to main content

​
它的作用

  • 任意传入正文中的内联指令：/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 后端。

​
快速模式（/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。
  • 对于直接的公开 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 快速模式。

​
详细日志指令（/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 会移除格式错误的起始标签并交付剩余文本。

​
相关

​
心跳

  • 心跳探测正文是已配置的心跳提示词（默认值：在提供心跳监控暂存上下文时，遵循该上下文。重复性任务属于自动化任务；请使用自动化工具创建或更改其计划，而不是使用心跳暂存。不要从之前的聊天中推断或重复旧任务。如果没有需要处理的事项，请回复 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。