Appearance
思考级别(/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 模型在未显式设置思考级别时默认使用
adaptive。 - Z.AI(
zai/*)仅支持二进制思考(on/off)。任何非off级别均视为on(映射到low)。 - Moonshot(
moonshot/*)将/think off映射到thinking: { type: "disabled" },任何非off级别映射到thinking: { type: "enabled" }。思考启用时,Moonshot 仅接受tool_choiceauto|none;OpenClaw 会将不兼容的值规范化为auto。
- Anthropic Claude 4.6 模型在未显式设置思考级别时默认使用
解析顺序
- 消息上的内联指令(仅适用于该消息)。
- 会话覆盖(通过发送仅含指令的消息设置)。
- 每代理默认值(配置中的
agents.list[].thinkingDefault)。 - 全局默认值(配置中的
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 代理运行时。
快速模式(/fast)
- 级别:
on|off。 - 仅含指令的消息切换会话快速模式覆盖,并回复
Fast mode enabled./Fast mode disabled.。 - 发送
/fast(或/fast status)不带模式可查看当前有效的快速模式状态。 - OpenClaw 按以下顺序解析快速模式:
- 内联/仅指令的
/fast on|off - 会话覆盖
- 每代理默认值(
agents.list[].fastModeDefault) - 每模型配置:
agents.defaults.models["<provider>/<model>"].params.fastMode - 回退:
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>(路径/命令)。这些工具摘要在每个工具启动时立即发送(独立气泡),而非流式增量。 - 工具失败摘要在普通模式下仍可见,但除非详细模式为
on或full,否则原始错误详情后缀会被隐藏。 - 当详细模式为
full时,工具输出在完成后也会被转发(独立气泡,截断至安全长度)。若在运行过程中切换/verbose on|full|off,后续工具气泡遵循新设置。
推理可见性(/reasoning)
- 级别:
on|off|stream。 - 仅含指令的消息切换是否在回复中显示思考块。
- 启用时,推理作为独立消息发送,前缀为
Reasoning:。 stream(仅限 Telegram):在回复生成过程中将推理流入 Telegram 草稿气泡,然后发送不含推理的最终答案。- 别名:
/reason。 - 发送
/reasoning(或/reasoning:)不带参数可查看当前推理级别。 - 解析顺序:内联指令,然后是会话覆盖,然后是每代理默认值(
agents.list[].reasoningDefault),最后是回退(off)。
相关链接
- 提升模式文档见 提升模式(Elevated mode)。
心跳
- 心跳探测正文是已配置的心跳提示词(默认:
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>指令(如前);下次重载后选择器将反映该设置。