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-high、x_high、extra-high、extra high和extra_high映射到xhigh。highest、max映射到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_choice为auto|none;OpenClaw 会将不兼容的值标准化为auto。
- Anthropic Claude 4.6 模型在未明确设置 thinking 级别时默认为
解析顺序
- 消息上的内联指令(仅影响该条消息)。
- 会话覆盖(通过发送纯指令消息设置)。
- 全局默认(配置中的
agents.defaults.thinkingDefault)。 - 回退: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:
- 内联/纯指令
/fast on|off - 会话覆盖
- 按模型配置:
agents.defaults.models["<provider>/<model>"].params.fastMode - 回退:
off
- 内联/纯指令
- 对
openai/*,fast mode 应用 OpenAI 快速配置:支持时使用service_tier=priority,加上低推理强度和低文本详细度。 - 对
openai-codex/*,fast mode 对 Codex Responses 应用相同的低延迟配置。OpenClaw 在两种认证路径间保持一个共享的/fast开关。 - 对直接
anthropic/*API key 请求,fast mode 映射到 Anthropic 服务层级:/fast on设service_tier=auto,/fast off设service_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 为
on或full时包含。 - verbose 为
full时,工具输出也会在完成后转发(独立气泡,截断到安全长度)。如果在运行中切换/verbose on|full|off,后续工具气泡遵循新设置。
推理可见性(/reasoning)
- 级别:
on|off|stream。 - 纯指令消息切换是否在回复中显示 thinking 块。
- 启用时,推理以前缀为
Reasoning:的单独消息发送。 stream(仅 Telegram):在回复生成时将推理流式传输到 Telegram 草稿气泡,然后发送不带推理的最终答案。- 别名:
/reason。 - 发送
/reasoning(或/reasoning:)不带参数可查看当前推理级别。
相关
- Elevated 模式文档在 Elevated 模式。
心跳
- 心跳探测正文是配置的心跳提示(默认:
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>指令(同以前一样);选择器在下次重新加载后反映变化。