思考层级
思考层级让你可以控制智能体的推理深度——从快速响应到深度思考，灵活适配不同任务需求。
功能说明
你可以在任何入站消息中使用内联指令来调整思考深度：
/t <level>、/think:<level>或/thinking <level>
可用层级
| 层级 | 别名 | 说明 |
|---|---|---|
off | - | 关闭思考 |
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 模型：未显式设置思考层级时，默认使用
adaptive。 - Z.AI (
zai/*)：仅支持开关式思考（on/off）。任何非off的层级都被视为on（映射到low）。 - Moonshot (
moonshot/*)：将/think off映射到thinking: { type: "disabled" }，其他层级映射到thinking: { type: "enabled" }。思考启用时，Moonshot 只接受tool_choice为auto或none；OpenClaw 会将不兼容的值规范化为auto。
解析顺序
思考层级的生效优先级如下：
- 消息内联指令——仅对该条消息生效
- 会话覆盖——通过发送纯指令消息设置
- 全局默认值——配置中的
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: 即可。
按智能体应用
- 嵌入式 Pi：解析后的层级会传递给进程内的 Pi 智能体运行时。
详细日志指令 (/verbose 或 /v)
想在对话中看到更多工具执行细节？使用详细日志指令。
层级
on（最小详细）full（完整详细）off（默认关闭）
用法
发送一条仅包含指令的消息，即可切换会话的详细日志状态。系统会回复 "Verbose logging enabled." 或 "Verbose logging disabled."。层级无效时会返回提示，状态不变。
/verbose off会存储一个显式的会话覆盖；可通过会话 UI 选择inherit来清除。- 内联指令仅影响当前消息；其他情况使用会话或全局默认值。
- 发送不带参数的
/verbose或/verbose:可查看当前详细日志级别。
详细日志开启时的行为
当详细日志开启时，发出结构化工具结果的智能体（如 Pi 和其他 JSON 智能体）会将每个工具调用作为单独的元数据消息发送，格式为 <emoji> <tool-name>: <arg>（路径或命令可用时）。这些工具摘要会在每个工具启动时立即发送（单独的对话气泡），而不是作为流式增量发送。
工具失败摘要在正常模式下仍然可见，但原始错误详情后缀会被隐藏——除非详细日志级别为 on 或 full。
当详细日志级别为 full 时，工具输出也会在完成后转发（单独的对话气泡，截断到安全长度）。如果在智能体运行过程中切换 /verbose on|full|off，后续的工具气泡会遵循新设置。
推理可见性 (/reasoning)
想在回复中看到智能体的推理过程？使用推理可见性指令。
层级
on：显示推理off：隐藏推理stream：流式推理（仅限 Telegram）
用法
发送仅包含指令的消息可切换是否在回复中显示思考区块。启用后，推理会作为单独的消息发送，前缀为 "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（全局）agents.list[].heartbeat.includeReasoning: true（按智能体）
网页聊天界面
网页聊天的思考选择器在页面加载时会显示会话存储/配置中的层级。
选择另一个层级仅对下一条消息生效（thinkingOnce）；发送后，选择器会跳回存储的会话层级。
要更改会话默认值，请发送 /think:<level> 指令，选择器会在下次重新加载后反映新设置。