Configura niveles de razonamiento en OpenClaw

¿Alguna vez has sentido que tu modelo de IA se queda corto en lógica o que gasta demasiados tokens en razonamientos simples cuando no es necesario? Controlar cómo piensa tu agente es clave para obtener mejores resultados y optimizar el consumo de recursos en tus proyectos.

Aquí tienes una guía directa para dominar las directivas de pensamiento y otros comandos esenciales.

Qué hace

• Directiva inline en cualquier cuerpo de mensaje entrante: /t <level>, /think:<level>, o /thinking <level>.
• Niveles (alias): off | minimal | low | medium | high | xhigh | adaptive
  • minimal → “think”
  • low → “think hard”
  • medium → “think harder”
  • high → “ultrathink” (presupuesto máximo)
  • xhigh → “ultrathink+” (solo modelos GPT-5.2 + Codex)
  • adaptive → presupuesto de razonamiento adaptativo gestionado por el proveedor (soportado para la familia de modelos Anthropic Claude 4.6)
  • x-high, x_high, extra-high, extra high, y extra_high se mapean a xhigh.
  • highest, max se mapean a high.
• Notas del proveedor:
  • Los modelos Anthropic Claude 4.6 usan adaptive por defecto cuando no se establece un nivel de pensamiento explícito.
  • Z.AI (zai/*) solo soporta 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 inline en el mensaje (se aplica solo a ese mensaje).
2. Override de sesión (se establece enviando un mensaje que solo contenga la directiva).
3. Valor predeterminado por agente (agents.list[].thinkingDefault en la configuración).
4. Valor predeterminado global (agents.defaults.thinkingDefault en la configuración).
5. Fallback: adaptive para modelos Anthropic Claude 4.6, low para otros modelos con capacidad de razonamiento, off en los demás casos.

Configurar un valor predeterminado de sesión

• Envía un mensaje que sea solo la directiva (se permite espacio en blanco), por ejemplo: /think:medium o /t high.
• Esto se mantiene para la sesión actual (por remitente de forma predeterminada); se borra con /think:off o por reinicio de sesión inactiva.
• Se envía una respuesta de confirmación (Thinking level set to high. / Thinking disabled.). Si el nivel no es válido (ej. /thinking big), el comando se rechaza con una sugerencia y el estado de la sesión no cambia.
• Envía /think (o /think:) sin argumentos para ver el nivel de pensamiento actual.

Aplicación por agente

• Embedded Pi: el nivel resuelto se pasa al runtime del agente Pi en el proceso.

Modo rápido (/fast)

• Niveles: on|off.
• Un mensaje que solo contenga la directiva alterna un override de modo rápido para la sesión y responde Fast mode enabled. / Fast mode disabled..
• Envía /fast (o /fast status) sin modo para ver el estado actual efectivo del modo rápido.
• OpenClaw resuelve el modo rápido en este orden:
  1. /fast on|off inline o como mensaje único
  2. Override de sesión
  3. Valor predeterminado por agente (agents.list[].fastModeDefault)
  4. Configuración por modelo: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. Fallback: off
• Para openai/*, el modo rápido se mapea al procesamiento prioritario de OpenAI enviando service_tier=priority en las solicitudes de Responses compatibles.
• Para openai-codex/*, el modo rápido envía el mismo flag service_tier=priority en Codex Responses. OpenClaw mantiene un interruptor /fast compartido entre ambas rutas de autenticación.
• Para solicitudes públicas directas de anthropic/*, incluyendo tráfico con autenticación OAuth enviado a api.anthropic.com, el modo rápido se mapea a los niveles de servicio de Anthropic: /fast on establece service_tier=auto, /fast off establece service_tier=standard_only.
• Los parámetros de modelo explícitos serviceTier / service_tier de Anthropic anulan el valor predeterminado del modo rápido cuando ambos están configurados. OpenClaw omite la inyección del nivel de servicio de Anthropic para URLs base de proxy que no sean de Anthropic.

Directivas de verbosidad (/verbose o /v)

• Niveles: on (mínimo) | full | off (por defecto).
• Un mensaje que solo contenga la directiva alterna la verbosidad de la sesión y responde Verbose logging enabled. / Verbose logging disabled.; los niveles inválidos devuelven una sugerencia sin cambiar el estado.
• /verbose off almacena un override de sesión explícito; puedes borrarlo mediante la UI de Sessions eligiendo inherit.
• La directiva inline afecta solo a ese mensaje; de lo contrario, se aplican los valores predeterminados de sesión o globales.
• Envía /verbose (o /verbose:) sin argumentos para ver el nivel de verbosidad actual.
• Cuando la verbosidad está activada, los agentes que emiten resultados de herramientas estructurados (Pi, otros agentes JSON) envían cada llamada a la herramienta como su propio mensaje de solo metadatos, con el prefijo <emoji> <tool-name>: <arg> cuando está disponible (path/command). Estos resúmenes de herramientas se envían en cuanto comienza cada herramienta (burbujas separadas), no como deltas de streaming.
• Los resúmenes de fallos de herramientas permanecen visibles en modo normal, pero los sufijos con detalles de errores en bruto se ocultan a menos que la verbosidad sea on o full.
• Cuando la verbosidad es full, los outputs de las herramientas también se reenvían después de completarse (burbuja separada, truncada a una longitud segura). Si cambias entre /verbose on|full|off mientras una ejecución está en curso, las burbujas de herramientas posteriores respetarán el nuevo ajuste.

Visibilidad del razonamiento (/reasoning)

• Niveles: on|off|stream.
• El mensaje de solo directiva alterna si los bloques de pensamiento se muestran en las respuestas.
• Cuando está habilitado, el razonamiento se envía como un mensaje separado con el prefijo Reasoning:.
• stream (solo Telegram): transmite el razonamiento en la burbuja de borrador de Telegram mientras se genera la respuesta, luego envía la respuesta final sin el razonamiento.
• Alias: /reason.
• Envía /reasoning (o /reasoning:) sin argumentos para ver el nivel de razonamiento actual.
• Orden de resolución: directiva inline, luego override de sesión, luego valor predeterminado por agente (agents.list[].reasoningDefault), luego fallback (off).

Relacionado

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

Heartbeats

• El cuerpo de la sonda de heartbeat es el prompt de heartbeat configurado (por defecto: 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 inline en un mensaje de heartbeat se aplican como de costumbre (pero evita cambiar los valores predeterminados de la sesión desde los heartbeats).
• La entrega del heartbeat por defecto es solo el payload final. Para enviar también el mensaje separado Reasoning: (cuando esté disponible), establece agents.defaults.heartbeat.includeReasoning: true o por agente agents.list[].heartbeat.includeReasoning: true.

Interfaz 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.
• Elegir otro nivel se aplica solo al siguiente mensaje (thinkingOnce); después de enviar, el selector vuelve al nivel de sesión almacenado.
• Para cambiar el valor predeterminado de la sesión, envía una directiva /think:<level> (como se explicó antes); el selector lo reflejará tras la siguiente recarga.

Siguientes pasos

• Explora cómo configurar tus propios Agentes
• Aprende más sobre el Modo Elevado

AI Setup Assistant