Niveles de pensamiento

Lo que hace

• Directiva en línea en cualquier cuerpo entrante: /t <level>, /think:<level> o /thinking <level>.
• Niveles (alias): off | minimal | low | medium | high | xhigh | adaptive | max
  • mínimo → “think”
  • bajo → “think hard”
  • medio → “think harder”
  • alto → “ultrathink” (presupuesto máximo)
  • xhigh → “ultrathink+” (modelos GPT-5.2+ y Codex, además del esfuerzo de Anthropic Claude Opus 4.7+)
  • adaptive → pensamiento adaptativo gestionado por el proveedor (soportado para Claude 4.6 en Anthropic/Bedrock, Anthropic Claude Opus 4.7+ y pensamiento dinámico de Google Gemini)
  • max → razonamiento máximo del proveedor (Anthropic Claude Opus 4.7+; Ollama asigna esto a su mayor esfuerzo nativo think)
  • x-high, x_high, extra-high, extra high y extra_high se asignan a xhigh.
  • highest se asigna a high.
• Notas del proveedor:
  • Los menús y selectores de pensamiento se impulsan por el perfil del proveedor. Los complementos del proveedor declaran el conjunto exacto de niveles para el modelo seleccionado, incluidas etiquetas como binario on.
  • adaptive, xhigh y max solo se anuncian para perfiles de proveedor/modelo que los admiten. Las directivas escritas para niveles no admitidos se rechazan con las opciones válidas de ese modelo.
  • Los niveles no admitidos almacenados existentes se reasignan por rango de perfil de proveedor. adaptive recurre a medium en modelos no adaptables, mientras que xhigh y max recurren al nivel no apagado admitido más grande para el modelo seleccionado.
  • Los modelos Anthropic Claude 4.6 son adaptive de forma predeterminada cuando no se establece ningún nivel de pensamiento explícito.
  • Anthropic Claude Opus 4.8 y Opus 4.7 mantienen el pensamiento desactivado a menos que configure explícitamente un nivel de pensamiento. El valor predeterminado del esfuerzo propiedad del proveedor de Opus 4.8 es high después de habilitar el pensamiento adaptativo.
  • Anthropic Claude Opus 4.7+ asigna /think xhigh al pensamiento adaptativo más output_config.effort: "xhigh", porque /think es una directiva de pensamiento y xhigh es la configuración de esfuerzo de Opus.
  • Anthropic Claude Opus 4.7+ también expone /think max; se asigna a la misma ruta de esfuerzo máximo propiedad del proveedor.
  • Los modelos directos de DeepSeek V4 exponen /think xhigh|max; ambos se asignan a reasoning_effort: "max" de DeepSeek, mientras que los niveles no oficiales más bajos se asignan a high.
  • Los modelos DeepSeek V4 enrutados por OpenRouter exponen /think xhigh y envían valores reasoning_effort compatibles con OpenRouter. Las anulaciones max almacenadas recurren a xhigh.
  • Los modelos de Ollama con capacidad de pensamiento exponen /think low|medium|high|max; max se asigna a think: "high" nativo porque la API nativa de Ollama acepta cadenas de esfuerzo low, medium y high.
  • Los modelos OpenAI GPT asignan /think a través del soporte de esfuerzo de la API de Responses específico del modelo. /think off envía reasoning.effort: "none" solo cuando el modelo de destino lo admite; de lo contrario, OpenClaw omite la carga de razonamiento desactivada en lugar de enviar un valor no admitido.
  • Las entradas de catálogo personalizadas compatibles con OpenAI pueden optar por /think xhigh estableciendo models.providers.<provider>.models[].compat.supportedReasoningEfforts para incluir "xhigh". Esto utiliza los mismos metadatos de compatibilidad que mapean los payloads de esfuerzo de razonamiento de OpenAI salientes, por lo que los menús, la validación de sesión, la CLI del agente y llm-task concuerdan con el comportamiento del transporte.
  • Las referencias obsoletas configuradas de OpenRouter Hunter Alpha omiten la inyección de razonamiento proxy porque esa ruta retirada podría devolver el texto de respuesta final a través de campos de razonamiento.
  • Google Gemini mapea /think adaptive al pensamiento dinámico propio del proveedor de Gemini. Las solicitudes de Gemini 3 omiten un thinkingLevel fijo, mientras que las solicitudes de Gemini 2.5 envían thinkingBudget: -1; los niveles fijos aún se mapean al thinkingLevel o presupuesto más cercano de Gemini para esa familia de modelos.
  • MiniMax (minimax/*) en la ruta de transmisión compatible con Anthropic usa por defecto thinking: { type: "disabled" } a menos que establezcas explícitamente el pensamiento en los parámetros del modelo o de la solicitud. Esto evita deltas reasoning_content filtrados del formato de transmisión Anthropic no nativo de MiniMax.
  • Z.AI (zai/*) solo admite pensamiento binario (on/off). Cualquier nivel que no sea off se trata como on (mapeado a low).
  • Moonshot (moonshot/*) mapea /think off a thinking: { type: "disabled" } y cualquier nivel que no sea off a thinking: { type: "enabled" }. Cuando el pensamiento está habilitado, Moonshot solo acepta tool_choice auto|none; OpenClaw normaliza los valores incompatibles a auto.

Orden de resolución

1. Directiva en línea en el mensaje (se aplica solo a ese mensaje).
2. Anulación de sesión (establecida enviando un mensaje de solo directiva).
3. Predeterminado por agente (agents.list[].thinkingDefault en la configuración).
4. Predeterminado global (agents.defaults.thinkingDefault en la configuración).
5. Respaldo (fallback): predeterminado declarado por el proveedor cuando está disponible; de lo contrario, los modelos con capacidad de razonamiento se resuelven a medium o al nivel compatible no off más cercano para ese modelo, y los modelos sin capacidad de razonamiento se mantienen off.

Establecer un valor predeterminado de sesión

• Envía un mensaje que sea solo la directiva (se permiten espacios en blanco), por ejemplo, /think:medium o /t high.
• Esto se mantiene para la sesión actual (por remitente de forma predeterminada). Use /think default para borrar la anulación de sesión y heredar el valor predeterminado configurado/del proveedor; los alias incluyen inherit, clear, reset y unpin.
• /think off almacena una anulación explícita de desactivado. Desactiva el pensamiento hasta que cambie o borre la anulación de sesión.
• Se envía una respuesta de confirmación (Thinking level set to high. / Thinking disabled.). Si el nivel no es válido (por ejemplo, /thinking big), el comando se rechaza con una sugerencia y el estado de la sesión permanece sin cambios.
• Envíe /think (o /think:) sin argumentos para ver el nivel de pensamiento actual.

Aplicación por agente

• OpenClaw incrustado: el nivel resuelto se pasa al tiempo de ejecución del agente OpenClaw en proceso.
• Backend de Claude CLI: los niveles que no son “off” se pasan a Claude Code como --effort cuando se usa claude-cli; consulte CLI backends.

Modo rápido (/fast)

• Niveles: on|off|default.
• Un mensaje solo con directiva alterna una anulación de modo rápido de sesión y responde Fast mode enabled. / Fast mode disabled.. Use /fast default para borrar la anulación de sesión y heredar el valor predeterminado configurado; los alias incluyen inherit, clear, reset y unpin.
• Envíe /fast (o /fast status) sin modo para ver el estado efectivo actual del modo rápido.
• OpenClaw resuelve el modo rápido en este orden:
  1. Anulación /fast on|off en línea/solo directiva (/fast default borra esta capa)
  2. Anulación de sesión
  3. Valor predeterminado por agente (agents.list[].fastModeDefault)
  4. Configuración por modelo: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. Alternativa: off
• Para openai/*, el modo rápido se asigna al procesamiento con prioridad de OpenAI enviando service_tier=priority en las solicitudes de Responses compatibles.
• Para los modelos openai/* con respaldo de Codex, el modo rápido envía el mismo indicador service_tier=priority en las respuestas de Codex. OpenClaw mantiene un único interruptor /fast compartido en ambas rutas de autenticación.
• Para las solicitudes anthropic/* públicas directas, incluido el tráfico autenticado con OAuth enviado a api.anthropic.com, el modo rápido se asigna a los niveles de servicio de Anthropic: /fast on establece service_tier=auto, /fast off establece service_tier=standard_only.
• Para minimax/* en la ruta compatible con Anthropic, /fast on (o params.fastMode: true) reescribe MiniMax-M2.7 a MiniMax-M2.7-highspeed.
• Los parámetros de modelo serviceTier / service_tier explícitos de Anthropic anulan el valor predeterminado del modo rápido cuando ambos están establecidos. OpenClaw aún omite la inyección de nivel de servicio de Anthropic para URLs base de proxy que no son de Anthropic.
• /status muestra Fast solo cuando el modo rápido está activado.

Directivas detalladas (/verbose o /v)

• Niveles: on (mínimo) | full | off (predeterminado).
• Un mensaje que contiene solo la directiva alterna el modo detallado (verbose) de la sesión y responde Verbose logging enabled. / Verbose logging disabled.; los niveles no válidos devuelven una sugerencia sin cambiar el estado.
• /verbose off almacena una anulación explícita de la sesión; bórrela a través de la interfaz de usuario de Sesiones eligiendo inherit.
• Los remitentes autorizados de canales externos pueden conservar la anulación del modo detallado de la sesión. Los clientes internos de puerta de enlace (gateway) o chat web necesitan operator.admin para conservarla.
• La directiva en línea afecta solo ese mensaje; de lo contrario, se aplican los valores predeterminados de sesión/global.
• Envíe /verbose (o /verbose:) sin argumentos para ver el nivel detallado actual.
• Cuando el modo detallado está activado, los agentes que emiten resultados de herramientas estructurados envían cada llamada de herramienta de vuelta como su propio mensaje de solo metadatos, prefijado con <emoji> <tool-name>: <arg> cuando está disponible. Estos resúmenes de herramientas se envían tan pronto como cada herramienta comienza (burbujas separadas), no como deltas de transmisión continua.
• Los resúmenes de fallos de herramientas permanecen visibles en modo normal, pero los sufijos de detalles de errores sin procesar están ocultos a menos que verbose sea full.
• Cuando verbose es full, las salidas de las herramientas también se reenvían después de completarse (burbuja separada, truncada a una longitud segura). Si alternas /verbose on|full|off mientras una ejecución está en curso, las burbujas de herramientas subsiguientes respetan la nueva configuración.
• agents.defaults.toolProgressDetail controla la forma de los resúmenes de herramientas /verbose y las líneas de herramientas de borradores de progreso. Usa "explain" (predeterminado) para etiquetas humanas compactas como 🛠️ Exec: checking JS syntax; usa "raw" cuando también quieras que se añada el comando/detalle sin procesar para depuración. agents.list[].toolProgressDetail por agente anula el valor predeterminado.
  • explain: 🛠️ Exec: check JS syntax for /tmp/app.js
  • raw: 🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js

Directivas de traza de complementos (/trace)

• Niveles: on | off (predeterminado).
• El mensaje de solo directiva alterna la salida de traza del complemento de sesión y responde Plugin trace enabled. / Plugin trace disabled..
• La directiva en línea afecta solo ese mensaje; de lo contrario, se aplican los valores predeterminados de sesión/globales.
• Envía /trace (o /trace:) sin argumentos para ver el nivel de traza actual.
• /trace es más limitado que /verbose: solo expone líneas de traza/depuración propiedad del complemento, como los resúmenes de depuración de Active Memory.
• Las líneas de traza pueden aparecer en /status y como un mensaje de diagnóstico de seguimiento después de la respuesta normal del asistente.

Visibilidad del razonamiento (/reasoning)

• Niveles: on|off|stream.
• El mensaje de solo directiva alterna si se muestran los bloques de pensamiento en las respuestas.
• Cuando está habilitado, el razonamiento se envía como un mensaje separado prefijado con Thinking.
• stream: transmite el razonamiento mientras se genera la respuesta cuando el canal activo admite vistas previas de razonamiento, luego envía la respuesta final sin razonamiento.
• Alias: /reason.
• Envíe /reasoning (o /reasoning:) sin argumentos para ver el nivel de razonamiento actual.
• Orden de resolución: directiva en línea, luego anulación de sesión, luego predeterminado por agente (agents.list[].reasoningDefault), luego predeterminado global (agents.defaults.reasoningDefault), luego respaldo (off).

Las etiquetas de razonamiento de modelo local malformadas se manejan de forma conservadora. Los bloques <think>...</think> cerrados permanecen ocultos en las respuestas normales, y el razonamiento no cerrado después del texto ya visible también se oculta. Si una respuesta está completamente envuelta en una sola etiqueta de apertura no cerrada y de otro modo se entregaría como texto vacío, OpenClaw elimina la etiqueta de apertura malformada y entrega el texto restante.

Relacionado

• La documentación del modo elevado se encuentra en Elevated mode.

Latidos

• El cuerpo de la sonda de latido es el mensaje de latido configurado (predeterminado: 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.). Las directivas en línea en un mensaje de latido se aplican de forma habitual (pero evite cambiar los valores predeterminados de la sesión desde los latidos).
• La entrega de latidos se predetermina solo a la carga útil final. Para también enviar el mensaje Thinking separado (cuando esté disponible), establezca agents.defaults.heartbeat.includeReasoning: true o por agente agents.list[].heartbeat.includeReasoning: true.

Interfaz de usuario de chat web

• El selector de pensamiento del chat web refleja el nivel almacenado de la sesión desde el almacén/configuración de la sesión entrante cuando se carga la página.
• Al elegir otro nivel, se escribe la anulación de sesión inmediatamente a través de sessions.patch; no espera al siguiente envío y no es una anulación thinkingOnce de un solo uso.
• La primera opción es siempre la elección de borrar anulación. Muestra Inherited: <resolved level>, incluyendo Inherited: Off cuando el pensamiento heredado está deshabilitado.
• Las elecciones explícitas del selector usan sus etiquetas de nivel directo mientras preservan las etiquetas del proveedor cuando están presentes (por ejemplo Maximum para una opción max con etiqueta de proveedor).
• El selector utiliza thinkingLevels devuelto por la fila/valores predeterminados de la sesión de la puerta de enlace, con thinkingOptions mantenida como una lista de etiquetas heredada. La interfaz de usuario del navegador no mantiene su propia lista de expresiones regulares de proveedores; los complementos poseen conjuntos de niveles específicos del modelo.
• /think:<level> todavía funciona y actualiza el mismo nivel de sesión almacenado, por lo que las directivas del chat y el selector se mantienen sincronizados.

Perfiles de proveedor

• Los complementos de proveedor pueden exponer resolveThinkingProfile(ctx) para definir los niveles admitidos y el predeterminado del modelo.
• Los complementos de proveedor que actúan como proxy para modelos Claude deben reutilizar resolveClaudeThinkingProfile(modelId) de openclaw/plugin-sdk/provider-model-shared para que los catálogos directos de Anthropic y los de proxy se mantengan alineados.
• Cada nivel de perfil tiene un id canónico almacenado (off, minimal, low, medium, high, xhigh, adaptive o max) y puede incluir un label de visualización. Los proveedores binarios utilizan { id: "low", label: "on" }.
• Los ganchos de perfil reciben datos combinados del catálogo cuando están disponibles, incluidos reasoning, compat.thinkingFormat y compat.supportedReasoningEfforts. Utilice esos datos para exponer perfiles binarios o personalizados solo cuando el contrato de solicitud configurado admita la carga útil coincidente.
• Los complementos de herramientas que necesiten validar una anulación explícita del pensamiento deben usar api.runtime.agent.resolveThinkingPolicy({ provider, model }) más api.runtime.agent.normalizeThinkingLevel(...); no deben mantener sus propias listas de niveles de proveedor/modelo.
• Los complementos de herramientas con acceso a los metadatos de modelos personalizados configurados pueden pasar catalog a resolveThinkingPolicy para que las aceptaciones compat.supportedReasoningEfforts se reflejen en la validación del lado del complemento.
• Los ganchos heredados publicados (supportsXHighThinking, isBinaryThinking y resolveDefaultThinkingLevel) permanecen como adaptadores de compatibilidad, pero los nuevos conjuntos de niveles personalizados deben usar resolveThinkingProfile.
• Las filas/valores predeterminados de la puerta de enlace exponen thinkingLevels, thinkingOptions y thinkingDefault para que los clientes de ACP/chat muestren los mismos identificadores y etiquetas de perfil que utiliza la validación en tiempo de ejecución.