Thinking 级别(/think 指令)

功能说明

  • 任意入站消息中的内联指令:/t <level>/think:<level>/thinking <level>
  • 级别(别名):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-highx_highextra-highextra highextra_high 映射到 xhigh
    • highestmax 映射到 high
  • 提供商注意事项:
    • Anthropic Claude 4.6 模型在未明确设置 thinking 级别时默认为 adaptive
    • Z.AI(zai/*)仅支持二元 thinking(on/off)。任何非 off 级别都视为 on(映射到 low)。
    • Moonshot(moonshot/*)将 /think off 映射为 thinking: { type: "disabled" },任何非 off 级别映射为 thinking: { type: "enabled" }。启用 thinking 时,Moonshot 仅接受 tool_choiceauto|none;OpenClaw 会将不兼容的值标准化为 auto

解析顺序

  1. 消息上的内联指令(仅影响该条消息)。
  2. 会话覆盖(通过发送纯指令消息设置)。
  3. 全局默认(配置中的 agents.defaults.thinkingDefault)。
  4. 回退:Anthropic Claude 4.6 模型为 adaptive,其他支持推理的模型为 low,其余为 off

设置会话默认值

  • 发送仅包含指令的消息(允许空白),例如 /think:medium/t high
  • 对当前会话生效(默认按发送者隔离);通过 /think:off 或会话空闲重置清除。
  • 发送确认回复(Thinking level set to high. / Thinking disabled.)。如果级别无效(如 /thinking big),命令会被拒绝并给出提示,会话状态不变。
  • 发送 /think(或 /think:)不带参数可查看当前 thinking 级别。

按 Agent 应用

  • 内嵌 Pi:解析后的级别传递给进程内 Pi Agent 运行时。

快速模式(/fast)

  • 级别:on|off
  • 纯指令消息切换会话 fast-mode 覆盖并回复 Fast mode enabled. / Fast mode disabled.
  • 发送 /fast(或 /fast status)不带模式可查看当前生效的 fast-mode 状态。
  • OpenClaw 按以下顺序解析 fast mode:
    1. 内联/纯指令 /fast on|off
    2. 会话覆盖
    3. 按模型配置:agents.defaults.models["<provider>/<model>"].params.fastMode
    4. 回退:off
  • openai/*,fast mode 应用 OpenAI 快速配置:支持时使用 service_tier=priority,加上低推理强度和低文本详细度。
  • openai-codex/*,fast mode 对 Codex Responses 应用相同的低延迟配置。OpenClaw 在两种认证路径间保持一个共享的 /fast 开关。
  • 对直接 anthropic/* API key 请求,fast mode 映射到 Anthropic 服务层级:/fast onservice_tier=auto/fast offservice_tier=standard_only
  • Anthropic fast mode 仅限 API key。OpenClaw 对 Claude setup-token / OAuth 认证和非 Anthropic 代理 base URL 跳过 Anthropic 服务层级注入。

Verbose 指令(/verbose 或 /v)

  • 级别:on(最小)| full | off(默认)。
  • 纯指令消息切换会话 verbose 并回复 Verbose logging enabled. / Verbose logging disabled.;无效级别返回提示但不改变状态。
  • /verbose off 存储显式的会话覆盖;通过 Sessions UI 选择 inherit 可清除。
  • 内联指令仅影响该条消息;否则使用会话/全局默认值。
  • 发送 /verbose(或 /verbose:)不带参数可查看当前 verbose 级别。
  • verbose 开启时,发出结构化工具结果的 Agent(Pi 等 JSON Agent)会将每个工具调用作为独立的元数据消息发回,可用时前缀为 <emoji> <tool-name>: <arg>(路径/命令)。这些工具摘要在每个工具启动时发送(独立气泡),不是流式增量。
  • 工具失败摘要在正常模式下仍然可见,但原始错误详情后缀只在 verbose 为 onfull 时包含。
  • verbose 为 full 时,工具输出也会在完成后转发(独立气泡,截断到安全长度)。如果在运行中切换 /verbose on|full|off,后续工具气泡遵循新设置。

推理可见性(/reasoning)

  • 级别:on|off|stream
  • 纯指令消息切换是否在回复中显示 thinking 块。
  • 启用时,推理以前缀为 Reasoning:单独消息发送。
  • stream(仅 Telegram):在回复生成时将推理流式传输到 Telegram 草稿气泡,然后发送不带推理的最终答案。
  • 别名:/reason
  • 发送 /reasoning(或 /reasoning:)不带参数可查看当前推理级别。

相关

心跳

  • 心跳探测正文是配置的心跳提示(默认: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.)。心跳消息中的内联指令照常应用(但避免从心跳中修改会话默认值)。
  • 心跳投递默认只包含最终载荷。要同时发送单独的 Reasoning: 消息(如果有),设置 agents.defaults.heartbeat.includeReasoning: true 或按 Agent 的 agents.list[].heartbeat.includeReasoning: true

Web 聊天 UI

  • Web 聊天的 thinking 选择器在页面加载时映射入站会话存储/配置中的会话存储级别。
  • 选择另一个级别仅对下一条消息生效(thinkingOnce);发送后选择器回弹到存储的会话级别。
  • 要修改会话默认值,发送 /think:<level> 指令(同以前一样);选择器在下次重新加载后反映变化。