Skip to content

思考级别(/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 模型在未显式设置思考级别时默认使用 adaptive
    • Z.AI(zai/*)仅支持二进制思考(on/off)。任何非 off 级别均视为 on(映射到 low)。
    • Moonshot(moonshot/*)将 /think off 映射到 thinking: { type: "disabled" },任何非 off 级别映射到 thinking: { type: "enabled" }。思考启用时,Moonshot 仅接受 tool_choice auto|none;OpenClaw 会将不兼容的值规范化为 auto

解析顺序

  1. 消息上的内联指令(仅适用于该消息)。
  2. 会话覆盖(通过发送仅含指令的消息设置)。
  3. 每代理默认值(配置中的 agents.list[].thinkingDefault)。
  4. 全局默认值(配置中的 agents.defaults.thinkingDefault)。
  5. 回退:Anthropic Claude 4.6 模型为 adaptive,其他支持推理的模型为 low,否则为 off

设置会话默认值

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

按代理应用

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

快速模式(/fast)

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

详细模式指令(/verbose 或 /v)

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

推理可见性(/reasoning)

  • 级别:on|off|stream
  • 仅含指令的消息切换是否在回复中显示思考块。
  • 启用时,推理作为独立消息发送,前缀为 Reasoning:
  • stream(仅限 Telegram):在回复生成过程中将推理流入 Telegram 草稿气泡,然后发送不含推理的最终答案。
  • 别名:/reason
  • 发送 /reasoning(或 /reasoning:)不带参数可查看当前推理级别。
  • 解析顺序:内联指令,然后是会话覆盖,然后是每代理默认值(agents.list[].reasoningDefault),最后是回退(off)。

相关链接

心跳

  • 心跳探测正文是已配置的心跳提示词(默认: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 或每代理 agents.list[].heartbeat.includeReasoning: true

Web 聊天 UI

  • Web 聊天思考选择器在页面加载时从入站会话存储/配置中镜像会话的存储级别。
  • 选择另一个级别仅适用于下一条消息(thinkingOnce);发送后,选择器恢复到存储的会话级别。
  • 若要更改会话默认值,发送 /think:<level> 指令(如前);下次重载后选择器将反映该设置。